forked from bots-garden/ori
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 1 | # How to switch between the light and dark themes |
| 2 | ||
| 3 | This guide shows how to change Ori's colour theme. It assumes Ori is open in your browser (see the [getting started tutorial](../tutorials/getting-started.md)). | |
| 4 | ||
| 5 | ## Steps | |
| 6 | ||
| 7 | 1. Look at the right of the header, next to **⊞ Workspace**: the **☾** button switches to the dark theme; once dark, it becomes **☀** and switches back to light. | |
| 8 | 2. Click it. The whole page follows — conversation, workspace panel, code previews and editor (Monaco switches between its `light` and `vs-dark` palettes). | |
| 9 | ||
| 10 | ## Variants | |
| 11 | ||
| 12 | - Light is the default. Ori no longer follows the operating system's light/dark preference: the theme is whatever was chosen last in this browser. | |
| 13 | - The choice is remembered per browser (localStorage key `ori.theme`, values `light` or `dark`) and applied before the first paint on the next load. Clearing the site data restores light. | |
| 14 | - The terminal tab keeps a dark background in both themes, like an IDE's integrated terminal. | |
| 15 | - Several browsers connected to the same Ori server each keep their own theme: it is a browser preference, not part of the shared session. | |
| 16 | ||
| 17 | ## See also | |
| 18 | ||
| 19 | - Why the theme is browser state and not server state: [explanation: architecture](../explanation/architecture.md) | |
| 20 | - The other workspace conveniences: [How to use the workspace panel](use-the-workspace.md) |