# Theming

The docs app uses the local shadcn-svelte configuration in `components.json` and the global theme in `src/lib/styles/app.css`. See [Styles](/docs/styles) for the installable token files consumers get.

Published registry items are independent from the docs shell. Put installable component source in `registry/items/**`, and include any required CSS, dependencies, or registry dependencies in the item frontmatter.

Use semantic tokens such as `background`, `foreground`, `primary`, `muted`, and `border` so installed components remain easy to customize. Prefer Tailwind classes like `bg-primary` and `text-muted-foreground` over raw color values.