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. File field A drag-and-drop file picker with a label, hint and error message, standalone or with a form builder. 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. Session tabs Browser-style tabs the user opens, renames, duplicates, reorders and closes. Sheet A panel that slides in from an edge of the screen. Sidebar A collapsible application sidebar with groups and menus. Skeleton A pulsing placeholder shown in a piece of content's shape while it loads. 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. Toast A stacked, auto-dismissing message, pushed from the client or a Turbo Stream. Tooltip A hint shown on hover and focus. Typography Headings, lead, muted, code and blockquote text styles.

File field

UI::FileField

A drag-and-drop file picker with a label, hint and error message, standalone or with a form builder.

bin/rails generate velvetkit:add file_field
Also adds
Label Form field Icon
Stimulus
ui--file-field
Installs
Nothing

Examples

With Error

Must be a PDF under 5MB

Multiple Files

Drop as many as you like

API

Arguments 
UI::FileField.new(multiple: false, accept: nil, label: nil, label_size: :default, label_weight: :medium, hint: nil, required: false, error: nil, disabled: false, form: nil, field: nil, class: nil, **html_attrs)

Notes

UI::FileField — a drag-and-drop dropzone over a native file input. The input itself is sr-only, not hidden: it stays in the accessibility tree and keyboard/native-picker behavior (Tab, Enter/Space, the OS file dialog) comes from the real <input type="file">, same as every other styled-native-control component here. The dropzone is a <label> around it, so clicking anywhere in it opens the picker without any JS, and the ui--file-field controller only adds what a label can't: drag-over highlighting and listing the chosen file names.