Skip to content
Sign inJoin waitlist

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.

  • 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; md is 810 and lg 1200. (Motion animates colours as values, so Button, PlusMinus and TeamCard repeat the hex of Green, White or Soft Grey in their variants; keep them in step with theme.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”).
  • 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 and gap, RichText width, LoadSpinner className, ScrollSpyList gap, 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 through className. 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.
  • 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.
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)
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.

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

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

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.

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.