Skip to content
Sign inJoin waitlist

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.

  • 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; md is 810 and lg 1200. 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”).
  • cn only 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 (Section padding, gap and width, SectionIntro titleClassName and its four widths, TestimonialCard size, RichText width and list, Ticker gapClassName) 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 through className (LoadSpinner over the bottom of the blog grid, a FormField spanning two columns). A default relative can beat a caller’s absolute, 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 in src/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.
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)
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.

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

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).

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
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.