Experience principles

The rules every screen, string and flow follows.

Nocturne is for people who do not know or care what a model, an NPU or a token is. These principles decide every trade-off between capability and clarity.

Principle In practice
Useful in the first minute Capture works before the first model download finishes; understanding queues
No jargon The interface never says model, inference, token, NPU, GPU, embedding or graph outside an advanced details view. Away from home also avoids tunnel, VPN, node, tailnet, port, certificate, endpoint, remote, encryption, "encryption key", "private key", "public key" and "security key". Online answers also avoids cloud, API, provider, endpoint, LLM and prompt, except the exact phrases "API URL", "API key", "model name" and "your provider"; "key" is allowed. Model names come from data, never from copy
Show the receipts Every answer and every line on the page links to the original photo, recording or note
Honest about uncertainty Say "I am not sure" and ask, rather than guess with confidence
Forgetting is gentle and reversible Fading and letting go are visible, undoable and explained; hard deletion is explicit and confirmed
Private by proof, not by promise The app shows that nothing leaves the computer instead of only claiming it
Zero required settings Defaults are right for most people; settings exist but nothing needs them
Calm presence No badges, streaks or engagement loops; one page a day, one question a day
Recover without asking Background failures restart and retry on their own; the person sees a plain sentence only when they must act
Accessible by default WCAG 2.2 AA, complete keyboard use, screen reader support, text scaling and reduced motion

Connections

Local graph

Linked from

  • DesignDesign“Experience principles”
  • Contribution guideContributionRules a first change trips on“experience principles”