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

# Admin themes

> Admin Modern is the only admin theme. Change its colors and corners in settings, or build your own pages with its kit.

![Colors, corner roundness, dark mode, theme.css tokens and addon pages](https://mintcdn.com/dezerx/W6tdUG_weSNDlVA2/public/themes/admin-themes/layers.webp?fit=max\&auto=format\&n=W6tdUG_weSNDlVA2\&q=85\&s=17924da4c834a4ce730d1cba7a2ba88a)

Since 2026.11.2 the admin area has one theme, Admin Modern. There is no admin theme switch any more. Pages that have no Admin Modern version yet fall back to the older layout automatically.

If you want to change how the customer area looks, see [client themes](https://docs.dezerx.com/extensions/tutorials/client-themes.md).

## Change it without code

![The Colors page with light and dark switch, presets and every color](https://mintcdn.com/dezerx/dVNBM3sq4VCh7CKa/public/themes/admin-themes/colors-page.webp?fit=max\&auto=format\&n=dVNBM3sq4VCh7CKa\&q=85\&s=d8d2871b4cda7a8f3066ebbab3a30318)

**1. Open the Colors page**

Go to Appearance, Colors in the admin menu. Pick a preset or change any color. The whole site previews it live.

**2. Do light and dark separately**

The switch at the top edits the light or the dark palette. Each color has its own default and a reset button.

**3. Save**

Saved colors go live for every visitor and every admin without a rebuild. Import and Export move a palette between installs.

The same colors also style the customer area, so one palette covers both.

![Settings, Appearance, Corners](https://mintcdn.com/dezerx/dVNBM3sq4VCh7CKa/public/themes/admin-themes/corners.webp?fit=max\&auto=format\&n=dVNBM3sq4VCh7CKa\&q=85\&s=7365d4ba9aa777bc1d467e1f0a575d94)

Corner roundness is under Settings, Appearance, Corners. It goes from 0 to 200 percent and 100 is the default. The setting is `ui_corner_radius` and it scales every rounded corner in the admin and in the customer area. The change previews while you drag the slider.

## Before and after

![Admin overview with the default palette](https://mintcdn.com/dezerx/dVNBM3sq4VCh7CKa/public/themes/admin-themes/before.webp?fit=max\&auto=format\&n=dVNBM3sq4VCh7CKa\&q=85\&s=ebc729772cbeb46404a9fdbb3275bb58)

Default colors and corners

![Admin overview with a purple accent and square corners](https://mintcdn.com/dezerx/dVNBM3sq4VCh7CKa/public/themes/admin-themes/after.webp?fit=max\&auto=format\&n=dVNBM3sq4VCh7CKa\&q=85\&s=0f92e8b520d083cd261cb64059d786ef)

New accent color, square corners

## theme.css tokens

Admin Modern styles itself from variables in `resources/js/pages/admin-themes/admin-modern/theme.css`. They are all scoped to `.admin-modern` and most are built from the site colors, so they follow the Colors page and dark mode.

| Token | Used for |
| - | - |
| `--am-page`, `--am-surface` | Page and card backgrounds |
| `--am-ink`, `--am-muted-ink` | Text |
| `--am-accent`, `--am-accent-soft` | Links, active items, focus |
| `--am-hairline` | Borders and dividers |
| `--am-good`, `--am-warning`, `--am-critical` | Status colors |
| `--am-seq-1` to `--am-seq-5` | Chart and heatmap scales |
| `--am-control-h` | Height of buttons and fields |

```css theme={null}
.admin-modern {
    --am-accent: var(--link-active);
    --am-surface: var(--bg-secondary);
}
```

> [!TIP]
>
> Prefer the Colors page over editing `theme.css`. Edits to the file are overwritten by an update, the Colors page is stored in the database and survives.

Dark mode is a `.dark` class on the page. Status colors have a light and a dark value in `theme.css`, the rest follow the site palette.

## Custom pages with the kit

An addon can add its own admin screens that look native. Wrap the page in `AdminLayout` and an `admin-modern` div, then build from the kit in `admin-themes/admin-modern/components/`.

```tsx theme={null}
import AdminLayout from '@/layouts/AdminLayout';
import { PageHeader, Stat, StatGroup } from '@/pages/admin-themes/admin-modern/components/ui';

export default function Overview({ total }: { total: number }) {
    return (
        <AdminLayout title="Overview">
            <div className="admin-modern">
                <PageHeader title="Overview" description="What happened this week." />
                <StatGroup>
                    <Stat label="Total" value={total} />
                </StatGroup>
            </div>
        </AdminLayout>
    );
}
```

| Part | Where | Gives you |
| - | - | - |
| `PageHeader`, `Stat`, `StatGroup`, `StatusText` | `components/ui` | Title, numbers, status labels |
| `DataTable`, `FilterBar`, `SearchField`, `FilterSelect`, `DateRangeFilter` | `components/ui` | Lists with filters |
| `Dialog`, `EmptyState` | `components/ui` | Modals and empty states |
| `Panel`, `SegmentedControl` | `components/` | Grouped sections and toggles |
| `ConfirmDialog`, `IconAction`, `Notice` | `components/actions` | Row actions and notices |
| `Field`, `FormSection`, `SwitchRow`, `MoneyInput` | `components/form` | Forms |

> [card] [Admin pages](https://docs.dezerx.com/extensions/tutorials/admin-pages.md)
>
> Register the page, route it and give it a permission.

Because the kit reads the tokens above, your page follows the Colors page, the corner setting and dark mode with no extra work.

> [!WARNING]
>
> Do not hardcode hex colors or pixel radii in an addon page. Use the `--am-*` variables and Tailwind `rounded-*` classes.

## Keep your changes through updates

Colors and the corner setting live in the database, so updates never touch them. Addon pages are part of the module, and modules that do not ship with the release are restored by the updater.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.