Patterns
Create a board while adding a link
Keep organization inside the link task without pretending two writes are atomic.
On this page
Task sequence
- Choose Create new board in the link editor.
- Enter the new board name.
- Retain URL, label and optional icon.
- Create board first, then link, then select the new collection.
Data and persistence
The source performs sequential board POST and link POST. If link creation fails after board creation, the board already exists and remains in local state. There is no transaction spanning the two endpoints.
Failure and recovery
Board-name validation appears next to the inline field. Retry requires awareness that a board may already have been created; a compensating rollback is not implemented.
Acceptance criteria
- New-board choice focuses the board name.
- Explain partial-save behavior to maintainers.
- Do not claim atomicity or hidden rollback.
Source references
| Repository file | Responsibility |
|---|---|
| app/(home)/AppHome.tsx | __create__ flow |
| app/api/boards/route.ts | Board POST |
| app/api/links/route.ts | Link POST |
Examples from the app
Actual Startboard source UI with isolated fictional records; both native themes at 2× resolution or higher. No live integrations or account writes. Captured at 2× resolution or higher. Select an image to inspect it full size.
Related topics
Source audit: 2026-10-08 · Revision 08fa2595a668 · Documentation v1.0.0