Skip to content

The Premium Kit

The Premium Kit is the set of components every template is built from. It sits on top of Velocity’s free components: its cards, fields, buttons and sections are Velocity’s own, restyled, so the kit follows your theme, both colour modes and every language you add.

The whole kit ships inside every template, whichever one you start from:

Path in a siteWhat it is
src/components/premium/The components, and a README.md describing each one
src/styles/premium.cssShared kit styles and skins
src/components/premium/kit.jsonThe kit version, used by pnpm kit:update
scripts/kit-update.mjsThe kit:update command

The same kit is at the top of the Premium repository in kit/, with its changelog.

ComponentWhat it is
BandVelocity’s Band with a skin: tone, width, padding, background, photo with scrim
PageHeroInner-page opening band with the page’s h1 and an aside photo slot
CtaPanelVelocity’s CtaBand as a panel: brand, slate or photo
NewsletterBandNewsletter strip above the footer
TestimonialsReviews as a spotlight, cards, wall, people or marquee
FaqVelocity’s Faq, one open at a time, with FAQPage structured data
StepsVelocity’s Steps as a list, a row or large numbers
HoursTableOpening hours with live open/closed status and today highlighted
OpenStatusThe live “open now” line
PricingTablePlans with a monthly/annual switch and a seat calculator
CompareTablePlan comparison with grouped rows and a sticky header
FeatureBentoBento grid of feature cards with demos that play on scroll, hover and focus
ShowcaseGallery of work with pointer zoom, a featured item and captions
RatingStars with half values
CommandPalette⌘K palette with grouped links and actions
FilterGridA floating filter and sort bar over a grid
LookupSearch lookup for long lists
Saved listsWishlists and saved items kept in the browser, with heart buttons
LightboxPhoto viewer
HotspotsPins over a photo
StepFormMulti-step forms for bookings, quotes and enquiries
CounterA number field with minus and plus buttons
ActionBarMobile bottom action bar
CodeBlock, CodeTabsHighlighted code with a copy button; code in tabs
MotionScroll reveals and numbers that count up
MarqueeSelf-scrolling row with pause
SpotlightA glow and lit border that follow the pointer
SocialLinksSocial icons

Each component’s props are typed and documented at the top of its file. The quickest example of one in use is a template that uses it: search the Premium repository, for example grep -rn "premium/PricingTable" ..

Restyle the kit the way you restyle Velocity. Don’t edit kit files to change how they look: pnpm kit:update leaves edited files alone, so they stop getting fixes.

  • Theme tokens. Kit components read Velocity’s --color-* tokens, so they follow your theme and light, dark and inverted sections automatically. See Design System.
  • Kit tokens. Set these on :root in your stylesheet: --kit-heading-font, --kit-heading-weight, --kit-heading-tracking, --kit-accent-text, --kit-radius, --kit-band-max, --kit-band-wide-max, --kit-band-gutter, --kit-ease, --kit-spotlight-color. Component tokens (newsletter, bento, showcase, marquee, reveal motion) are listed in src/styles/premium.css.
  • Skins. Band, PageHero and NewsletterBand take a skin prop, a class prefix your stylesheet styles: skin="site" makes a brand band use .site-band-brand and a background .site-bg-<name>.
  • Class props. eyebrowClass, titleClass, legendClass and similar props put your own type classes on headings.
  • Shared skins for Velocity components live in src/styles/premium.css: kit-choice turns Radio variant="card" into an option card, and kit-newsletter puts the button inside the field of Velocity’s NewsletterForm.