Planned maintenance

Sunday 25th of October 10 AM PDT we're doing some backend infrastructure changes that will improve the system overall.

We anticipate 30-60 minutes of downtime.

UPDATE: no downtime was required.

The Future of Factory Workers - Fair Observer

New Layout & UI

Our largest UI change to date is here!

Here are the details:

Three-column layout -> Two-column layout

The three-column layout was problematic:

  • for teams with a medium to high number of docspaces it was cognitively overloading;
  • for teams with a low number of docspaces, the first column was mostly empty;
  • the colors made it look like the important thing was the first column, when in fact the organization of documents is secondary or even tertiary in importance;
  • it moved the editor too far right on the screen, making it hard for people to focus on it when writing;
  • it was hard to get right on smaller screens, even on 1366px; not enough screen real estate on most screens out there;
  • it was too different from most other systems out there, so people didn't immediately recognize the pattern, introducing friction;

So we decided to combine the first 2 columns into 1, and pick different colors.

UI Improvements across the app

We made a huge number of small adjustments to colors, spacings, and the blocks are more tightly integrated. The cleanest design in Archbee to this date!

Of course, we couldn't resist and improve more than 20 interactions, as UX is the most important an app like ours can offer :)

Docspaces -> Collections

The concept of docspaces (document organization) was also alien to most people, and it was easy to confuse it with workspaces (company/people organization), so we decided to rename it to "Collections".

Favorite Collections

Lastly, we introduced the concept of Favorite Collections, as most people only interacted with 3-4 docspaces and they had to scroll and visually search for what they needed. Even if you could drag and drop to organize them to your needs, the overload was still there.

What are we working on next? (subject to change)

  • API docs template similar to Stripe and Readme with the API docs and example side by side;
  • Google Drive, Asana, JIRA, GitHub, Zapier: all authenticated integrations;
  • Dark Mode;

Get in there, play with it and let us know in the chatbox how you feel about this important change in the app!

App goes to

We moved our website to new technology, so now our app now lives at

All existing links will automatically redirect to the new URL.

This is a breaking change for the native apps, which will not work until you upgrade to the latest version (should be automatic, prompting you to reload the app to apply the new version).

We don't predict any downtime, but if there is, please go use the new for the app which should work without any change after logging in.


Inline document comments!

In the beginning of the year, we had an idea that realtime chat on documents would be a big deal. We launched it, but it didn't take off. We couldn't get users to actually use it.

Many users and customers told us they were missing traditional comments. We got proven wrong, so we built inline comments!

How to use? Select any text and add a comment.

What's next?

We're keeping focus on our core technology, and a UX redesign is coming for the left side of the app. Stay tuned!

Emojis everywhere

You can now set emojis as docspace icons.

You can also set emojis as docs icons.

But also in the doc editor by hitting Cmd (or Ctrl on Windows) + ^

Or shortcuts in the editor also convert.


Native Apps Are HERE!

macOS, Windows and Linux apps are here.

They auto-update. 

They're fast and are tuned out to not eat any more memory than the regular in-browser app.

They get you notifications right in front:

To download, go to the landing page and you'll see the download buttons, or download directly.

Try it out, we're confident we deserve a spot in your taskbar :)

As always, keep the feedback coming!

Improved table of contents

We've heard the feedback, table of contents needed much improvement, both on the internal side but also for external docs or docspaces.

We've built a better UI for all of it, starting from the editing experience, ending with your customer's docs delight.

Here's how it looks like on the internal side.

And the external shared side.

The same improved TOCs are available on individually shared docs and our blog, which is powered by Archbee's editor, check it out:

Native Mermaid Diagrams

Not all people like to draw stuff. Some people like software developers want to write stuff.

This is why we now have native support for Mermaid, a markdown flavored syntax for building diagrams.

Mermaid diagrams are an easy way build: flowchart, sequence, class, UML, gantt and entity relationship diagrams.

Here's a short gif showing you how it's done.

You can find the full documentation of Mermaid, the markdown flavored syntax here:

Doc categories

Our doctrees allow you to build any hierarchy you might want.

But sometimes you want to have parent docs without needing to write anything inside. No more "In here is this, this and that."

This is why we built doc categories. Here's how they look:

Here's how they look like when you share the spaces externally, on our own documentation:

Now you're set to go kill the docs game!

Show Previous EntriesShow Previous Entries