Feat: documentation

docs/getting-started/options.md

@@ -0,0 +1,41 @@
+# Options
+
+The Options page (`F3`) gathers all configuration settings in one place: display, synchronization and MIDI. Navigate options with `Up`/`Down` or `Tab`, change values with `Left`/`Right`. All changes are saved automatically.
+
+## Display
+
+| Option | Values | Description |
+|--------|--------|-------------|
+| Theme | (cycle) | Color scheme for the entire interface |
+| Hue rotation | 0–360° | Shift theme colors by a hue angle (±5° per step) |
+| Refresh rate | 60 / 30 / 15 fps | Lower values reduce CPU usage |
+| Runtime highlight | on / off | Highlight executed code spans during playback |
+| Show scope | on / off | Oscilloscope on the engine page |
+| Show spectrum | on / off | Spectrum analyzer on the engine page |
+| Completion | on / off | Word completion popup in the editor |
+| Show preview | on / off | Step script preview on the sequencer grid |
+
+## Ableton Link
+
+Cagire uses Ableton Link to synchronize tempo with other applications on the same network. Three settings control the connection:
+
+- **Enabled** — Turn Link on or off. When enabled, Cagire listens for peers and shares its tempo.
+- **Start/Stop sync** — When on, pressing play or stop in one app affects all peers.
+- **Quantum** — The beat subdivision used for phase alignment.
+
+Below these settings, a read-only session display shows the current tempo, beat position, and phase. The status line at the top shows the connection state: disabled, listening, or connected with peer count.
+
+## MIDI
+
+Four output slots and four input slots let you connect to MIDI devices. Cycle through available devices with `Left`/`Right`. Each slot can hold one device, and the same device cannot be assigned to multiple slots.
+
+## Onboarding
+
+At the bottom, you can reset the onboarding guides if you dismissed them earlier and want to see them again.
+
+## Keybindings
+
+| Key | Action |
+|-----|--------|
+| `Up` / `Down` / `Tab` | Navigate options |
+| `Left` / `Right` | Change value |