Catchup design system — Next.js
Content-free building blocks of the Catchup template, mirrored from the Framer components. Import everything from
@/design-system; components never import @/content — sections pass data in through props. See them all together
at /style-guide (src/app/style-guide/): public, noindex, not in the sitemap and not linked from the site.
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,SectionIntrotitleClassNameand its four widths,TestimonialCardsize,RichTextwidthandlist,TickergapClassName) 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 throughclassName(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 make a client component (
"use client"on the first line). A server page cannot hand one a function, so the style guide wraps those demos insrc/app/style-guide/parts.tsx. - 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) |
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, next/font), 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/PageTitle.tsx).
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 label roll and arrow turn, MetaTag; the default of every Motion element (MotionProvider) |
| 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), variants, transition |
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), onClick |
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), className |
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), className (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) |
open, onClick, label, closeLabel, controls |
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, className (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), gapClassName, 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, ref, className |
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), innerClassName, 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, action, align (split, center), as, titleClassName, titleWidth, tabletTitleWidth, leadWidth, tabletLeadWidth |
most Home and About sections |
| forms | Form |
a form that posts to a server action 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 without JavaScript too | action, submitLabel, successLabel, errorLabel, redirectTo, submitClassName, after, actionClassName |
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, className (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) | 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, FormAction, FormState |
shared by Form and the server action (a plain module, so server code can import it) |
— | src/lib/actions-contact.ts, src/lib/forms/deliver.ts |
| providers | MotionProvider |
honours the visitor’s reduced-motion setting (transforms and layout animations are skipped, fades stay) and makes spring S0 the default transition of every Motion element that sets none of its own | — | the root layout |
| utils | CurrentYear |
the visitor’s current year, without a hydration mismatch | — | Footer |
actions/MotionLink.tsx (next/link that accepts Motion props) is internal to the design system and not exported.
Page sections (the hero, the works, the services …) live in src/components/sections/; the header and footer in
src/components/site/.
New component: put it in the right group, export it from index.ts, add it to /style-guide and to this table.