Features — the screens, and the decisions
The mockups #1109 was agreed against (2026-10-19), before any code: five
desktop screens and four phone screens, in html/. They are drawn to look
like Niman, in the Night palette of lib/src/ui/theme/niman.dart; where a
mockup and the app disagree, the app is what ships. The plan the work
follows — the model, the gating seam, the phases and the tests — is
docs/records/library-features.md.
Features is a per-library switchboard: what this library uses. A group turned off is gone from every surface — destinations, palette, keys, menus, toolbar, Insert sheet, dock, Home, Settings — and its background work stops. Nothing in the library’s files is changed or deleted by a switch.
| Screen | Desktop | Phone |
|---|---|---|
| The area: the presets strip pinned on top (Custom selected, since the switches match no preset), the groups in cards, each row its icon, its name, what off means and its switch; Audio notes off, so Transcription greyed with Needs Audio and its own value kept; Todo and reminders just turned off, and the snackbar saying three reminders were cancelled, with Undo | Desktop-1-Features | Phone-1-Features |
| The first normal open of an existing library after the update: the area opened by itself, the introduction card above the presets, Everything on, Done | Desktop-2-Introduction | Phone-2-Introduction |
| A library just created: What is this library for?, the four presets as large radio cards in place of the chip row, Notes only picked and the switches below already following it | Desktop-3-NewLibrary | Phone-3-NewLibrary |
| Settings → Navigation with Todo’s feature off: the row in its place, greyed, Off in this library, the link Off in Features › where the switch was; the rail preview without Todo | Desktop-4-Navigation | — (the same rows) |
The command palette asked for todo: only notes come back, and a quiet line under the key hints says Todo is off in this library · Features › |
Desktop-5-Palette | — (the same palette) |
| The Android home screen: the Todos widget in its off state (Todo is off in this library, Open Features), the Study widget beside it working as ever | — | Phone-4-Widget |
The groups
Core, never switchable: Files, the editor (source, live, read), notes and folders, links and backlinks, properties, tags, attachments, export, settings, themes and language, the palette and the keys, updates, the debug log, trash and version history.
| Section | Row | Off means | Needs |
|---|---|---|---|
| Finding and writing | Search | no search screen or commands; the index is still written | — |
| Quick note | no quick note; shared text goes to Import | — | |
| Templates | new notes and journal entries start with their default | — | |
| Web capture | no page capture; links stay plain links | — | |
| Planning | Todo and reminders | todo.txt stays a plain file; no reminders |
— |
| Journal | entries stay ordinary notes | — | |
| Calendar | calendar.txt stays a plain file; no event reminders |
— | |
| Note kinds | Lists | these notes open as plain Markdown; type: is kept |
— |
| Shopping lists | the same | Lists | |
| Audio notes | the same | — | |
| Transcription | no transcribe action; audio notes still record and play | Audio notes | |
| Slides | the same as the other kinds | — | |
| Flashcards and Study | the same; .niman/review.json is kept |
— | |
| Reading | PDF and EPUB readers | they open in the system app | — |
| Annotations | no annotate or highlight; the companion notes stay | Readers | |
| Text recognition | no OCR; the scans already made stay | — | |
| Around the app | Home | no Home | — |
| Home-screen widgets (Android) | the widgets say this is off; no data written for them | — |
Decided with them
- The name is Features, the place the Library group of Settings, its first row. Per library, like the rest of that group; not a fourth group.
- Off is inert, never destructive. No switch deletes, moves or
rewrites a file or a setting. A note of a kind that is off opens in the
plain editor, keeps its
type:, and wears the generic note icon in the tree; turning the kind back on brings its view back. No migration. - No per-note override. The switch belongs to the library; a note that
wants to be plain Markdown drops its own
type:. - Reminders are cancelled, not left firing. Turning off Todo or Calendar cancels the alarms already scheduled — the snackbar says how many, and Undo turns the feature back on — and turning it on schedules them again from the files. A widget whose feature is off shows that it is off and opens Settings → Features.
- A PDF or an EPUB with the readers off opens in the system app, like any attachment the app does not show.
- Dependencies grey, they do not cascade. A child whose parent is off stays where it is, disabled, with Needs … for its line, and keeps its own value: turning Audio back on brings Transcription back as it was. What counts is the parent and the child both on. Shopping lists need Lists (the two views swap from the same ⋮); Text recognition does not need the readers (images are recognised without them).
- Sync is not a feature. It is already per library and per device,
and off until a server is connected; a switch in
settings.jsonwould travel with the very sync it stops. Connect and Disconnect stay in Settings → Sync, and no preset touches it. - The presets. Everything (the default), Writing (notes, search, templates, readers), Notes only (notes and search: everything else off, templates and readers too), Tasks and journal (todo, journal, calendar, Home). A preset only writes the switches. The strip is pinned over the area so it stays in reach while the list scrolls; Custom is always its last chip, dimmed while the switches match a preset and selected when they match none, so the row never moves under the pointer.
- Navigation is two layers. A destination shows when its feature is on
and Navigation does not hide it; turning a feature off writes nothing
to
navigation, so turning it on restores the order and the visibility the user had. In Navigation the row keeps its place, greyed, with Off in Features › where its switch was. - The areas follow the switches. Settings drops the area of a feature that is off — Transcription with Audio off, Study with flashcards off, Reminders only when Todo and Calendar are both off — and so does the settings search. The rail behind the window follows Navigation’s rule.
- The palette says why it found nothing. A query that matches only commands of a feature that is off lists no command, and a quiet line under the key hints names the feature and links to Features.
- The introduction is once per library, in the library’s settings.
featuresReviewedin.niman/settings.json: set when the screen is left (Done, back,Esc), not when it opens, so a crash or a kill shows it again; it syncs, so a second device does not ask again. Only a normal library open triggers it — a share, a widget, a notification, a reminder or a deep link opens its target and leaves the flag as it was. A library created by the new build sees it at creation, as What is this library for?, the presets as large cards in place of the chip row. A boolean, no re-prompt when a later build adds a group: the new group is born on and simply appears. Show this introduction again at the foot of the area shows the card and changes no switch. - The Android widgets row shows on every platform, tagged Android: the setting travels with the library and acts where widgets exist.
- Every string in all 37 languages, in the same change as the screen.
- All the groups ship together, gated on every surface before the screen is released — not a first round of the cheap ones.
- Phone frames are 360 × 800 here; the earlier mockups are 390 × 844.