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.
Conventions
Section titled “Conventions”- 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;mdis 810 andlg1200. The one exception: Motion animates values, not the theme’s variables, so a colour that Motion tweens (the Brown hover ofButtonSimple,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”). 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,CtaBandheight,Masonrygap,RichTextwidthandlist) 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(Grainover a photo, 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 or state, so the style guide wraps those demos insrc/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.
Tokens
Section titled “Tokens”| 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) |
Colours
Section titled “Colours”| 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.
Text styles
Section titled “Text styles”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) |
Spacing
Section titled “Spacing”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).
Motion
Section titled “Motion”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 |
Components
Section titled “Components”| 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.
Sections with their own props
Section titled “Sections with their own props”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.