Skip to content
Sign inJoin waitlist

Balancee design system (Astro)

Content-free building blocks of the Balancee template: .astro components with the same names, props and classes as the Next.js version (../../../nextjs/src/design-system). Components never import page copy; sections pass it in (src/lib/to-ui.ts maps content items to card props). 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.

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, the Inter fallback font
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
Group Components
brand Logo, Wordmark
actions Button (four tones, label roll in CSS), MenuLink, PlusMinus, NewsletterForm
navigation Hamburger
layout Section, SectionTitle, Breadcrumbs, PageTitle
data Chip, Stars, Rating, Fact, TimelineStep
cards ServiceCard, PostCard, CaseCard, StepCard, StepCardPlain, ValueCard, DetailCard, FigureCard, PillarCard, TeamCard, TestimonialDark, TestimonialLight
patterns AwardRow, CaseAccordion, RichText, LoadOnScroll, LoadSpinner
media FillImage, SizedImage, LogoTicker, VideoPlayer
forms Form, FormField, FieldControl, RadioGroup, CheckboxGroup, SubmitButton
motion, utils Collapse, CurrentYear

scripts/*.ts hold the interactions (accordion, collapse, forms, hamburger, load on scroll, logo ticker, newsletter, video player, current year). Each exports init*() with no arguments, called by the component’s own <script>; helpers that take arguments (setCollapse, setHamburger, setPlusMinus, animateHeight) have other names.

Standard Tailwind class names, 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 /style-guide, this table and spec/components.md.