Files
bookhoard/docs/user/themes.md
T
John O'Keefe 10a5ac88da docs(user): themes — drop the invented 'default light theme' tag, per owner
Lupine's '(default light theme)' tag had no basis anywhere: the string
exists only in the ThemeType union, and there is no light-default logic
in theme.ts or the Appearance panel. Platform-owner clarification:
Tokyo Night is the sole default (fresh install); the Dark/Light control
is a list filter with per-half counts, not a theme toggle. The page now
says exactly that, keeps the code-verified bits (mode filter opens on
your current theme's half via ThemeModeOf, checkmark indicator, counts)
and states the one-default rule plainly.
2026-11-02 10:39:09 -05:00

93 lines
3.6 KiB
Markdown

# Themes and Wood Paneling
## Color Themes
Bookhoard includes 37 color themes — 24 dark and 13 light — including the
full set of [Omarchy](https://omarchy.org) defaults alongside the classics:
**Dark**
- **Tokyo Night** (default) - Dark blue/purple tones
- **Dracula** - Dark purple accent colors
- **Nord** - Arctic, bluish-gray colors
- **Solarized Dark** - Precision contrast for readability
- **Monokai** - Dark theme with vibrant accents
- **One Dark Pro** - Atom's favorite theme
- **Material Dark** - Material Design dark theme
- **Catppuccin Mocha** - Soothing pastel dark theme
- **Catppuccin Macchiato** - Warm mid-tone theme
- **Catppuccin Frappé** - Frothy cool tones
- **Vantablack** - Pure black
- **Last Horizon** - Near-black with warm rose accents
- **Ethereal** - Deep midnight blue with peach text
- **Hackerman** - Terminal green on black
- **Matte Black** - Flat black with amber accents
- **Solitude** - Quiet blue-grey monochrome
- **Retro 82** - Amber terminal on deep navy
- **Osaka Jade** - Dark teal with jade accents
- **Kanagawa** - Ink-dark waves and cream ink
- **Miasma** - Swampy dark greens and ochre
- **Lumon** - Cold teal, for the severed floor
- **Ristretto** - Coffee-dark with warm peach
- **Gruvbox** - Retro groove, warm dark
- **Everforest** - Cozy green-toned dark
**Light**
- **Lupine** - Clean light with violet-blue accents
- **Tokyo Night Day** - Daylight counterpart of the default
- **Solarized Light** - Precision contrast on warm paper
- **One Light** - Atom's light theme
- **Ayu Light** - Bright and airy with orange accents
- **GitHub Light** - Familiar, clean white
- **Gruvbox Light** - Warm cream paper
- **Everforest Light** - Soft green-tinted daylight
- **Kanagawa Lotus** - Kanagawa's lotus-paper palette
- **Catppuccin Latte** - Warm light pastels
- **Rosé Pine** - Soft rose-tinted daylight
- **Flexoki Light** - High-contrast warm paper
- **White** - Pure monochrome white
### Changing Your Theme
1. In the sidebar, open the **Appearance** panel (palette icon, near the bottom)
2. Use the **Dark / Light** switch at the top to show the half you want —
it opens on the half your current theme lives in, and each side shows
how many themes it holds. The switch only filters the list; it never
changes your theme by itself
3. Pick a theme from the list — each option shows its color swatch, and your
active theme is marked with a checkmark
4. Your choice is saved automatically and synced across devices
There is exactly one default: **Tokyo Night** on a fresh install. Nothing
else is pre-selected for you — pick whichever theme you like from either
half.
On small screens, open the sidebar with the menu button in the top bar first.
## Wood Paneling
Wood paneling adds texture to your dashboard bookshelf background, giving it a classic bookshelf feel.
### Available Wood Textures
- **None** (default) - Solid color background
- **Wood Light** - Light oak/birch texture
- **Wood Dark** - Dark walnut/mahogany texture
- **Wood Mahogany** - Reddish-brown mahogany texture
### Applying Wood Paneling
1. In the sidebar, open the **Appearance** panel (palette icon, near the bottom)
2. Scroll to the **Bookshelf** section below the theme list
3. Select your preferred wood texture (each option shows a texture swatch; **None** is the default)
4. Texture is applied to the dashboard bookshelf background
**Note:** Wood paneling is a browser preference and is not synced across devices.
### Tips
- Wood textures work best with darker color themes (Tokyo Night, Nord, etc.)
- Light wood pairs well with light themes (Catppuccin Latte)
- Wood paneling only affects the dashboard bookshelf area