⚠️ The new ZFordDev Documentation Portal is currently under active development. Search is not yet enabled and some pages are still missing. Please bear with us while we transition to the new system.
Card System
Cards are the core unit of SnapBoard.
They represent tasks, notes, ideas, linked documents, or anything you need to track inside a board.
This guide explains how cards work, how to edit them, and how they behave inside columns.
Creating Cards
You can create cards in two ways:
Add Card
Click + Add Card at the bottom of any column. This creates a new empty card directly inside that column.
Quick Add
Double‑click inside any column to instantly create a new card. This is ideal for rapid note‑taking or brainstorming.
Editing Cards
Click any card to open the Card Editor Modal.
The editor includes:
- Title (top left)
- Markdown editor (mid left)
- Live preview (right)
- Attachment panel (bottom)
Markdown Support
SnapBoard supports:
- headings
- bold/italic
- lists
- code blocks
- links
- inline formatting
Rendering is handled safely inside the preview panel.
Note: Markdown sanitization is being improved for Beta.
Attachments
Cards support file attachments via drag‑and‑drop.
Adding Attachments
- Drag a file onto the card
- Or drag into the editor modal
- SnapBoard stores the attachment reference in the board’s
.dbfile
Attachment Behavior
- Attachments are referenced, not embedded
- Absolute paths are used in Alpha
- Beta introduces safer, more portable handling
Supported File Types
- Images
- Documents
- Text files
- Code snippets
- Anything your OS can reference
Moving Cards
SnapBoard uses a smooth drag‑and‑drop system.
Reordering Within a Column
- Click and hold a card
- Drag up or down
- Drop to reorder
Moving Between Columns
- Drag a card horizontally
- Drop it into any column
- SnapBoard updates the card’s workflow state instantly
Performance Notes
- Movement is instant
- No manual saving required
- Large boards remain responsive
Card Metadata
Each card stores:
- title
- markdown content
- attachments
- creation timestamp
- last‑edited timestamp
- column position
- board ID
This metadata is stored in the .db file and updates automatically.
Deleting & Archiving Cards
SnapBoard provides two removal options:
✔ Delete Card
Permanently removes the card from the board.
✔ Archive Card (Beta)
Moves the card into an archive container for later retrieval. you can find archived cards in the right hand pannel marked Archived
Archiving is being expanded during the Beta cycle.
Card Limits & Performance
SnapBoard is designed to handle large boards.
Recommended Limits
- Cards per column: 200+
- Total cards per board: 1,000+
- Attachments: Unlimited (system‑dependent)
Performance Characteristics
- Markdown rendering only happens when card is viewable
- Drag‑and‑drop remains smooth
Tips for Effective Card Usage
A few small details that make planning smoother:
- Use short card titles for quick scanning
- Use markdown headings inside cards for structure
- Attach files sparingly to avoid clutter
- Break large tasks into multiple cards
- Use columns to represent workflow stages
More advanced card features will be documented as SnapBoard approaches Beta.