> ## Documentation Index
> Fetch the complete documentation index at: https://docs.luminy.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Customize Luminy's Appearance: Themes, Colors, and Layout

> Personalize Luminy with dark or light mode, accent colors, font size, and chat bubble style. All appearance settings apply instantly without restarting.

Luminy gives you full control over how the app looks and feels. You can switch between dark and light mode, pick an accent color (or define your own), adjust the chat text size, and choose a chat bubble layout — all from **Settings → Appearance**. Every change takes effect immediately; you never need to restart.

## Theme

Luminy defaults to **dark mode**, which is optimized for long coding sessions. Switch to **light mode** if you prefer a brighter interface or work in a well-lit environment.

<Steps>
  <Step title="Open Settings">
    Click the **Settings** icon in the sidebar or press the keyboard shortcut for settings.
  </Step>

  <Step title="Go to Appearance">
    Select the **Appearance** tab at the top of the settings panel.
  </Step>

  <Step title="Click your preferred theme">
    Click the **Dark** or **Light** preview card. The interface updates instantly.
  </Step>
</Steps>

<Note>
  The theme is saved automatically. The next time you open Luminy, it will restore your chosen theme without any flash of the default style.
</Note>

## Accent Color

The accent color controls buttons, highlights, active states, and focus rings throughout the app. Luminy ships with five built-in presets plus a fully custom hex option.

### Built-in presets

| Swatch | Name   | Hex value           |
| ------ | ------ | ------------------- |
| 🔵     | Blue   | `#3b82f6` (default) |
| 🟣     | Purple | `#8b5cf6`           |
| 🟢     | Green  | `#10b981`           |
| 🟠     | Orange | `#f59e0b`           |
| 🔴     | Red    | `#ef4444`           |

Click any color dot in the **Accent color** row to apply it immediately.

### Custom hex color

Click the **+** (dashed circle) button next to the presets to open the custom color picker. You can:

* Type any valid 6-digit hex value directly, e.g. `#7c3aed`
* Click the color swatch to open your operating system's native color picker

<Tip>
  When you enter a custom hex color, Luminy automatically derives a darkened hover state and calculates the correct text contrast color (dark or light) so all interactive elements stay readable regardless of the hue you choose.
</Tip>

Selecting a preset accent after setting a custom color clears the custom value and switches back to the preset.

## Font Size

The font size setting controls the base text size used throughout the chat view. Choose whichever size feels comfortable for your display and working distance.

| Option     | Size      | Best for                                   |
| ---------- | --------- | ------------------------------------------ |
| Small      | 13 px     | Dense information displays, large monitors |
| **Medium** | **14 px** | **Default — good for most setups**         |
| Large      | 15 px     | High-DPI screens, accessibility needs      |

Click **Small**, **Medium**, or **Large** in the segmented control under **Font Size**. The change applies immediately across the entire chat view.

## Chat Bubble Style

The chat bubble style changes the visual layout of messages in the conversation panel. It's a purely aesthetic choice — neither option affects agent behavior.

<CardGroup cols={2}>
  <Card title="Flat" icon="align-left">
    Messages render as plain text blocks without borders or background fills. Clean and minimal — similar to a code editor or terminal output. This is the default.
  </Card>

  <Card title="Bubbles" icon="message">
    Messages render inside rounded bubble containers. A familiar Discord- or iMessage-style layout that visually separates each speaker.
  </Card>
</CardGroup>

Click either style card under **Chat Bubble Style** to switch immediately.

## Persistence and Sync

All appearance settings — theme, accent, custom hex, font size, and bubble style — are saved automatically on your device. They persist across app restarts with no additional action needed.

<Note>
  Appearance settings are **per-device**. They are stored locally and are not synced to any account or shared across machines. If you use Luminy on multiple computers, configure appearance on each one separately.
</Note>