Notes Guide¶

Create notes with interactive checklists, organize with colors and icons, and collaborate with your group.

Creating a Note¶

A note requires a title. Optionally set a color and icon for visual identification in the sidebar.

Privacy¶

When creating a note, you can mark it as private. Private notes are visible only to you — other group members cannot see them. This setting is locked after creation and cannot be changed later.

Public notes are visible to all group members.

Color and Icon¶

• Color — Hex code (e.g. #3B82F6) used for the sidebar border, detail header background, and progress bar. Defaults to blue.
• Icon — Select from the available icon set. Defaults to ShoppingCart.

See Your First Note for a step-by-step walkthrough.

Checklist Items¶

Each note can hold up to 999 items. Each item has:

• Text — Required, max 1,000 characters
• URL — Optional, max 2,048 characters. Must be a valid HTTP or HTTPS URL
• Completed — Toggle checkbox to mark done

Adding Items¶

Type in the input field at the bottom of the note and press Enter or click Add. New items appear at the top of the uncompleted section.

Editing¶

Click the edit icon on any item to modify its text and URL inline. The URL field is collapsible — expand it only when needed.

Marking Complete¶

Check the checkbox on any item to move it to the completed section. Toggle back to uncomplete if needed. The toggle endpoint has a higher rate limit (120 requests / 60s) to accommodate rapid checkbox interaction.

The note's progress bar updates in real time as items are completed.

Deleting¶

Click the delete icon on any item. A confirmation dialog appears before deletion. Deletion is soft — the record persists in the database.

Organizing Notes¶

Pinning¶

Pin important notes to keep them at the top of the sidebar. Pinned notes sort before all unpinned notes regardless of the current sort order. Toggle pin from the detail header — pinned notes show a pin icon in both the detail view and sidebar.

Sorting¶

Notes in the sidebar can be sorted by:

• Last updated (default)
• Title
• Date created

Pinned notes always appear first, then the rest sorted by the selected criterion.

Drag-and-Drop Reorder¶

Only uncompleted items can be reordered. Completed items are static at the bottom.

To reorder:

1. Press and hold the drag handle (six dots) on an item
2. Drag vertically to the desired position
3. Release to confirm the new order

On desktop, click and drag. On mobile, press and hold for 200ms before dragging. The drag is restricted to vertical movement only.

The order is saved optimistically — the UI updates immediately. If the server fails, the order reverts.

See Mastering Checklists for details.

Mobile Swipe Gestures¶

On mobile devices, swipe left or right on any item:

• Swipe right — Toggles the item between completed and uncompleted
• Swipe left — Opens a delete confirmation dialog

The swipe threshold is 80px. A background color and icon show the action that will be performed. Swiping is disabled while editing an item or interacting with the drag handle.

Attaching URLs¶

Each item can have an optional URL. When set, a link button appears on the item. URLs are normalized automatically — if you enter a URL without a protocol, https:// is prepended.

Rate Limits¶

Related¶

• Your First Note — Create and manage notes
• Mastering Checklists — Reordering, URLs, swipe gestures
• Data Model — Note, NoteItem entities
• API Endpoints — Notes endpoints