Boards & Columns

This guide explains how SnapBoard structures your workflow using boards, columns, and drag‑and‑drop interactions.
Boards act as containers for your projects, while columns define the flow of work inside each board.

What Is a Board?

A board is the top‑level workspace in SnapBoard.
Each board contains:

• a set of columns
• cards inside those columns
• metadata such as board name and layout
• persistent storage in the local Database file

Boards are designed to be:

• lightweight
• local‑first
• instantly accessible
• easy to reorganise

You can create as many boards as you need — each one is stored independently.

Columns: The Structure of Your Workflow

Columns represent stages, categories, or logical groupings inside a board.
They define the flow of your work.

Default Layout

When you create a new board, SnapBoard generates 3 default columns, which you can rename or remove:

double click the name to change them to what you want.

These defaults are intentionally generic so they work for:

• writing
• development
• content planning
• personal organisation

You can customise them freely.

Managing Columns

SnapBoard allows full control over your board layout.

✔ Renaming Columns

Click the column header to rename it.
Names update instantly and persist automatically.

✔ Adding Columns

Use Add Column at the far right of the board.
SnapBoard supports up to 32 columns per board.

✔ Removing Columns

Columns can be removed at any time.
Cards inside a removed column will be deleted with it.

✔ Reordering Columns

Drag a column header left or right to rearrange your workflow.

Column reordering is instant and saved automatically.

Cards Inside Columns

Cards represent tasks, notes, ideas, or linked documents.
They live inside columns and can be moved freely.

Card Actions

• Click to open the markdown editor modal
• Drag to reorder within a column
• Drag between columns to update workflow state
• Attach files via drag‑and‑drop
• Delete or archive cards

Cards update instantly and persist to the board’s .db file.

Note:
Alpha versions use a .json to store data, this is brittal and prone to breaking, once upgraded to any version beta+ will migrate data to the .db storage.

Drag & Drop Behavior

SnapBoard’s drag‑and‑drop system is designed to feel natural and predictable.

Moving Cards

• Click and hold a card
• Drag it to a new position
• Drop it into any column

SnapBoard automatically updates:

• card position
• card column
• board state

Moving Columns

• Click and hold a column header
• Drag left or right
• Drop to reorder

Column reordering is saved immediately.

Column Limits & Performance

SnapBoard is designed to remain fast even with large boards.

Recommended Limits

• Columns: Up to 32
• Cards per column: 200+
• Total cards per board: 1,000+ (varies by hardware)

Performance Notes

• Drag‑and‑drop remains smooth even with large boards
• Markdown rendering happens to only seeable cards to keep proformance lean.
• The .db backend prevents JSON bloat from older versions

Tips for Better Board Design

A few small details that make planning smoother:

• Keep column names short for readability
• Group related work into adjacent columns
• Use markdown headings inside cards for structure
• Attach files sparingly to avoid clutter
• Split large projects into multiple boards

More advanced board features will be documented as SnapBoard approaches Beta.