Balancee design system — Next.js
Content-free building blocks of the Balancee template. Import everything from @/design-system; components never import @/content
(sections map content with src/lib/to-ui.ts). The live catalog is /style-guide (public, noindex, not in the sitemap).
The spec of every component is ../../../spec/components.md; the measured tokens are ../../../spec/tokens.json.
Tokens
Section titled “Tokens”| File | Holds |
|---|---|
theme.css |
colours (ink, text, grey, line, soft, white, black, error), breakpoints md 810 and lg 1200 (phone is the default), ease-card, ease-spring (a CSS spring for the card hovers), the ticker and spinner animations |
tokens/text.ts |
text.h1…h6, paragraph, small, tiny, eyebrow, button (Phone / Tablet / Desktop sizes) |
tokens/motion.ts |
spring (bounce 0, 0.4 s) and springSoft for Motion |
Components
Section titled “Components”| Group | Component | What it is |
|---|---|---|
| brand | Wordmark, Logo |
“Balancee” as text in the logo’s boxes (139 x 25, 111 x 20, 166 x 30, hero 278 x 50) |
| actions | Button |
Black / White x Primary / Secondary (“black”, “black-link”, “white”, “white-link”); label roll, blur and arrow turn on hover (200 ms linear), CSS only |
| actions | MenuLink |
Header link: active pill, colour and growing line on hover |
| actions | PlusMinus |
Accordion button (46 / 36 / 26 round) |
| actions | NewsletterForm |
Footer subscribe box: field over a white button; server action in, states out |
| navigation | Hamburger |
Phone menu button (two lines that cross) |
| layout | Section |
Gutters 15 / 20 / 30, padding 60 / 80 / 100, content at most 1440 |
| layout | SectionTitle |
Eyebrow, title, text; centred (855 wide) or left |
| layout | Breadcrumbs, PageTitle |
“Home > Page”, h1 and a lead (inner pages) |
| data | Chip, Stars, Rating, Fact |
Labels, stars, the hero rating, the About figures |
| cards | ServiceCard, PostCard, CaseCard, StepCard, StepCardPlain, ValueCard, DetailCard |
Cards with the hover of Framer (spring padding changes, 105 % photo zoom) |
| cards | FigureCard, PillarCard, TeamCard |
About: the hero figures, the three pillars, the team card with its desktop hover (profile slides up) |
| data | TimelineStep |
About timeline entry (pill, line, dot, title) |
| patterns | AwardRow |
About awards row, white fill on desktop hover |
| cards | TestimonialDark, TestimonialLight |
Quote cards |
| patterns | CaseAccordion |
Case-study rows that open independently (Collapse, spring) |
| patterns | RichText, LoadOnScroll |
Kept for the inner pages (posts, legal, lists) |
| media | LogoTicker, VideoPlayer |
Marquee (phones: slideshow); loop / view / click video |
| forms | Form, FormField, RadioGroup, CheckboxGroup, SubmitButton |
The contact form: Soft fields (blue focus hairline), the radio list, a 240 x 40 Submit with its states (spinner, “Thank you”, red “Something went wrong”); Form checks the fields and takes a server action (src/lib/forms) |
| motion | Collapse |
Spring height animation, hidden when closed |
| providers | MotionProvider, CurrentYear |
Reduced motion, the visitor’s year |
Standard Tailwind class names (the registry prefixes tokens), no copy in components, links from routes, positioning belongs to the caller
(cn does not merge classes: pass whole class strings). New component: add it to index.ts, /style-guide, this table and spec/components.md.