Esc

Components

All components Every component, with search. Accordion Sections that expand and collapse, one at a time or several. Alert A highlighted message, optionally dismissible. Avatar A person's picture, with initials when there is none. Avatar group Overlapping avatars with a "+N" count for the rest. Badge A small status label. Banner A dismissible strip across the top of a page. Breadcrumb The path to the current page, collapsing long trails. Button Buttons in every variant and size, with icons and a loading state. Button to A button that submits a one-off form, like Rails' button_to. Card A bordered container with header, content and footer. Checkbox A checkbox with label, standalone or bound to a form builder. Collapsible A section that opens and closes under its trigger, like a branch of a nav tree. Data grid A sortable, filterable, server-paged table on AG Grid. Date picker A typed date field with a calendar, on Cally. Dialog A modal dialog on the native <dialog> element. Divider A horizontal or vertical rule, optionally labelled. Form field A label, hint and error message wired to any form control. Icon A Lucide icon. Image An image with consistent sizing and corner radius. Input A text field with label, hint and error message, standalone or with a form builder. Input group A text field with addons before or after it. Label A form label with a required marker. Link A link styled as text or as a button. Menu A dropdown menu with keyboard navigation. Pagination Page links for a long list, from a Pagy object. Password input A password field with a show/hide toggle. Popover Floating content anchored to a trigger. Radio group A set of radio buttons. Native select The browser's own select, styled closed; best for phones' system pickers. Select A styled dropdown with keyboard navigation and type-ahead, posting like a native select. Sheet A panel that slides in from an edge of the screen. Sidebar A collapsible application sidebar with groups and menus. Spinner A loading indicator. Switch An on/off toggle. Table A styled table with header, rows and caption. Table of contents An "On this page" list that follows the reader's scroll. Tabs Tabbed panels with keyboard navigation. Text Body text in set sizes, weights and tones. Textarea A multi-line text field with label, hint and error, that can grow with its text. Theme toggle A light/dark/system theme switcher. Tooltip A hint shown on hover and focus. Typography Headings, lead, muted, code and blockquote text styles.

Theming and dark mode

Components never name a colour. They use tokens such as bg-primary and rounded-md, so to retheme you change the token values, not the components.

Make it yours

Live

Move the sliders. Only the tokens change, and every component below follows.

New Draft
The active tab underline is the primary colour too.

Paste this at the end of velvetkit.css to keep it:

The colour tokens

They're defined in app/assets/tailwind/velvetkit.css, once for light and once under .dark. Switch the theme at the top of the page to see both sets.

--background
--foreground
--primary
--primary-foreground
--secondary
--muted
--muted-foreground
--accent
--destructive
--border
--input
--card
--popover
--sidebar

Dark mode

Dark mode is on when <html> has the dark class. Add the theme toggle to let people choose light, dark or system, and render its script in your layout's <head> so the page doesn't flash light before it goes dark:

app/views/layouts/application.html.erb
<head>
  <%= render "layouts/theme_script" %>
</head>
This toggle is the same one as in the header.

Fonts

The kit doesn't choose a typeface, so components use your body font. This site uses Inter.