Skip to main content
Pages are Brainbox’s core document type, providing a flexible canvas for notes, documentation, and content creation. Each page uses a block-based editor that supports rich formatting, embeds, and real-time collaboration.

​
Creating Pages

Pages can be created anywhere in your workspace hierarchy. Each page has:
  • Name - The page title
  • Avatar - Optional emoji or icon
  • Content - Rich text blocks with formatting
  • Parent - The folder or space containing the page
1

Create a new page

Click the + button in any folder or space, then select Page from the menu.
2

Add a title

Enter a descriptive name for your page. You can change this anytime.
3

Start writing

Begin typing to add content. Use / to open the block menu and insert different block types.

​
Block-Based Editing

Pages use a rich text editor built on ProseMirror with support for multiple block types. Each block can contain:

Text Content

Paragraphs with inline formatting (bold, italic, code, links)

Headings

Structure your content with H1, H2, and H3 headings

Lists

Ordered and unordered lists with nested items

Code Blocks

Syntax-highlighted code with language support

Quotes

Block quotes for highlighting important content

Dividers

Horizontal rules to separate sections

​
Block Structure

Each block in the page is stored with:
  • ID - Unique identifier for the block
  • Type - Block type (paragraph, heading, list, etc.)
  • Content - Text content with marks (formatting)
  • Attributes - Block-specific settings (heading level, code language)
  • Index - Position in the document
  • Parent ID - For nested blocks (list items)
{
  id: "block_abc123",
  type: "paragraph",
  content: [
    {
      type: "text",
      text: "Hello world",
      marks: [
        { type: "bold" },
        { type: "italic" }
      ]
    }
  ],
  index: "a0",
  parentId: null
}

​
Inline Formatting

Apply rich formatting to text within blocks:
ShortcutFormat
Cmd/Ctrl + BBold
Cmd/Ctrl + IItalic
Cmd/Ctrl + UUnderline
Cmd/Ctrl + KLink
Cmd/Ctrl + ECode
Cmd/Ctrl + Shift + SStrikethrough

​
Page Organization

Pages support hierarchical organization:
Pages can be nested inside folders or other pages to create a tree structure. Use drag-and-drop to reorganize your content.

​
Page Hierarchy

Workspace (Space)
├── Getting Started (Folder)
│   ├── Welcome (Page)
│   └── Quick Start (Page)
├── Projects (Folder)
│   ├── Project A (Page)
│   │   ├── Meeting Notes (Page)
│   │   └── Tasks (Page)
│   └── Project B (Page)
└── Archive (Folder)

​
Permissions

Page access is controlled by workspace roles:
RoleCreateEditDelete
Admin✓✓✓
Member✓✓✓
Viewer✗✗✗
Guest✗✗✗
Members can create, edit, and delete pages in any space where they have member-level access. Permissions are inherited from parent folders and spaces.

​
Real-Time Collaboration

Multiple users can edit the same page simultaneously:

Live Cursors

See where other users are typing in real-time

Conflict Resolution

CRDT technology automatically merges changes without conflicts

Offline Editing

Keep working offline - changes sync when reconnected

Version History

Track changes and restore previous versions
See Collaboration for more details on real-time editing.

​
Working Offline

Pages are stored in your local SQLite database, allowing full offline functionality:
1

Offline editing

All page edits save to your local database immediately, even without internet.
2

Background sync

When reconnected, changes automatically sync to the server.
3

Conflict resolution

If multiple users edited offline, CRDTs merge changes intelligently.
While offline, you can only access pages that were previously loaded. New pages created by others won’t appear until you reconnect.

​
Page Metadata

Each page stores additional metadata:
  • Created At - When the page was created
  • Created By - User who created the page
  • Updated At - Last modification time
  • Updated By - User who made the last change
  • Index - Position in the parent container

​
Best Practices

Clear, specific titles make pages easier to find and organize. Use sentence case for readability.
Break long pages into sections with H2 and H3 headings for better navigation and readability.
Use nested pages or folders to group related documentation, notes, or project materials.

​
Next Steps

Databases

Create structured data with custom fields and views

Files

Upload and manage files in your pages

Collaboration

Learn about real-time editing and offline sync

Chat

Discuss pages with your team in channels

Build docs developers (and LLMs) love

Get started for freeTalk to us