Catchup design system — Astro
Content-free building blocks of the Catchup template, mirrored from the Framer components (the same names, props and classes
as the Next.js version). Import a component by its path (import Button from "../design-system/components/actions/Button.astro");
there is no barrel. Components never import src/content — sections pass data in through props.
Conventions
Section titled “Conventions”- Tokens, not raw values.
text.h2,bg-ink,text-body,bg-accent,tween,spring— never a hex or a font size typed into a component, and a value used twice becomes a token. Keep class names standard (bg-<color>,md:,lg:). Phone is the default;mdis 810 andlg1200. The one exception: Motion animates values, not the theme’s variables, so a colour that Motion tweens (ServiceCard’s panel,MetaTag’s fill) is written as its hex, with the token’s name beside it. - No content imports. A component takes its data through props; sections map content with
src/lib/to-ui.ts. No copy lives in a component (the only strings are the form’s fallbacks: “Submit”, “Thank you”, “Something went wrong”). cnonly joins class names. It does not merge Tailwind classes: two classes for the same property and variant are decided by their order in the generated CSS, not by the call. Where a default has to change it is a prop that takes a whole class string (Sectionpadding,gapandwidth,SectionIntrotitleClassand its four widths,TestimonialCardsize,RichTextwidthandlist,TickergapClass) or another variant.- Positioning belongs to the caller. A component does not place itself (no
absolute, offsets, margins or grid placement of its own); the caller adds them throughclass(LoadSpinnerover the bottom of the blog grid, aFormFieldspanning two columns). A defaultrelativecan beat a caller’sabsolute, because the order in the CSS decides, not the call. - State and motion are scripts, not framework islands. A component with state writes its markup in the state it starts
in (the rest look inline, as Motion’s server render writes it) and calls an
init*()function from its own<script>; the function lives inscripts/(or insrc/components/site/for the header), takes no arguments and finds its elements bydata-*attributes (see Scripts). Everything animates throughplay()(utils/play.ts), which does what the Next.jsMotionProviderdoes: reduced motion makes moves jump while fades still play, and a part without a transition of its own runs spring S0. - One component per file. What a
.tsxexported beside its component is its own file here:MetaTag.astroandRollingLabel.astro(Button.tsx),SectionLabel.astro(SectionIntro.tsx),FieldControl.astroandforms/field.ts(FormField.tsx),layout/section.ts(Section.tsx),actions/button.ts(the tones). - Framer first. A deliberate refinement is written in the component’s leading comment and, in the maker’s repository, in the spec’s Deviations.
Tokens
Section titled “Tokens”| File | Holds |
|---|---|
theme.css |
The colours, the breakpoints (md 810, lg 1200), the font variable (font-sans is Manrope), Framer’s tweens T1 and T4 as ease-t1 and ease-t4, the springs S0 and S2 as the CSS curves ease-s0 and ease-s2, the form easing, the ticker and spinner animations with their keyframes, the page background and text colour |
tokens/text.ts |
The 16 text styles (text.h2 …), per breakpoint |
tokens/motion.ts |
Framer’s tweens T1, T4 and T4d and springs S0 and S2 for Motion, the appear offset and threshold, the title’s word stagger and the on-load delays, the ticker speeds, the hero’s slide interval, the counter’s step and the Home intro’s timings |
utils/cn.ts, utils/href.ts |
cn; isExternalHref and externalLinkProps (http(s) links open in a new tab, mailto and tel do not) |
utils/image.ts |
image(src): the imported file of a /images/<file> path (src/assets/images); imageUrl, isRemote, remoteWidths for a CMS image; imageWidths |
utils/motion.ts, utils/play.ts |
motionStates(rest, hover) for data-motion, styleOf(state) for the rest look inline; play(), Motion’s animate() with the reduced-motion split and spring S0 by default |
Colours
Section titled “Colours”| Token | Value | Framer style | Used for |
|---|---|---|---|
ink |
#000000 | Black | headings and text, the black buttons and cards, the footer card, the Submit button |
body |
#444A46 | Body | paragraphs on light backgrounds: leads, card text, roles, the rich text’s surroundings |
accent |
#7CE3AC | Accent | the mint buttons, the post’s category pill, the work cards’ arrow disc, the check discs, the Meta tag’s hover |
orange |
#FF7E5D | Orange | the orange number card on Home, the rich text’s and the contact links’ hover |
soft |
#DADADA | Soft Grey | placeholders and quiet fills (defined in Framer; no component uses it yet) |
page |
#F5F5F5 | Background | the page |
white |
#FFFFFF | White | cards and panels, text on photos and on black |
spinner |
#999999 | (the Loading component’s own) | the ring of LoadSpinner |
error |
#FF2244 | (the form button’s own) | the Submit button’s error label |
error-fill |
rgb(255 34 68 / 0.15) | (the form button’s own) | the Submit button’s fill after a failed send |
ink-hover |
rgb(51 51 51 / 0.85) | (the form button’s own) | the Submit button’s fill on hover |
ink-pressed |
#333333 | (the form button’s own) | the Submit button’s fill while pressed |
Translucent colours are opacity modifiers: Black 80 = ink/80 (the dark number card), Black 50 = ink/50 (the award
years, a work’s detail labels), Black 30 = ink/30 (placeholders, the hero’s veil, the gradients), Black 20 = ink/20
(dividers, a field’s bottom line, the carousel’s arrows), Black 05 = ink/5 (the pricing switch’s track), White 20 =
white/20 (the footer’s line, the hero’s glass buttons).
Corners are 10px (rounded-[10px]: photos, cards, panels) and round on buttons, tags, chips and discs.
Text styles
Section titled “Text styles”Named as in Framer. Everything is Manrope (one variable font, the Astro Fonts API), with no letter spacing except Subtitle. The display and heading styles scale per breakpoint, all at line height 1.2; the paragraph styles, Menu, Tiny and Subtitle are the same everywhere.
| Token | Framer name | Phone / tablet (md) / desktop (lg) |
Line height · weight | Used for |
|---|---|---|---|---|
text.display |
Display 1 | 42 / 52 / 62 | 1.2 · 600 | the Home hero’s title |
text.h1 |
Heading 1 | 40 / 46 / 54 | 1.2 · 600 | page titles |
text.h2 |
Heading 2 | 32 / 38 / 44 | 1.2 · 600 | section titles |
text.h3 |
Heading 3 | 28 / 32 / 36 | 1.2 · 500 | the numbers’ units, the legal and post headings |
text.h4 |
Heading 4 | 24 / 26 / 28 | 1.2 · 500 | the leads under the inner pages’ titles |
text.h5 |
Heading 5 | 20 / 22 / 24 | 1.2 · 500 | card titles, the logo row’s title |
text.h6 |
Heading 6 | 18 / 19 / 20 | 1.2 · 500 | the numbers’ captions, post card titles |
text.huge |
Huge | 40 / 46 / 54 | 1.2 · 500 | the counters |
text.big |
Big Paragraph | 18 | 1.4 · 400 | leads, the rich text of a project or service |
text.paragraph |
Medium Paragraph | 16 | 1.4 · 400 | body text, card text, the footer links, form labels |
text.small |
Small Paragraph | 14 | 1.4 · 400 | small print |
text.menu |
Menu | 16 | 1.2 · 500 | the header’s links, button and chip labels |
text.tiny |
Tiny | 12 | 1.2 · 400 | tags, the post’s category and date, client roles |
text.subtitle |
Subtitle | 14, upper case, 3% letter spacing | 1.2 · 400 | the labels before section titles and over the footer columns |
text.caption |
Subtitle (as typed) | 14, 3% letter spacing | 1.2 · 400 | the captions over a post’s date and category and a legal page’s date |
Spacing
Section titled “Spacing”Section sets the page’s rhythm; its constants are exported for the few blocks that lay out their own box.
| Constant | Phone / tablet / desktop |
|---|---|
sectionGutters |
side padding 15 / 20 / 30 |
sectionPadding |
vertical padding 60 / 80 / 100 |
sectionGap |
gap between the blocks of a section 60 / 80 / 100 |
The content is centred and capped at 1440 (Framer’s “Inner”; Section width); the header, the hero and the footer use
1728. The header is fixed over the page, 60 tall on phones, 90 on tablets and 100 on desktops; inner pages start with
HeaderSpacer (src/components/sections/HeaderSpacer.astro).
Motion
Section titled “Motion”Every block below the hero appears on scroll (Appear), the inner pages’ titles appear word by word (WordAppear) and
the blocks under them rise on load (Rise). There is no page transition, no parallax and no custom cursor.
| Framer | Token | Values | Used by |
|---|---|---|---|
| T1 | tweenAppear |
tween 1 s, cubic-bezier(0.59, 0.25, 0.12, 1.17) (overshoots about 3%) | Appear, Rise, WordAppear, the Home intro |
| T4 | tween |
tween 0.4 s, cubic-bezier(0.44, 0, 0.56, 1) | the card hovers (ServiceCard, WorkCard, PostCard), NavLink’s underline, Hamburger |
| T4d | tweenDelayed |
T4 after 0.2 s | the fixed header’s fade, the phone menu opening |
| S0 | spring |
no bounce, 0.4 s | the button arrow turn, MetaTag’s fill; the default of play() and of a part without data-transition |
| — | transitions.motion |
Motion’s own default (a stiff spring for x, y and rotate that overshoots; 0.3 s for colours) | the label roll of Button and MetaTag (the Next.js RollingLabel passes transition={undefined}, which replaces S0) |
| S2 | springSoft |
bounce 0.2, 0.4 s | LinkColumn (the roll and the dimming), a work’s detail links |
| Timing | Token | Value | Used by |
|---|---|---|---|
| Appear offset | appearOffset |
18 px | Appear: how far a block rises |
| Appear threshold | appearThreshold |
0.5 | Appear and LoadSpinner: half of it in view |
| Word stagger | wordStagger |
0.05 s | WordAppear |
| Intro lines | introDelay |
0.2 s | Rise under a page title (the lead) |
| Load rise | loadRiseDelay |
0.15 s | Rise (the default: the blocks under the title, the big photo) |
| Logo ticker | logoTickerSpeed |
20 px/s | the clients’ logos on Home |
| Slow ticker | slowTickerSpeed |
15 px/s | the faces on Home, the testimonial rows |
| Hero interval | heroInterval |
6000 ms | the Home hero’s slideshow on tablets and phones |
| Counter step | counterStep |
5 ms | Counter |
| Home intro | intro |
start 100, step 300, hold 1000 ms, cover 0.3 s | the Home intro’s photos, logo and black cover |
The easing and animation tokens of theme.css (Tailwind utilities ease-t4, animate-turn …):
| Token | Holds |
|---|---|
--ease-t1 |
T1’s curve, for a CSS transition |
--ease-t4 |
T4’s curve: the award rows and the team cards on About |
--ease-s0 |
Spring S0 as a linear() curve, run over 400 ms (duration-400) |
--ease-s2 |
Spring S2 as a linear() curve (a slight overshoot), over 400 ms: IconLink’s arrow, ChoiceChips, the pricing switch |
--ease-form |
cubic-bezier(0.44, 0, 0.56, 1): the SubmitButton’s fills (0.2 s) and the LoadSpinner fade (0.3 s) |
--animate-ticker |
the Ticker belt, one copy’s width (--ticker-period); each Ticker sets its duration inline |
--animate-turn |
one turn a second: the spinners of SubmitButton and LoadSpinner |
Components
Section titled “Components”| Group | Component | What it is | Props that matter | Used in |
|---|---|---|---|---|
| actions | Button |
Framer Button/Primary: a pill (10 / 16) with the label in Menu 16 that rolls up on hover (S0) and a 20px disc whose arrow turns 45°; arrow={false} is Secondary (the label only). A link with href (an external one opens in a new tab), otherwise a <button> |
tone (black default, accent, white), arrow, href, type, onClick |
Header, Footer, most Home sections, About, Services, a service, Works, a work, 404 |
| actions | MetaTag |
Framer Meta: the small black tag (Tiny 12) with a service’s name; hover turns it mint and rolls the label (S0) | href |
inside WorkCard |
| actions | RollingLabel |
Framer Flip on its own: two copies 10 apart in a clipping box; a hovered Motion parent rolls the column up one line and the gap | lineHeight (19.2 default), transition (a name of transitions) |
inside Button, MetaTag, LinkColumn; a work’s detail links |
| actions | NavLink |
Framer Button/Menu: a header link (Menu 16) with a 1px underline that grows from the left on hover (T4) and snaps back on leave | href, current (aria-current only) |
Header |
| actions | IconLink |
Framer Secondary “with icon”: the label (Medium Paragraph) and a 16px arrow at half opacity that brightens and nudges 2px right on hover (S2) | href (mailto, tel and sites get a plain <a>) |
Contact |
| brand | Logo |
the Catchup wordmark as inline SVG (176 × 30) in the text colour; the caller sets the size | title (names it; decorative without), class |
Header, Footer, Home (intro, numbers, CTA), About |
| icons | Icon |
a Phosphor icon as inline SVG in the text colour (arrow-up-right, arrow-up, arrow-right, check, star, in icons/paths.ts) |
name (IconName), class (the size; 14px when left out), label |
inside Button, WorkCard, IconLink, TestimonialCard, CheckList; Home, About |
| motion | Appear |
Framer’s scroll-appear: the block waits at opacity 0 and 18px low and rises with T1 once half of it is in view, once | as (div, li, article) |
every block below the hero |
| motion | Rise |
Framer’s on-load rise: fades in while rising 7px with T1, delay after load (LoadRise 0.15 s, IntroLines 0.2 s) |
delay, as (div, p) |
the inner pages’ titles, Contact, the blog, a post |
| cards | ServiceCard |
Framer Card/Service: a square photo at 105% and a white panel with the title and text; hover brings the photo to 100% and turns the panel black (T4) | data (ServiceCardData: href, title, text, image) |
Home, a service (More Services) |
| cards | WorkCard |
Framer Card/Work: a white card with the photo over (desktop), beside (tablet) or above (phone) the service tags, title, summary and a mint arrow disc; desktop hover grows the photo to 105% and turns the arrow (T4) | data (WorkCardData: href, title, summary, image, tags) |
Home, Works, a work (Other works) |
| cards | TestimonialCard |
Framer Card/Testimonial: a white 300 × 300 card with the stars, the quote and the client (round photo, name, role) | data (TestimonialCardData: quote, name, role, photo, rating), size (a whole class) |
Home, a service’s pricing |
| cards | PostCard |
Framer Card/Post: the photo at 105% (100% on hover, T4), the category pill and date, the title (Heading 6) and a two-line excerpt; one link | data (PostCardData: href, title, excerpt, category, date, dateTime, image), titleAs |
Home, Blog, a post (More Blog) |
| navigation | Hamburger |
Framer Button/Hamburger: the word and three 1px lines; open, the word reads closeLabel and the lines cross into an X (T4) |
label, closeLabel; setHamburger(button, open) in scripts/hamburger.ts switches it |
Header (phones) |
| navigation | LinkColumn |
Framer footer links: Medium Paragraph labels 10 apart; hovering one rolls its label and dims the others to 50% (S2) | items (LinkColumnItem), direction (column, row) |
Footer |
| data | Counter |
Framer’s Number counter: counts from start to end, one step every 5 ms, once it is in view; served with the final number |
start, end, decimals, class (the text style) |
Home, About |
| patterns | CheckList |
Framer Fill rows: a 22px mint disc with a check before each line | items (strings) |
Services, a service, its pricing |
| patterns | RichText |
CMS rich text: headings, paragraphs with bold, italic, links and line breaks, quotes, bulleted and numbered lists; links underlined, Orange on hover | blocks (RichTextBlock), headings (h2, h3), body (big, paragraph), list, width (whole classes) |
a post, a legal page |
| patterns | Ticker |
Framer Ticker: items moving sideways forever with faded edges; still for reduced motion | speed (px a second), gapClass, direction, copies, pauseOnHover, label |
Home (logos, faces, testimonials) |
| patterns | WordAppear |
Framer TitleWords: each word rises 10px out of a 7px blur, 0.05 s apart (T1), on load | text, delay |
the inner pages’ titles |
| patterns | LoadSpinner |
Framer Loading: a 20px ring turning once a second in a 40 × 40 box, fading in while half of it is in view | label, class, data-*; watchSpinner(box) in scripts/load-spinner.ts for a spinner added later |
Blog (over the bottom of the grid) |
| layout | Section |
a page section: gutters, vertical padding, the content centred and capped, clipped like Framer’s sections. Also exports sectionGutters, sectionPadding, sectionGap |
padding, gap, width (whole class strings), innerClass, id, as, label |
every page section except the logo row |
| layout | SectionLabel |
Framer Subtitle: the label in Subtitle 14 with a 40px line before it, or under it (underline) |
underline, light |
SectionIntro; a service, its pricing, a work |
| layout | SectionIntro |
Framer Title Section: the label and title (Heading 2) with a lead and an optional action; split puts the lead right on desktop, center centres everything |
label, title, lead, slot action, align (split, center), as, titleClass, titleWidth, tabletTitleWidth, leadWidth, tabletLeadWidth |
most Home and About sections |
| forms | Form |
a form that sends its fields and shows its progress on the Submit button: a spinner, then Thank you and the fields reset (or a redirect), or an error and the fields keep what was typed; a honeypot field. It posts to endpoint (a form service, a webhook or the site’s own /api/forms route) or, without one, runs a demo (src/lib/forms/README.md) |
name (contact), subject, endpoint, hidden, submitLabel, successLabel, errorLabel, redirectTo, demo, submitClass, actionClass + slot after |
Contact |
| forms | FieldControl, FormField, fieldSurface |
Framer form input: no box, a 1px Black 20 line at the bottom that turns Black on focus; text, e-mail, phone, address, date, a select with a chevron or a text area. FormField adds the visible label 15 above; fieldSurface is the class string |
name, label, type, placeholder, required, autoComplete, defaultValue, options, class (the grid placement) |
Contact (FormField) |
| forms | ChoiceChips |
Framer Button/Option over a radio group: outlined pills at half opacity; the checked one turns black (S2) | id (names the label; the Next.js useId()), name, label, options, required |
Contact (Services) |
| forms | SubmitButton |
Framer form button (Default, Loading, Success, Error, Disabled): a Black pill 40 tall, a White ring while sending, red on a pale red fill after a failure | status (FormStatus), label, successLabel, errorLabel, disabled |
inside Form |
| forms | honeypotField |
the name of the hidden field bots fill in (forms/form-state.ts, shared by Form and the server route) |
— | scripts/form.ts, src/lib/forms/deliver.ts |
| media | FillImage |
an image that fills its positioned parent (next/image fill): a /images/<file> path resized to WebP for sizes, or a CMS URL |
src, alt, sizes, priority, class (object-cover), data-* |
every photo |
| utils | CurrentYear |
the visitor’s current year: the page ships the build year and a tiny script swaps in the current one | — | Footer |
Internal pieces: patterns/RichTextBlock, patterns/RichTextInline.
Page sections (the hero, the works, the services …) live in src/components/sections/; the header and footer in
src/components/site/.
Scripts
Section titled “Scripts”Every script is a scripts/<name>.ts that exports init*() functions without arguments (the HTML edition is generated
from this version, bundles src/design-system/scripts and src/components/site only, and calls each of them; helpers with
arguments have other names). A component calls its function from its own <script>; each function marks what it has
processed (data-*-ready), so calling it twice does nothing.
| File | Function | What it does |
|---|---|---|
hover.ts |
initHover() |
plays the data-motion states of every data-hover element on hover (data-transition, data-transition-out; called by the layout) |
appear.ts |
initAppear() |
data-appear: view (Appear), tall (TallAppear), rise (Rise), word (WordAppear) |
nav-link.ts |
initNavLinks() |
NavLink’s underline |
link-column.ts |
initLinkColumns() |
LinkColumn: the roll and the dimming |
hamburger.ts |
setHamburger() |
the Hamburger’s open or closed look and aria-expanded (the header calls it) |
counter.ts |
initCounters() |
Counter |
ticker.ts |
initTickers() |
Ticker: measures one copy, stops under the pointer with pauseOnHover |
load-spinner.ts |
initLoadSpinners(), watchSpinner() |
LoadSpinner’s ring fading in and out |
form.ts |
initForms() |
Form: send, the Submit states, reset |
current-year.ts |
initCurrentYear() |
CurrentYear |
home-intro.ts |
initHomeIntro() |
Home’s intro loader (src/components/sections/HomeIntro.astro) |
hero-slideshow.ts |
initHeroSlideshows() |
Home’s hero slides (HomeHero.astro) |
testimonial-carousel.ts |
initTestimonialCarousels() |
Home’s testimonial carousel on tablets and phones (HomeTestimonials.astro) |
../../components/site/header.ts |
initHeader() |
the phone menu of each bar, Home’s fixed bar |
New component: put it in the right group and add it to the tables; new interactivity: a script as above.