Metuo design system — Next.js
Content-free building blocks of the Metuo 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-green,text-grey,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. (Motion animates colours as values, soButton,PlusMinusandTeamCardrepeat the hex of Green, White or Soft Grey in their variants; keep them in step withtheme.css.) - 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 (Sectionpaddingandgap,RichTextwidth,LoadSpinnerclassName,ScrollSpyListgap,imageClassName) 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. 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. - Load animations run in CSS (
animate-appear,animate-zoom-in,animate-word-in): they start on the first paint and a page without scripts still shows everything. Reduced motion drops the rises, zooms and scroll movements and keeps the fades. - 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), the spring curves, the tweens’ curves, the load animations with their keyframes, the page background and text colour |
tokens/text.ts |
The 12 text styles (text.h2 …), per breakpoint |
tokens/motion.ts |
The Motion transitions: spring (S0), springSoft (S2), cardTween (TT) |
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 | Hex | Framer style | Used for |
|---|---|---|---|
green |
#2F3724 | Green | headings and text on light, the dark buttons and cards, number bubbles, the plus box, the page’s text colour |
black |
#000000 | Black | text typed into a field; the base of Black 30 / 10 / 5 |
grey |
#707070 | Grey | leads, descriptions, meta, field labels, list dots |
brown |
#AE8C73 | Brown | the hero’s second button (No Icon) |
orange |
#F98B31 | Orange | the button hover fill, link hovers, the stars, “(32% off)” |
soft-grey |
#B4B4B4 | Soft Grey | the pricing switch when off, an open row’s minus box, the solid header’s menu button |
background |
#FCFBF6 | Background | the page, the header once solid, text over photos, the bio panel |
white |
#FFFFFF | White | cards, rows, light buttons, the switch’s dot |
pressed |
#333333 | (the form’s own) | the Submit button while pressed |
error |
#FF2244 | (the form’s own) | the Submit button’s error label, a failed field’s hairline and message; error/15 is the failed button’s fill |
spinner |
#999999 | (Framer’s Loading) | the ring of LoadSpinner |
Translucent colours are opacity modifiers on a token: Black 30 = black/30 (placeholders, a focused field’s hairline, the
middle of the photo veils), Black 10 = black/10 (the footer’s hairline), Black 05 = black/5 (field fills and hairlines,
the checkbox), White 10 = white/10 (the hero’s hairline), White 05 = white/5 (the header’s pill and menu button over a
photo, behind an 8px blur).
Gradients: the photo veil of the page titles, the post’s photo and the founder quote runs transparent → Black 30 at 50% → Black; the booking section’s band fades from Background to White in its first 5%.
Corners are 10px on cards, rows and photos; 5px on buttons, fields, the plus box, the arrow box, the hamburger and the portraits; 4px on the checkbox; round on bubbles, dots, avatars and the switch.
Text styles
Section titled “Text styles”Named as in Framer. Everything is Manrope at −0.03em. Headings are weight 500 at line height 1.1 (Heading 6: 1.2), the paragraph styles 400 at 1.2 (Menu 500, Button 600) and the same size everywhere.
| Token | Framer name | Phone / tablet (md) / desktop (lg) |
Used for |
|---|---|---|---|
text.display |
Display 1 | 52 / 58 / 64 | the Home hero’s title, the page titles over a photo |
text.h1 |
Heading 1 | 42 / 48 / 54 | Contact’s and a post’s titles, prices, the figures |
text.h2 |
Heading 2 | 32 / 36 / 40 | section titles |
text.h3 |
Heading 3 | 28 / 32 / 36 | the founder quote, rich-text headings |
text.h4 |
Heading 4 | 24 / 26 / 28 | a plan’s name, a story’s headline on Home, the form’s title |
text.h5 |
Heading 5 | 20 / 19 / 24 | the page titles’ lead, the Testimonial page’s headlines (the tablet size is smaller than the phone’s, as measured in Framer) |
text.h6 |
Heading 6 | 18 / 19 / 20 | row, card and question titles, quotes on story cards |
text.paragraph |
Medium Paragraph | 16 | leads, descriptions, rich text, the footer’s links |
text.small |
Small Paragraph | 14 | section labels, field labels, meta, number bubbles |
text.tiny |
Tiny | 12 | the hero’s foot line, a plan’s “Perfect for” note |
text.menu |
Menu | 14 (500) | the header’s links |
text.button |
Button | 14 (600) | button labels, the Submit button |
Spacing
Section titled “Spacing”Section sets the page’s rhythm; its constants are exported for a block that lays out its own box.
| Constant | Phone / tablet / desktop |
|---|---|
sectionGutters |
side padding 15 / 20 / 30 |
sectionPadding |
vertical padding 60 / 80 / 100 |
The gap between a section’s blocks is set per section (gap). The content is at most 1200 wide (Framer’s “Inner”); on wider
screens it stays centred. The fixed header is 65 tall on phones and 82 from tablets up; the root layout pads <main> by
that, except on pages whose first section carries data-header-cover (Home, About, Service, Testimonial, Blog: the header
runs transparent over their photo).
Motion
Section titled “Motion”Framer’s motion vocabulary, measured on the live site (qa/interactions-home.md, qa/interactions-pages.md), and the
token that carries each:
| Name | Definition | Token | Used by |
|---|---|---|---|
| S0 | spring, no bounce, 0.4 s | spring; CSS ease-spring-a (--ease-spring-a) |
nearly every state change: Button, the links, the header, Hamburger, rows opening, the price roll, the avatar raise; MotionProvider’s default |
| S2 | spring, bounce 0.2, 0.4 s (1–3% overshoot) | springSoft; CSS ease-spring-b |
PostCard’s photo, SocialList, PlusMinus’s turn, PricingSwitch, the ScrollSpyList points |
| TA | tween 0.6 s, cubic-bezier(0.73, 0, 0.33, 1), a delay per element |
animate-appear (--ease-appear), distance --appear-y |
the page-load rise of the header’s parts (18px) and the Home hero’s eyebrow and buttons (35px) |
| TZ | tween 0.8 s after 0.5 s, cubic-bezier(0.79, 0.01, 0.15, 0.99) |
animate-zoom-in (--ease-zoom) |
the Home hero’s photo growing from 20% on load |
| TW | per word: spring S0, 0.05 s apart | animate-word-in (WordEffect) |
the Home hero’s title, lead and foot lines |
| TP | tween 0.4 s, cubic-bezier(0.44, 0, 0.56, 1) |
ease-form, 400 ms |
StoryCards’ portrait strip |
| TT | tween 0.4 s, cubic-bezier(0.5, 0, 0.88, 0.77) (an ease-in) |
cardTween; CSS --ease-in-card |
TeamCard’s button and bio panel |
| SP | spring, stiffness 500, damping 60, mass 1, smoothing a scroll-linked value | ScrollTransform smooth (inline) |
Home About’s small photo zoom |
| TS | tween 0.2 s, cubic-bezier(0.44, 0, 0.56, 1) |
ease-form, 200 ms |
SubmitButton’s hover and pressed fills |
| TL | tween 0.3 s, the same curve | ease-form, 300 ms |
LoadSpinner’s fade |
Other theme tokens: --animate-turn (one turn a second: the spinners of SubmitButton and LoadSpinner). Scroll effects
are linear in scroll: ScrollTransform (Framer Scroll Transform, In View: progress 0 when the block’s top meets the bottom of
the screen, 1 when its bottom does) and Parallax (half the page’s scroll). There are no page transitions, no count-ups and
no idle loops except the video and the phone ticker of ScrollSpyList.
Components
Section titled “Components”| Group | Component | What it is | Props that matter | Used in |
|---|---|---|---|---|
| actions | Button |
Framer Button/Primary: a 36px box with 5px corners, the label (Button) and a 26px arrow box; hover (S0) fills the box with Orange from below, rolls the label up to a second copy and slides a new arrow in. A link with href (an external one opens in a new tab), otherwise a <button> |
tone (green Primary, white Secondary, brown No Icon — no arrow box), href, type, onClick |
Header (and the phone menu), Home hero, Home About, Home Service, About Vision, the CTA band, StoryCards, PriceCard, FAQ support card, Footer, 404 |
| actions | RollingText |
Framer “Flip”: a label that rolls up to a second copy under a hovered Motion parent | roll (the distance), gap, second (the second copy’s class) |
inside MenuLink, FooterLink |
| actions | MenuLink |
Framer Navigation / Link: a 27px link whose Menu label rolls up 21.8px on hover; the colour comes from the caller | href, current (aria-current only), onEnter (the header’s sliding pill), onClick |
Header |
| actions | FooterLink |
Framer “Simple”: a Medium Paragraph link and a 14px arrow; hover rolls the label to an Orange copy and swaps the arrow | href, sameTab (other sites otherwise open in a new tab; mailto and tel never do) |
Footer |
| actions | PlusMinus |
Framer Button/Plus Min: a 24px box — a White plus on Green when closed, a Green minus on Soft Grey when open (the turn S2, the colours S0); decorative | open |
inside AccordionItem, ServiceList |
| actions | PricingSwitch |
Framer Button/Toogle between its labels: a 64 × 30 pill, Soft Grey with the dot left when off, Green with the dot right when on (S2); only the pill is a control (role="switch") |
on, onChange, offLabel, onLabel, note (the Orange discount), label (the switch’s name) |
inside PricingPlans |
| brand | Logo |
the leaf mark and the wordmark as inline SVG in the text colour, 92 × 25 | href, label (the link’s name), onClick, className (the colour) |
Header, Footer |
| icons | Icon |
a Phosphor icon as inline SVG in the text colour; arrow-right and star-fill (icons/paths.ts); the social marks are image files |
name (IconName), className (the size; 14px when left out), label (an image with a name; decorative without) |
inside Button, FooterLink, ClientRatings |
| motion | WordEffect |
Framer text effect on load (TW): every word comes from nothing, blurred 10px and 10px lower, a CSS animation; the words keep their spaces | as (h1, h2, p, span, div), text, delay, stagger (0.05) |
Home hero |
| motion | ScrollTransform |
Framer Scroll Transform (In View): y and/or scale move linearly from the first value to the second while the block scrolls in; smooth follows with spring SP; reduced motion: the end values |
y, scale ([from, to]), smooth, className |
Home About (photo zoom), the founder quote (photo), Footer (rising into place), inside VideoBand |
| motion | Parallax |
Framer Parallax (speed 50): the block moves down by half the page’s scroll; reduced motion: still | className |
Home hero, the page titles, a post’s photo |
| motion | Collapse |
the part of a row that opens and closes: its height goes from 0 to auto with spring S0; closed content is hidden from the keyboard and screen readers | open, id (the button’s aria-controls) |
none at the moment (the rows animate their own height); the style guide |
| navigation | Hamburger |
the phone menu button: a 24px box with three 12px lines; open (S0) it turns Green and the outer lines cross into a White X | open, light (over a photo: White 5% behind a blur, White lines; otherwise Soft Grey with Green lines), onClick, label, controls |
Header (phones) |
| navigation | SocialList |
Framer Part/Sosial List: 24px social icons 30 apart; hovering one lifts it 5px and dims the others to 30% (S2); each link is named by its label, same tab as in Framer | items (label, href, icon) |
the CTA band, the booking section |
| layout | Section |
a page section: gutters, vertical padding, content at most 1200 wide, clipped like Framer’s sections. Also exports sectionGutters, sectionPadding |
padding, gap (whole class strings), innerClassName, className, id, as, label (a name when there is no heading), headerSwitch (the header turns solid when this section reaches it) |
nearly every page section, Header, Footer, 404; the style guide |
| layout | SectionLabel |
Framer “Fit”: “//” and the label in Small Paragraph, Grey, 5 apart | children |
the site’s SectionIntro, Home About, Home Service, Home Why, About values, the Journal intro, a post |
| cards | PostCard |
Framer Card/Post: the whole card is a link; a 367:244 photo at 105% that zooms out to 100% on hover (S2), the category, a dot and the date, then the title on one line | post (PostCardData: href, title, category, date, dateTime, image), headingLevel (3), className |
Home (Journal), Blog list, a post (related posts) |
| cards | PriceCard |
Framer Card/Price: the plan’s name and description, the price (rolling between the monthly and yearly one, S0), “Includes:” with a dotted list, the note and the button; White, or Green when featured |
plan (PriceCardData), yearly |
inside PricingPlans |
| cards | ServiceCard |
Framer Card/Service “No Close”: an always-open White card — the number bubble and the name, the big photo over two small ones, the summary and the values | item (ServiceListItem), number |
the Service page |
| cards | TeamCard |
Framer Team: a photo with a square “+” that shows the bio on a light panel (TT); below puts “Name — Role” under a 2:3 photo, side reads it upwards left of the photo |
name, role, photo, bio, toggleLabel (the button’s name), layout (below, side), sizes, className (the height of side) |
Home About (side), About team |
| cards | TestimonialCard |
Framer Card/Testimonial: a full-height story on the page colour — the headline, the quote, the outcomes, the portrait with name and role, and the big photo from tablets up | story (TestimonialCardData), headingLevel (h2, h3), className |
the Testimonial page |
| data | FactList |
Framer Fact Number: an optional title over the figures (Heading 1 over a Grey label) — four columns on desktop, two on tablets, one on phones; plain text | title, facts (value, label) |
Home (under the stories), the Service page |
| data | PointItem |
Framer Misc/Icon Text: a Green dot, a title and the Grey line under it | title, text |
Home About (“What we believe”), inside ScrollSpyList |
| data | ClientRatings |
Framer Client Ratings: overlapping round client photos (hover raises one 20px, S0), the Green “65+” bubble, the rating over five Orange stars (one image with a name) | avatars, more, rating, starsLabel |
the CTA band, the booking section |
| patterns | Accordion, AccordionItem |
Framer Part/Step List: White rows with a number bubble, the title (Heading 6, in a heading with a <button aria-expanded>) and a PlusMinus; exactly one open; the answer fades in as the row grows (S0). AccordionItem is one row |
items (title, text), defaultOpen (0); item: title, number, open, onToggle, headingLevel |
Home (Our process) |
| patterns | FaqList |
Framer Faq: the same rows without numbers, each opening on its own; the whole card toggles | items (question, answer), defaultOpen ([0]) |
the FAQ section (Home, Service, Contact, posts) |
| patterns | PricingPlans |
Framer Part/Price List: the switch 50 above the plans (a column on phones, two columns on tablets with the second plan spanning both rows, three on desktop) | plans (PriceCardData[]), labels (monthly, yearly, discount, toggle) |
the pricing section (Home, Service) |
| patterns | ServiceList |
Framer Part/Service List: White rows with a number, the name and a PlusMinus, one open at a time (S0); on desktop the open service’s photos sit in a 400 × 500 column at the left, on tablets and phones in the row |
items (ServiceListItem), footer (the button under the rows) |
Home (How we can help) |
| patterns | ScrollSpyList |
Framer’s “Why choose us” / “Our values” layout: from tablets up the intro and points stay pinned while the photos scroll by, a point lighting up (S2) as its photo passes the middle of the screen; phones show every point lit and the photos in a draggable ticker (10px/s) | intro, items, images, gap, imageClassName, listClassName |
Home (Why choose us), About (values) |
| patterns | StoryCards |
Framer Part/Testimonial on Home: one pinned card that turns to the next story as each spacer passes the middle of the screen; the portrait strip slides (TP) | stories (StoryCardData[]), cta |
Home (Client stories) |
| patterns | LoadOnScroll, LoadSpinner |
Framer “load on scroll”: the first pageSize blocks in the caller’s layout and a spinner over the bottom edge that asks for the next page within 500px of the screen; every block is in the page, hidden, for crawlers and without JavaScript. LoadSpinner is the ring on its own (fades in, TL, when half of it shows) |
items, pageSize, label, className (the list layout); spinner: label, onNear, className (a whole class) |
the Blog list |
| patterns | RichText |
CMS rich text: Medium Paragraph in Grey, headings in Heading 3 (an <h2> in the outline), bold and italic runs, line breaks, bulleted and numbered lists |
blocks (RichTextBlock[]), width (a whole class, default 900) |
a post, the legal pages |
| media | VideoBand |
Framer Video: a full-width 16:9 muted loop that grows from 60% and rises from 160px above while it scrolls in; loads when first in view, plays only on screen; decorative | src |
the video section (Home, About) |
| 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 Something went wrong and the fields keep what was typed. Before sending it checks the fields (required, e-mail) and focuses the first that fails; a honeypot field; it posts without JavaScript too | action, submitLabel, successLabel, errorLabel, redirectTo, submitClassName |
the booking section (Home, Service, Contact) |
| forms | FormField, FieldControl, CheckboxGroup, fieldSurface |
Framer form field: a Small Paragraph Grey label 10 above the control, the field’s error under it when the check fails; FieldControl is the control alone (text, email, tel, url, date, time, textarea), CheckboxGroup the list of checkboxes (type: "checkboxes"), fieldSurface the class string of a control |
name, label, type, placeholder, required, autoComplete, defaultValue, options, error, compact (38 tall), className (the grid placement) |
the booking form |
| forms | SubmitButton |
Framer Submit (Default, Loading, Success, Error): 37 tall, White on Green; hover Orange, pressed Pressed (TS) | status (idle, pending, success, error), label, successLabel, errorLabel |
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-book.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, so the parts of a hovered control never overshoot | — | 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 services, the pricing …) 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.