VelvetKit by KitForge
VelvetKit by KitForge
Esc

Guides

Getting started Install the gem, set it up and add your first component. Build with AI Give coding agents the kit's context: llms.txt, docs/velvetkit.md and a Claude Code skill. Namespacing Put the components under any module, like Kit:: or Admin::. Theming and dark mode Colour tokens, corner radius and dark mode: retheme every component from one file. Lookbook Browse every preview, and run Lookbook in your app. Building forms Rails forms with VelvetKit: bind fields to a model, show its errors, and two live examples.

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.

Image

UI::Image

An image with consistent sizing and corner radius.

bin/rails generate velvetkit:add image
Also adds
Nothing else
Stimulus
None, it's server-rendered
Installs
Nothing

Examples

Radii

Icon none
Icon sm
Icon md
Icon lg
Icon xl
Icon full

Sizing

Icon width: 48px
Icon width: 96px
Icon width: 160px

API

Arguments 
UI::Image.new(src:, rounded: :sm, width: nil, height: nil, alt: nil, loading: :lazy, class: nil, **html_attrs)

Notes

UI::Image — asset-backed <img> with radius tokens and lazy loading. Replaces Velvet::Image, which wrapped every image in a Velvet::Box and passed `width:`/`height:` to that wrapper as inline styles — so the div was sized and the image itself was not. Here the dimensions land on the <img>. Usage: <%= render(UI::Image.new(src: "logo.png", rounded: :lg, width: "100px")) %>