Statix Design System
@statix/ui gives Statix apps one look: design tokens from Penpot, a Tailwind v4 theme and Svelte 5 components built on bits-ui.
The components started as shadcn-svelte and keep its API, so shadcn examples work with a changed import path. The styling follows the Statix website and customer area: Geist, a navy ink, one blue accent, 28px cards and pill buttons.
The package targets SvelteKit 2 (2.57 or later) and SvelteKit 3, Svelte 5.40 or later and Tailwind CSS 4.1 or later.
Quick start
Install the package and the fonts. Your project needs the @statix registry in .npmrc, see Installation.
pnpm add @statix/ui
pnpm add @fontsource-variable/geist @fontsource-variable/geist-monosrc/app.css
@import 'tailwindcss';
@import '@statix/ui/theme.css';
@import '@fontsource-variable/geist';
@import '@fontsource-variable/geist-mono';src/routes/+page.svelte
<script lang="ts">
import { Button } from '@statix/ui/button';
</script>
<Button>Restore website</Button>Guides
Installation Registry access, the one CSS import, fonts and your first component.Theming How tokens, semantic variables and Tailwind utilities fit together.Foundations Colours, type scale, radii, spacing and shadows, read from the token files.Customization Five ways to change a component, from a CSS variable to copying the source.
Components
41 pagesActions
- Button Pill-shaped button for actions and links. Use one primary button per screen for the main action; everything else is dark, outline or ghost.
- Button group Joins related buttons into one pill: actions on the same object, a split button, or a value with a copy button.
- Toggle A button that stays on or off, such as pinning a website or showing archived items. For a set of options, use Toggle group.
- Toggle group A set of toggles where one or several can be on. Use the chip variant for list filters and outline for a joined view switcher.
Forms
- Label Visible name for a form control, set in body size with medium weight. Clicking it focuses or toggles the control.
- Input Single-line text field. It is 44px high with 16px corners and a white fill, so it reads as a field on both the page background and inside cards.
- Field Layout parts for forms: a label, the control, a description and an error, stacked with consistent spacing. Group fields with FieldGroup and FieldSet.
- Textarea Multi-line text field for messages and notes. It grows with its content and shares the look of Input.
- Input Group A field with icons, text or buttons inside its border. Use it for search bars, domain checks, URL prefixes and password fields.
- Checkbox A 20px box for options people can turn on or off independently. It fills with the primary blue when checked.
- Radio Group A set of options where exactly one can be chosen. Items are 20px circles that fill with the primary blue when selected.
- Switch Turns a setting on or off right away. 48 × 28 px, primary blue when on, grey when off.
- Select Pick one option from a list. The trigger looks like an Input; the list opens in a popover. Use NativeSelect when you need the browser picker.
- Native Select A styled browser <select>. It opens the system picker, which works best on phones and with long lists such as countries.
- Calendar A month grid for picking one date. The selected day is filled primary, today is primary-soft. Put it in a Popover to build a date picker.
Overlays
- Dialog A modal window on a soft navy scrim. Use it when the user has to read something or decide before going on, for example before restoring a backup.
- Alert Dialog A dialog that interrupts to confirm a step that is hard to undo, such as deleting a mailbox. It only closes through one of its buttons or Escape.
- Sheet A panel that slides in from an edge of the screen. Use it for navigation on phones, filters and short forms that should keep the page in view.
- Popover A small card anchored to a button. Use it for extra details or a quick setting that does not need its own page.
- Tooltip A dark label that appears on hover or keyboard focus. Use it to name icon buttons or add a short hint, never for content people must read.
- Dropdown Menu A list of actions or options that opens from a button. Use it for account menus and for actions on one item, such as a website row.
- Sonner A short message in the corner that confirms something happened, such as a started backup. It disappears after four seconds. Built on svelte-sonner.
Display
- Card White surface with a 28px radius that groups one topic, such as a product on the dashboard. Statix separates cards from the page by fill, so they have no border by default.
- Badge Small pill for a status, a count or a category. Penpot calls it Chip, and @statix/ui/badge exports both names.
- Alert Banner that tells the customer about something on this page, such as an approval that waits for them. Penpot calls it Notice, and @statix/ui/alert exports both names.
- Avatar Round picture or initials for a person, such as the customer in the top bar or Jonas Weber in the support row.
- Item Row with an icon tile, title, description and a trailing action or chevron. Use it for settings lists, quick links and activity feeds.
- Empty Placeholder for a list or page with nothing in it yet. It says why it is empty and offers the next step.
- Table Semantic table for lists with several columns, such as invoices or DNS records. Statix tables sit inside a card, with 56px rows separated by hairlines.
- Progress Rounded bar that shows how far a task or a quota is: a running backup, an upload or mailbox storage.
- Spinner Rotating icon for a short wait after the customer did something, such as checking a website or restoring a backup.
- Skeleton Pulsing bg-2 block that holds the place of content while it loads. Match the shape of what will appear.
- Separator 1px hairline between groups of content. Statix separates mostly by fill, so use a separator only where two blocks share the same surface.
- Kbd Shows a key or shortcut, for example in a search field or a tooltip.
- Accordion A stack of questions or sections that open one at a time. Use it for FAQs and for details the customer only sometimes needs.
- Collapsible Shows and hides one block of content behind a trigger. The parts are unstyled, so you decide what the trigger looks like.
- Scroll area A box with its own scrolling and a thin pill scrollbar. Use it for long lists inside a fixed-height card or for a row of cards that scrolls sideways.
Navigation
- Breadcrumb Shows where a page sits in the customer area and links back up the path. Use it on detail pages two or more levels deep.
- Pagination Splits a long list, such as invoices or backups, into pages. Page numbers are round pill buttons; the current page is filled ink.
- Sidebar The side navigation for app layouts, with groups, badges, sub-items and an icon-only collapsed state. On screens under 768px it opens as a sheet.
- Tabs Switches between panels of related content on one page, such as the sections of a website. Pick a style on Tabs.List: a quiet segmented control, a dark pill bar or nav-style underline tabs.
Patterns
23 pagesLayout
- Container Centres page content and adds the side padding. Use it for every full-width band so content lines up from header to footer.
- Section A page band with vertical rhythm and a Container inside. Landing pages stack Sections, each with its own heading.
- Section heading Title and supporting text at the top of a Section or page. It sets the heading level and the type scale in one place.
Marketing
- Logo The Statix wordmark with its two-stroke mark, drawn inline as SVG. It needs no static files and scales with its height.
- Site header The top bar of every Statix page: logo, main navigation and a few actions on one 72px white row. On phones the links fold into a menu.
- Art panel Abstract artwork for hero and service cards: a dark base, thin-rimmed shapes and one bright highlight. Each service gets its own drawing and tone.
- Tariff card One plan with its price, who it is for, what it includes and a button to choose it. Place two or three side by side to compare plans.
- Contact card Puts a named person, their hours and a direct phone line in front of the customer. Use the card on marketing and help pages, the inline row at the bottom of customer-area pages.
- Action dock A floating pill at the bottom of the screen that keeps the main actions in reach. The customer area uses it on a website page, marketing pages after the hero.
- Site footer The bottom of every page, above a hairline. The customer area uses a single bar with copyright and links. Marketing pages add columns with contact details and a sitemap.
Dashboard
- Dashboard start screen The customer area start screen, built only from @statix/ui parts: an Alert for pending approvals, four ProductCards, QuickLinks and a help row. Site header and footer are left out.
- HealthBand The navy banner at the top of a website page. It answers "Is my website OK?" in one headline, says what we checked, and links to the activity log.
- StatTile A white tile with a label, one value and a line of context. Put four in a row under the HealthBand to show backup, update, virus and uptime status at a glance.
- ProductCard A large card that leads into one product: websites, email, domains or invoices. The start screen shows four in a 2×2 grid, the first one in navy.
- ActionTile A compact tile for one task: icon, title, one line of detail and a chevron. Use a grid of them for the common tasks on a website or domain page.
- BigAction A wide row for one important task, with a large icon, a title, two lines of explanation and either a chevron or a button. Stack a few of them as the "What do you want to do?" list on a website page.
- WebsiteRow One website or domain per row: icon, domain, a status line and a status chip. Use it for the website list and for redirects and extra domains.
- ActivityRow One entry in the "What we did" log: time, a small status icon, what happened and why. Stack rows in a card to show the last few days of backups, updates and scans.
- StatusChecklist A card that lists the health checks of one website, each with a tick and a short result. It sits in the right column of the website page.
- BrowserPreview A simple browser window with an address bar around a screenshot or any content. Use it to show which website a page is about, or to preview a restore point or a staging copy.
- BackupsCard The last few backups of a website, each with a restore button, plus a link to the full list. The card adapts to its own width: wide, it shows icons and sizes; narrow, it stacks like the mobile design.
- SecurityCard A card for one protection feature: icon, title, a status chip, what we do, an optional setting and one action. The design uses it for the nightly virus scan.
- QuickLinks A row of plain links with icon, title, subtitle and chevron. The start screen uses it under the product cards for contracts, account settings and payment methods.