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.
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, 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 |
Components
Section titled “Components”| 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
Section titled “Scripts”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.