Skip to content
Sign inJoin waitlist

Cerette design system — Next.js

Content-free building blocks of the Cerette 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-grey, bg-brown, tweenAppear, 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 (the Brown hover of Button Simple, ProjectCard, ServiceCard, FooterLink, ServicesSwitcher) 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, CtaBand height, Masonry gap, RichText width and list) 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 (Grain over a photo, 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 or state, so the style guide wraps those demos in src/app/style-guide/parts.tsx.
  • Effects start before hydration where Framer’s do. Framer’s optimized appears (E6, E4, LR) are CSS animations in theme.css; the effects Framer runs from hydration (TW, TL, TX, Appear) are Motion. Every element that waits for a script starts at opacity 0.001, so the root layout’s <noscript> rule shows it without JavaScript.
  • 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 variables (font-sans Plus Jakarta Sans, font-quote Marcellus, font-field Inter), the curves T1, TI and E (ease-t1, ease-ti, ease-e), the springs S0 and S2 as CSS curves (ease-s0, ease-s2), the form curve T02 (ease-form), the animations animate-turn, animate-hero-label / animate-hero-buttons (E6 / E4) and animate-load-rise (LR), each with a -fade version for reduced motion, the page background and text colour
tokens/text.ts The 14 text styles (text.h2 …), per breakpoint
tokens/motion.ts Framer’s motion for Motion: tweenAppear (T1), heroRise (E6 / E4), charAppear (TX), spring (S0), springSoft (S2), tweenIn (TI), titleWords (TW), introLines (TL), and appearOffset, appearStagger, cardZoom
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 button, the footer, the Submit button
grey #707070 Grey paragraphs, leads and captions on the page colour, labels, field labels
line #B4B4B4 Line dividers, the ruler’s ticks, the placeholders
brown #C36036 Brown the accent: the Primary button, the current link, the hover colours, icons, the logo’s mark
page #F5F1E5 Background the page
white #FFFFFF White cards and panels, text on photos and on Black
field rgb(187 187 187 / 0.25) Form Fill the fields’ fill (White while focused)
icon #999999 (the form input’s own) the select’s chevron
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

Translucent colours are opacity modifiers: ink/50 (the veil over the quote and CTA photos), line/50 (the lines between the award rows), ink/40 (a select’s disabled placeholder option). There are no rounded corners: photos, cards, buttons and fields are square; only the dots, the label’s ring, the avatars and the phone accordion’s circle are round.

Named as in Framer. Everything is Plus Jakarta Sans at −3% letter spacing (next/font, variable) except Quotes (Marcellus); the form’s fields and the Submit button’s result labels use Inter. The display, heading, number and quote styles scale per breakpoint; the paragraph styles, Menu and Tiny are the same everywhere.

Token Framer name Phone / tablet (md) / desktop (lg) Line height · weight Used for
text.display Display 1 50 / 100 / 120 1.1 · 600 the inner pages’ big titles (“Studio.”)
text.h1 Heading 1 40 / 48 / 56 1.2 · 600 the Home hero’s title, the names in the team picker
text.h2 Heading 2 30 / 36 / 42 1.2 · 600 section titles, the CTA’s title
text.h3 Heading 3 28 / 32 / 36 1.2 · 600 rich-text headings in posts and legal pages
text.h4 Heading 4 24 / 26 / 28 1.2 · 600 the switcher’s service titles, the About statement
text.h5 Heading 5 20 / 22 / 24 1.2 · 600 the figures’ units (+, %, y)
text.h6 Heading 6 18 / 19 / 20 1.2 · 600 card titles, the team names
text.number Number 52 / 62 / 94 1 · 600 the figures
text.big Big Paragraph 18 1.4 · 500 leads, the testimonial quote, the small text beside a page title
text.paragraph Medium Paragraph 16 1.4 · 500 body text, leads, the value cards’ text
text.small Small Paragraph 14 1.4 · 500 card text and meta, the footer links, field labels
text.menu Menu 12, upper case 1.1 · 600 nav links, button labels, the labels before section titles, dates
text.tiny Tiny 12 1.2 · 500 client roles, small captions
text.quote Quotes 20 / 19 / 24, Marcellus 1.2 · 400 the founder’s quote (Framer’s tablet size is smaller than the phone’s)

Section sets the page’s rhythm; its constants are exported for the few blocks that lay out their own box (CtaBand, QuoteBand, the hero, RulerRow).

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 / 60 / 80

The content is centred and capped at 1440 (Framer’s “Inner”; Section width). The header is fixed over the page; inner pages start their first section with pageTitleSpace (58 / 83, src/components/sections/PageTitle.tsx).

Every block below the Home hero appears on scroll (Appear); About and Projects run Framer’s title effects (TW, TL, LR); the other inner pages, a project and a post have no effects (the still props). There is no page transition, no parallax, no ticker, no counter and no custom cursor. Framer changes nothing for reduced motion; the port skips the movements (MotionProvider, motion-reduce:).

Framer Token Values Used by
T1 tweenAppear, --ease-t1 tween 1 s, cubic-bezier(0.59, 0.25, 0.12, 1.17) (overshoots about 2 %) Appear, and the rise of WordAppear, LineRise, Rise
E6 heroRise, animate-hero-label tween 0.6 s, cubic-bezier(0.79, 0.01, 0.15, 0.99) (--ease-e), after 0.2 s, from 50 px low the Home hero’s label
E4 heroRise, animate-hero-buttons as E6, 0.4 s the Home hero’s buttons
TX charAppear per character: spring without bounce, 0.2 s (title) / 0.3 s (text), 0.05 s apart from 0.1 s, out of a 10 px blur, 10 px low CharAppear
TW titleWords per word: T1, 0.05 s apart, out of a 7 px blur, 10 px low, from hydration WordAppear
TL introLines per line: T1 from 0.2 s, 0.05 s apart, 7 px low LineRise
LR animate-load-rise T1 after 0.15 s, 7 px low, all together, CSS from first paint Rise
S0 spring, --ease-s0 spring, bounce 0, 0.4 s the label rolls (RollingLabel), the button dots, PostCard’s zoom, the phone accordion’s height; the default of every Motion element (MotionProvider)
S2 springSoft, --ease-s2 spring, bounce 0.2, 0.4 s Hamburger, ServicesSwitcher’s titles and plus / minus, TeamPicker
TI tweenIn, --ease-ti tween 0.4 s ease in, cubic-bezier(0.5, 0, 0.88, 0.77) ProjectCard and ServiceCard hover
T02 --ease-form tween 0.2 s, cubic-bezier(0.44, 0, 0.56, 1) SubmitButton’s fills; LoadSpinner’s fade (0.3 s)
Timing Token Value Used by
Appear offset appearOffset 18 px Appear, ServicesSwitcher’s photo
Appear stagger appearStagger 0.1 s a step Appear order (the figures, the award photos)
Card zoom cardZoom 1.05 the photos of ProjectCard, ServiceCard, PostCard at rest
Spinner --animate-turn one turn a second, linear SubmitButton, LoadSpinner
Group Component What it is Props Used in
icons Icon a Phosphor icon as inline SVG in the text colour (arrow-up-right, arrow-up, arrow-right, check, star; light blueprint, crane-tower, users, kanban, windmill, lightbulb-filament; icons/paths.ts) name (IconName), className (the size; 14 px when left out), label inside Button, the cards; ValueCard
brand Logo the Cerette wordmark (110 × 25): the letters in the text colour, the mark Brown title (names it; decorative without), className (the width) Header, Footer
motion Appear Framer’s scroll-appear (T1, 18 px), once, as soon as the block enters the view as (div, li, article, p), half (wait for half of it), order (0.1 s a step) every block below the Home hero
motion Rise LR: rises 7 px with T1 after 0.15 s, a CSS animation from first paint as (div, p) PageTitle actions, the About and Projects photos
motion WordAppear TW: each word out of a 7 px blur, 10 px low, 0.05 s apart; the words are direct children of the aria-hidden span (what tools/qa/layout-diff/words.mjs reads) text, as (h1, p, span) PageTitle (animate)
motion LineRise TL: the lines rise 7 px from 0.2 s, 0.05 s apart (lines found after hydration) text, as (p, span) PageTitle (animate)
actions Button Framer Button/Primary: square, Menu 12 label, padding 15 / 30; the label rolls up on hover (S0). primary (Brown, a dot ring that shrinks and fills), black, white; simple is the label and a 12 px arrow that turn Brown, no box. A link with href (new tab when it leaves the site), otherwise a <button> tone (primary default, black, white, simple), href, type, onClick, disabled everywhere
actions RollingLabel Framer Flip: two copies in a clipping box; a hovered Motion parent rolls the column up one line lineHeight (13.2 default; 19.6 for Small Paragraph), variants, transition, rolledClassName inside Button, NavLink, FooterLink
actions NavLink Framer Button/Menu: a header link (Menu 12); hover rolls the label; the current page is Brown and doesn’t roll href, current, onClick Header
navigation Hamburger Framer Button/Hamburger: three 1 px lines that cross into an X (S2); a button with its state announced open, onClick, label, closeLabel, controls Header (phones)
navigation FooterLink Framer Button/Footer: a Small Paragraph link with a 6 px ring; hover rolls the label to a Brown copy and fills the ring Brown (S0) href, tone (white default, black) Footer
patterns RichText CMS rich text: headings (an <h2> in the outline, Black, 40 above), Grey paragraphs with bold, italic, links and line breaks, quotes, lists with the browser’s disc at 23 px; links underlined, Brown on hover blocks (RichTextBlock), headings (h2 default, h3), body (big default, paragraph), list (whole class, mt-5), width (whole class, max-w-[900px]) a post, a legal page
patterns LoadSpinner Framer Loading: the trigger under a list that loads on scroll, a 20 px ring in spinner turning once a second (SPIN) in a 40 × 40 box; the list loads its next page as the box nears the window and removes it after the last; the ring shows while half of it is in view (0.3 s fade, T02) label, ref, className Blog, About (the team cards)
patterns CharAppear TX: each character out of a 10 px blur, 0.05 s apart; plain text for screen readers text, as (h1, p), duration (0.3 default; 0.2 for the title) Home hero
patterns ServicesSwitcher Section/Services: desktop tabs and a card over the photo (which replays the appear on a switch), tablet tabs and a card, a phone accordion; one choice shared, all in the markup intro, items (ServiceSwitchItem), moreLabel Home
patterns TeamPicker Part/Team (desktops): rows (role and name in Heading 1) that pick a person on pointer enter, focus or click, the others at 50 % (S2); a sticky 35 % column (top 83) crossfading the cards items (TeamCardData), label About (desktops)
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 (section, div), label, headerSwitch (the section whose top turns the fixed header from transparent to the page colour: Home’s About) every page section
layout Label Framer Misc/Label: a 12 px ring with a 6 px dot, then the text in Menu 12 tone (grey default, black, white) TitleSection, the hero, sections
layout Ruler Framer Misc/Line: 30 / 20 / 10 ticks of 1 × 14 in Line over the content width; decorative className RulerRow
layout TitleSection Framer Title Section: the Grey label, Heading 2, an optional lead and action. split: on desktops the title (560) left, the lead (350) and the action right, stacked below 1200; center; stack label, title, lead, action, align (split default, center, stack), balance, leadBalance (always, compact) most sections
layout Masonry one / two / three columns dealt by position (i % columns), all three in the markup, hidden by breakpoint items, render, gap (whole class, gap-2.5) Home testimonials
media Grain the grain tile (/images/grain.png) drawn 128 px wide (Framer’s measured size), repeated at 50 %, overlay; the caller places it className Photo, QuoteBand, CtaBand
media Photo Framer Card/Image: a cover photo with optional grain; the caller sizes the box src, alt, sizes, grain, preload Home, About, a service, a post
data StatNumber a static figure (Number) with a Brown Heading 5 unit and a Small Grey caption value, suffix, label Home, About
data AwardTable Part/Award Table with Card/Award rows: the header, Line-at-50 % lines, the rows; the description under the award on phones labels (number, award, description), rows (AwardRow) Home, About
cards ProjectCard Card/Project Small / Landscape / Square: the photo at 105 %, the title, category / year, “View Project →” rolling in; hover TI (zoom out, Brown title) data (ProjectCardData), variant (small, landscape, square), actionLabel, sizes Home, Projects, a project
cards ServiceCard Framer’s “Simple” service card: the photo at 105 % (1.65 : 1), the title, two lines of text and “View Details →” rolling in; hover TI data (ServiceCardData), actionLabel, sizes, titleAs (h2 default, h3) Services
cards PostCard Card/Post: one link, the photo at 105 % (100 % on hover, S0), date • category, the title (Heading 6), a two-line excerpt data (PostCardData), sizes, titleAs (h3 default, h2) Home, Blog, a post
cards TestimonialCard Card/Testimonial: the quote (Big Paragraph), the client (38 px photo, name, role) and the Brown star with the rating; static data (TestimonialCardData, with ratingLabel for screen readers) Home
cards ValueCard Card/Value: a 32 px Brown light icon, the title and balanced text; the caller sets the height data (ValueCardData: icon is an IconName) Home, Services (HomeWhy)
cards TeamCard Card/Team Full: the portrait (0.7375 : 1, grain), the name (Heading 6), the role and a balanced description; static data (TeamCardData), sizes About (tablets, phones)
blocks QuoteBand Section/CEO Quotes: the photo with grain and a half-black veil, the quote (Quotes) beside a 2 px white rule, the person; renders its own <section> and appears on scroll data (QuoteBandData), still (no appear), half (wait for half of it in view: About) Home, About, Services (still)
blocks CtaBand Section/CTA: the photo with grain and a half-black veil, the title, the text and the action at the bottom; renders its own <section> and appears on scroll title, text, action, image, height (whole class; 676 / 864 / 800 by default), still (no appear), half (wait for half of it in view: About, Projects) CtaSection
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 InquiryForm
forms FieldControl, FormField, fieldSurface Framer’s form input: Form Fill (White while focused, at once), no border, padding 12, Inter 16 at 1.2, a Line placeholder; a line 43 tall, a select with a 16 px chevron in icon, or a text area at least 200 tall. FormField adds the Small Grey label 10 above; fieldSurface is the class string name, label, type (text, email, tel, url, date, select, textarea), placeholder, required, autoComplete, defaultValue, options, className InquiryForm
forms SubmitButton Framer Form button: Black, 43 tall, Menu 12 label; hover Brown, pressed Brown at 80 % (T02); a White ring while sending; “Thank you” (Inter SemiBold 14) on Black; “Something went wrong” in error on error-fill; disabled at half opacity status (FormStatus), label, successLabel, errorLabel, disabled inside Form
forms honeypotField, FormAction, FormState shared by Form and the server actions (a plain module, so server code can import it) — src/lib/actions-*.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 — 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 live in src/components/sections/, the header and footer in src/components/site/. The ones below pass design-system props through; the rest take only their content.

Section Props What they do
PageTitle (+ pageTitleSpace) title, aside, intro, actions, animate, introBalance the inner pages’ title block; animate runs TW / TL / LR (About, Projects)
CtaSection height, fit, still, half the closing CTA; fit is Framer’s “Fit” variant of the inner pages (462 / 454 / 516 with this copy), still drops the appear, half waits for half of it in view
QuoteSection content, still, half the founder’s quote; still on Services, half on About
RulerRow half, still the ruler between sections; half waits for half of it, still stands still
HomeWhy content, still “Why Cerette”; Services shows it still

New component: put it in the right group, export it from index.ts, add it to /style-guide and to this table.