Semono design system — Next.js
Content-free building blocks of the Semono 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-soft,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. - 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,PageTitleleadClassName) 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. - 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 Inter), the spring easing curves, the animations with their keyframes, the page background and text colour |
tokens/text.ts |
The 13 text styles (text.h2 …), per breakpoint |
tokens/motion.ts |
The five Framer springs A–E, for Motion |
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 |
|---|---|---|---|
ink |
#000000 | Black | headings, the black buttons and cards, the footer, the plus mark |
soft |
#616161 | Soft Black | leads, descriptions, meta, labels, list dots |
grey |
#EBEBEB | Grey | hairlines, the page-title chip, field borders, the open row’s minus, the footer’s links |
lime |
#E4FE00 | Lime | the accent: buttons, label dots, chips, tags, arrow circles |
green |
#0F3D3A | Green | text and icons on Lime, the arrow circle’s hover fill |
background |
#F7F7F7 | Background | the page, the form fields, the header bar once it turns light |
white |
#FFFFFF | White | cards, white buttons, text over photos |
red |
#FF0000 | Red | the required asterisk, the error label of the Send button |
error-fill |
rgba(255, 34, 68, 0.15) | Red 15 | the Send button’s fill after a failed send (a pinker red than Red, so not an opacity modifier of it) |
spinner |
#999999 | (the Loading component’s own) | the ring of the loading spinner |
Translucent colours are opacity modifiers on a token: Black 50 = ink/50 (the cover over the photos of the Home hero, the
call-to-action band and the 404, a select’s placeholder), Black 25 = ink/25 (the veil over a video, a focused field’s border).
Corners are 5px (rounded-[5px]: buttons, cards, photos, form fields, the lime chips, the video), 3px on the grey chips
(a page title’s label, a position’s place and type), round on dots, arrow circles, avatars and the play button.
Text styles
Section titled “Text styles”Named as in Framer. Inter is one variable font with an optical-size axis, pinned per style: headings use size 32 (Framer’s “Inter Display”), every other style 14. Weight 500 (text in a field 400), letter spacing −0.03em (Menu and Button −0.04em), line height 1.1 for the headings and 1.2 for the rest.
| Token | Framer name | Phone / tablet (md) / desktop (lg) |
Used for |
|---|---|---|---|
text.display |
Display 1 | 48 / 59 / 74 | the Home hero’s title |
text.h1 |
Heading 1 | 42 / 48 / 54 | page titles, the big numbers |
text.h2 |
Heading 2 | 34 / 38 / 42 | section titles, post headings |
text.h3 |
Heading 3 | 28 / 32 / 36 | contact and FAQ titles, legal headings, the black card’s title |
text.h4 |
Heading 4 | 24 / 26 / 28 | the quote beside the services’ closing line, a story’s results |
text.h5 |
Heading 5 | 20 / 22 / 24 | results on cards, the video’s caption, the career sections’ titles |
text.h6 |
Heading 6 | 18 / 19 / 20 | card, row, tab and accordion titles |
text.big |
Big Paragraph | 18 | the hero’s lead, quotes on cards |
text.paragraph |
Medium Paragraph | 16 | leads, descriptions, rich text |
text.small |
Small Paragraph | 14 | labels, chips, card text, meta |
text.menu |
Menu | 16 | the header’s links |
text.button |
Button | 15 | button labels, links with an arrow |
text.tiny |
Tiny | 12 | roles, the footer’s taglines and legal links |
Spacing
Section titled “Spacing”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 50 / 60 / 80 |
The content is at most 1400 wide. The fixed header is 58 tall on phones and 82 from tablets up; the root layout pads
<main> by that (nothing on Home and the 404, whose first section carries data-header-cover).
Motion
Section titled “Motion”| Spring | Token | Values | Used by |
|---|---|---|---|
| A | spring |
no bounce, 0.4 s | every hover and look change: buttons, links, the header, accordion and collapse rows |
| B | springSoft |
bounce 0.2, 0.4 s | the hamburger lines, PlusMinus, the LinkedIn button, VideoCard, the process tabs’ fill |
| C | revealSpring, revealDistance (40 px) |
stiffness 200, damping 30, mass 1 | Reveal |
| D | wordSpring |
stiffness 200, damping 40, mass 1 | WordReveal |
| E | introSpring |
stiffness 250, damping 55, mass 2.9 | Intro, which runs in CSS (ease-spring-e): the constant records the numbers |
The easing and animation tokens of theme.css (Tailwind utilities ease-spring-a, animate-intro …):
| Token | Holds |
|---|---|
--ease-spring-a, -b, -e |
Springs A, B and E as linear() curves: A settles in 0.37 s without bounce, B overshoots slightly (0.36 s), E takes about a second |
--ease-row-hover |
cubic-bezier(0.5, 0, 0.88, 0.77), an ease-in: the ServiceRow hover (0.4 s) |
--ease-form |
cubic-bezier(0.44, 0, 0.56, 1): the SubmitButton’s colours (0.2 s) and the LoadSpinner fade (0.3 s) |
--ease-page-change |
cubic-bezier(0.73, 0, 0.33, 1): the page change (0.6 s each way, in globals.css) |
--animate-intro, --animate-intro-fade |
the page-load rise of 60 px (960 ms) and its fade-only version for reduced motion; the delay is set on the element |
--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 |
Components
Section titled “Components”| Group | Component | What it is | Props that matter | Used in |
|---|---|---|---|---|
| actions | Button |
Framer Button (Primary, Secondary, Small): a 5px box in Lime, White or Black; the label rolls up to a second copy on hover and, with arrow, a 17px arrow nudges 5px. A link with href (an external one opens in a new tab), otherwise a <button> |
tone (lime default, white, black), arrow, small (the header’s), href, type, onClick |
Header (also the phone menu), Home hero and CTA band, the Action blocks, 404, Careers rows, process tabs, Services process, other services, MoreCard, ActionQuote |
| actions | MenuLink |
Framer Button/Menu: a header link in the bar’s colour at 80% over a 1px line; hover goes to 100% and a solid line grows across | href, current (aria-current), stacked (the phone menu’s row, no hover), onClick |
Header |
| actions | ArrowLink |
Framer Button/Secondary: a label and an 18px lime circle with an arrow; hover turns the circle Green and slides the arrow out as a second one comes in | href (mailto, tel and http(s) give a plain <a>) |
ServiceRow (“Learn more”), Why Choose, Contact (e-mail, phone) |
| actions | FooterLink |
Framer Button/Secondary Small/White: a Grey link, Lime on hover, with a lime arrow sliding in at the right end | href, sameTab (other sites otherwise open in a new tab) |
Footer |
| actions | PlusMinus |
Framer Plus Min: the 24px round mark of an accordion row — a white plus on Black when closed, a Soft Black minus on Grey when open | open |
Accordion, FaqList, the process tabs on phones |
| brand | Logo |
the wordmark and its ™ as inline SVG in the text colour, 102 × 20 | href, label (the link’s name), compact (93 wide on phones), className (the colour, text-white) |
Header (compact), Footer (white), Process, the Action card |
| icons | Icon |
a Phosphor icon as inline SVG in the text colour; the 17 icons are in icons/paths.ts |
name (IconName), className (the size, size-5; 14px when left out), label (an image with a name; decorative without) |
inside Button, the links, PlusMinus, SectionLabel, IconCard, TeamCard, VideoCard; the footer’s taglines |
| motion | Reveal |
Framer block reveal: the block comes from 40px lower and from nothing, once, when it comes into view (spring C); useRevealed(ref, amount) is the trigger: the share amount of the block is on the screen, or the block covers that share of the screen when it is taller than it |
as (div, section, li, ul, p, span, article), delay, amount (the share of its height that must show) |
nearly every section |
| motion | WordReveal |
Framer text reveal: every word rises on its own, 0.05 s apart, once (spring D); screen readers get the text once | as (h1–h3, p, span, div), text, delay, stagger, amount (0.5) |
section titles, PageTitle, the career title, 404 |
| motion | Collapse |
the part of an accordion row that opens and closes: its height goes from 0 to auto with spring A; closed content is hidden from the keyboard and screen readers | open, id (the button’s aria-controls) |
Accordion, FaqList, the process tabs on phones |
| motion | Intro |
Framer page-load intro: the block rises 60px from nothing as the page paints (spring E, a CSS animation that needs no script); reduced motion fades only | as (div, h1, p, span), delay |
Home hero, Header |
| navigation | Hamburger |
the phone menu button, 24 × 18: three lines that become an X (spring B) | open, onClick, label, controls (the menu’s id) |
Header (phones) |
| layout | Section |
a page section: gutters, vertical padding, content at most 1400 wide, clipped like Framer’s sections. Also exports sectionGutters, sectionPadding, sectionGap |
padding, gap (whole class strings), innerClassName, className, id, as, label, headerSwitch |
every page section except the hero, the CTA band, the Action block, the article and the 404; the style guide |
| layout | SectionLabel |
Framer Label: a 20px lime circle with a bold asterisk and a Small Paragraph; light is the hero’s (a shield, Medium Paragraph in Background) |
light |
the title block of a section; the Home hero (light) |
| layout | PageTitle |
Framer Title Section: an optional grey chip, the page’s <h1> (its words rise) and a lead |
label, title, text, balance, leadClassName (a whole class) |
About, Blog, Careers, Contact, a service page, Services, Team, Testimonial |
| cards | ServiceRow |
Framer Service List row: the photo, a white card (number, title, text, “Learn more”) and a “What’s Included” card; on desktop hover turns the row White and zooms the photo | ServiceRowData (href, number, title, text, image, includedLabel, included, moreLabel), heading (h3; h2 under a page’s h1) |
Home, Services, a service page (other services) |
| cards | PostCard |
Framer Blog card: a 3:2 photo, a white card with the category chip, the date, the title and the excerpt (two lines each); the whole card is the link and hover settles the photo | PostCardData (href, title, excerpt, image, category, date, dateTime), heading, className |
Home, Blog, Testimonial (latest posts), a post (related posts) |
| cards | TestimonialCard |
Framer Testimonial card, 300 or 400 tall: the quote, the client (round photo, name, role, company logo) and two results | variant (logo, plain, results-below, results-above), quote, name, role, photo, logo with logoWidth and logoHeight, results |
Home and Services (the quote grid) |
| cards | IconCard |
Framer Card/Icon Text: a white card with a lime square holding a light icon and, at the bottom, a title and a line; it has no height of its own | icon, title, text, titleAs (h3, p), className (the height) |
Home (About), About (Mission), Careers |
| cards | TeamCard |
Framer Card/Team: a 2:3 portrait with a round LinkedIn button and a white name card | TeamCardData (name, role, photo, linkedin, linkedinLabel), nameAs (h3, h2), sizes, preload |
About, Team |
| cards | MoreCard |
Framer More: the black 2:3 card that ends the team grid, a text and a lime arrow button | text, link, title (the Team page’s heading) |
About, Team |
| media | VideoCard |
Framer Card/Video: a 16:9 poster under a 25% veil and a play button; a press plays the clip muted and looping in place (the file is only fetched then) | src, poster, label, caption |
Home (Services), About (Mission) |
| data | FactList |
Framer Fact Number: four numbers in a row (two by two on tablets), each over a line, a label and a description; they rise one after the other | items (FactData), amount |
Home, About, a service page |
| patterns | RichText |
CMS rich text: headings, paragraphs (with italic and line breaks), bulleted and numbered lists, nested | blocks, headings (h2 or h3 style), width (a whole class) |
a post, the legal pages |
| patterns | CardColumns |
Framer CMS list in Masonry: three columns on desktop, two on tablets, one on phones; the cards are dealt out from the left | items, shown (per layout), after |
Home, Blog, Testimonial (latest posts), a post (related posts) |
| patterns | Ticker |
Framer Ticker: items moving left forever, slowed to a stop by the pointer, still for reduced motion | speed (px a second), gapClassName, copies, label |
the client logos (Home, Services) |
| patterns | Accordion |
Framer accordion: white rows with a number, a title and a PlusMinus; one row open at a time |
items ({ title, content }), defaultOpen (0), titleAs |
Home (Why Choose) |
| patterns | FaqList |
Framer FAQ: the same rows, each opening on its own | items ({ question, answer }), defaultOpen ([0]), reveal |
Contact |
| patterns | LoadOnScroll, LoadSpinner |
Framer “load on scroll”: the first pageSize blocks, and a spinner under them 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 |
items, pageSize, label; spinner: label, onNear, className (a whole class) |
Services, Testimonial; the Blog list (the spinner) |
| patterns | ActionQuote |
Framer Details: a closing line with two buttons beside a client quote | text, primary, secondary, quote, delays |
Home (Services), About (Mission) |
| 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 |
Contact, a service page, a career page |
| forms | FormField, FieldControl, fieldSurface |
Framer form field: a label over a control, with a red asterisk on a required one; FieldControl is the control without the label, fieldSurface its class string |
name, label, type (text, email, tel, url, date, select, textarea), placeholder, required, autoComplete, defaultValue, options, className (the grid placement) |
the three forms |
| forms | SubmitButton |
Framer Submit (Default, Loading, Success, Error), 40 tall | 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-*.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 A the default transition of every Motion element that sets none of its own, so the parts of a hovered control (a label rolling, an arrow nudging) 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 process …) 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.