settings.json

Your app preferences, at the repo root, in one file with four sections. Written by the settings views and by uv run slp setup. Git-ignored. A missing file, section or key means the default.

{
  "global": { "profile": "auto", "ui_font": "mono", "font": "mono", "voice_model": "", "mark_colors": "" },
  "shortcuts": { "cards.skip": "k" },
  "theme": { "active": "", "custom": [] },
  "cards": { "intervals": [1, 3, 5, 10, 20, 40] }
}

Older installs kept global flat at the top level, with shortcuts.json and card-config.json next to it: they are read from there and merged into this file on the next save, and the old files are removed.

global

values

all strings. Anything else is refused

read by

the server, and slp-setup and slp-init for profile

env

NOTES_VOICE_MODEL sets the model when voice_model is empty

not here

content zoom and text width live in the browser's local storage

shortcuts

Your rebound keys, written by the shortcuts view. Only the keys you changed, action → key:

"shortcuts": { "cards.skip": "k", "notes.dictate": "alt+d" }

A key is [ctrl+][alt+][shift+][meta+] then a letter, digit, space or enter. Unknown actions, bad keys and keys used twice on one screen are refused; a hand-edited section with any of those reads as the defaults. Notes keys need ctrl, alt or meta, and ctrl or meta with a b c i s v x y z is kept for the editor.

theme

The active theme and your own ones, written by the themes view and the ◐ selector in the statusline.

"theme": {
  "active": "sakura",
  "custom": [{ "name": "my-theme", "dark": true, "colors": { "void": "#09110c", "…": "…" } }]
}

• active: "" (follows the OS) · sumi · kami · taiyo · sakura · umi · mori · the name of a custom theme. Unknown reads as ""
• custom: each theme has a name (lowercase letters, digits and dashes, up to 24, not a built-in name), dark (true or false) and colors with exactly void, carbon, graphite, iron, slate, pewter, steel, ash, fog, chalk, paper, accent, red, green, yellow, blue, magenta, cyan, orange, each a lowercase #rrggbb. A hand-edited list breaking those rules reads as empty
• Older files with theme under global are still read and moved here on the next save

cards

How long a flashcard waits between reviews, written by the cards view of settings, where you type each step as days since the previous step or since the start and the other column is worked out. The file stores days since the previous step:

"cards": { "intervals": [1, 3, 5, 10, 20, 40] }

Those are the defaults. A new card or a "don't know" is due now; each "knew it" in a row moves the card one step; one more "knew it" after the last step makes it learned and it stops coming up in "study due". 1 to 20 steps, whole days from 1 to 3650. A hand-edited section breaking those rules reads as the defaults. Your past reviews are kept: changing the steps only changes when each card is next due.

Other local folders

Also at the root, git-ignored, created on demand: