Skip to main content

​
Get up and running

This guide will take you from zero to your first workspace with pages, databases, and collaboration in just a few minutes.
New to Brainbox? Try the online demo first, or follow this guide to install locally.

​
Step 1: Choose your platform

The fastest way to get started:
1

Visit brainbox.sh

Open brainbox.sh in a modern browser (Chrome, Edge, or Firefox)
Safari and mobile browsers are not currently supported due to OPFS requirements.
2

Create an account

Click Sign up and create your account with email or Google
3

Verify your email

Check your inbox and click the verification link (or use automatic verification if enabled)

​
Step 2: Create your first workspace

Workspaces are containers for all your content—pages, databases, files, and chat channels.
1

Click 'New workspace'

After signing in, click the + New workspace button in the sidebar
2

Name your workspace

Give it a descriptive name like “Personal” or “Team Docs”
3

Choose an icon (optional)

Select an emoji or upload a custom icon to personalize your workspace

​
Step 3: Add your first page

Pages are the foundation of Brainbox—they support rich text, blocks, and nested content.
1

Create a new page

In your workspace, click + New page or press Cmd/Ctrl + N
2

Add a title

Click the title area and type your page name
3

Start writing

Click in the editor and start typing. Try these commands:
  • Type / to see the block menu
  • # Heading for headings
  • - List item for bullet lists
  • [ ] Task for checkboxes
4

Add nested pages

Hover over a page in the sidebar and click + to create a sub-page
Pages auto-save as you type—no need to manually save!

​
Step 4: Create a database

Databases let you organize structured data with custom fields and multiple views.
1

Create a database

Click + New → Database or type /database in a page
2

Name your database

Give it a name like “Tasks” or “Projects”
3

Add custom fields

Click + Add field to create columns:
  • Text: Names, descriptions, URLs
  • Number: Quantities, prices, scores
  • Select: Categories, statuses, priorities
  • Date: Deadlines, due dates
  • Checkbox: Completed, active flags
4

Add records

Click + New record to add rows to your database
5

Switch views

Click the view dropdown to toggle between:
  • Table: Spreadsheet-style grid
  • Kanban: Card-based board grouped by select field
  • Calendar: Timeline view for date fields

​
Step 5: Collaborate with your team

Invite others to collaborate on your workspace with granular permissions.
1

Invite members

Click Settings → Members → InviteEnter their email address and choose a role:
  • Admin: Full access including settings
  • Member: Can create and edit content
  • Guest: View-only or limited access
2

Share specific pages

Right-click any page → Share → Add specific collaborators
3

Real-time editing

When multiple users edit the same page, you’ll see their cursors and changes in real-time

​
Step 6: Try chat and files

1

Create a channel

Click + New → Channel to create a team chat
2

Send messages

Type and press Enter to send. Use @mention to notify teammates
3

Add collaborators

Click channel settings → Add members to invite specific people

​
What’s next?

Now that you have your first workspace set up, explore these features:

Pages and blocks

Learn advanced editing features and block types

Database views

Master filters, sorts, and custom views

Team collaboration

Permissions, sharing, and real-time editing

Offline mode

How offline-first sync works in Brainbox
Need help? Join our GitHub Discussions or report issues on GitHub.

Build docs developers (and LLMs) love

Get started for freeTalk to us