▧ base / notes guide
ORIGINALS FIRST / EVERY CHANGE HAS A PLACE

Your input stays yours.

Notes keeps original text, handwriting, recordings and photos. A transcript or edit becomes a separate revision; output settings never rewrite the original.

Capture a note

Boxes, connected notes and sheets

Choose Notes & sheets to open saved captures as note panels. Select saved text and choose Box selected text, or drag over ink/an image and choose Box selected area. Name a box if useful, then click its boxed content or tree button to zoom within the same panel. Back and Whole note return to the larger view. Boxes keep their saved version: Apply edits the same parent source while that version is current; older boxes remain readable when the parent changes.

Hold Ctrl while selecting to cut content into a separate note, or use the Cut buttons. The parent has no backlink or placeholder. Ink cuts move whole touching strokes. Image cuts hide the selected area in the current parent view while preserving original bytes. Use ↑ to open the original without changing the active text revision. Apply text saves a revision; editing drafts also save locally.

Drag a Connect handle onto another note, or choose source/destination notes and Connect notes. Select several note checkboxes, name a sheet and Combine selected notes to show those same editable notes together. Separate sheet removes that presentation only. Area coordinates and native buttons/selectors provide keyboard alternatives. A mixed-media sheet retains each member source; selection targets one member at a time. Capture tools returns to recording/typing and formatted output.

Information on fields and atoms

Hover a configured field, use its information button, or press F2. Double-click its information value or choose Edit; Apply changes that exact field and Cancel leaves it unchanged. Native validation and form submission stay intact. Separate field notes are an optional setting, and never replace the field value.

Try the product-entry/code-note workbench and shared input settings. The Notes title and typed draft use the same binding; the surrounding note tool supplies capture methods, so it does not nest another copy inside itself.

Edit without losing the source

Select a capture in Originals & revisions. Inspect the original, choose a saved version, or type in Modified text revision and Save new revision. An unfinished editing draft saves locally too. Discard editing draft removes only that draft. Archive excludes a capture from output while retaining it in the notebook.

Output & input settings controls Markdown/plain text, paragraphs/bullets/checklists, timestamps, original text, whitespace and a literal template. Tokens: {{title}}, {{body}}, {{date}}, {{count}}. Keep output snapshot retains exact formatted text with its source history.

Local recognition and optional online conversion

Local is the default and never silently switches online. It needs a supported on-device browser recognizer or the Windows localhost adapter with an installed, accessible recognizer. Earlier Windows handwriting verification passed, while Windows speech access and a local Edge speech pack were unavailable in that test environment. Browser speech availability is checked only on an explicit conversion, keeping page startup independent of native speech services. Audio originals can still be retained and transcribed later.

For online conversion, choose the online mode and check the one-conversion opt-in before sending an original. A blank endpoint uses the browser's speech service for audio; that service may process remotely. Handwriting/photos need a configured HTTPS recognition endpoint. Opt-in resets after each attempt. Server credentials belong on your server, never in this page.

The localhost adapter is part of npm start. A static-only deployment does not include Windows recognition. Device capture needs HTTPS or localhost. You can check permissions and hardware in the Input lab; no device opens merely by loading a page.

Save, move and back up

The app saves locally in IndexedDB. A notebook contains originals, revisions, unfinished drafts, output settings and saved output snapshots. Backup originals + revisions downloads the complete notebook, including attachments. Import creates a new notebook instead of overwriting one. Plain text/Markdown Download exports only the configured output.

Browser storage belongs to its origin; clearing browser data removes it. Use a full backup to move between browsers, ports or computers. Failed or conflicting saves remain visible; another tab cannot silently overwrite a newer saved notebook. Attachments are limited to 32MB each and 64MB per notebook.

The panel is a host. Minimize or dock it without remounting the note program. Capture tools reopens it. An explicitly started recording can continue minimized with a live recording indicator; closing the panel stops its inputs.

Build another atom or embed the program

Repository documentation: docs/CREATING-ATOMS.md explains the complete atom workflow; docs/PERIPHERALS.md defines device/recognition contracts; docs/NOTE-WIDGET.md contains standalone and panel embedding recipes, APIs and persistence ownership.

An atom owns one general UI responsibility. Hardware and storage are adapters. The note program combines those pieces and can run inside a panel, a content host, or an ordinary div. It does not require workspace code or an account.