Lookis design system — Next.js
Content-free building blocks of the Lookis 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,border-line,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,SplitLayoutgap,FactListgrid,RichTextwidth,SectionIntrotitleClassName,capClassNameandlabelGap,LoadSpinnerclassName) 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 ease-s0 and ease-s2, the form easing, the ticker and spinner 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 Framer springs S0, S2 and SL for Motion, and the timings of the hovers, the hero’s words, the slideshow, the name ticker and the portfolio filter |
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 | text, the black buttons and the Submit button, label dots, filled arrow circles |
line |
#ECECEC | Line | dividers, card and field borders, the line under the header |
paper |
#FAFAFA | White | the page, the header, the footer card, text on photos, the white button |
spinner |
#999999 | (the Loading component’s own) | the ring of LoadSpinner |
error |
#FF2244 | (the form button’s own) | the Submit button’s error label, a required field’s asterisk |
error-fill |
rgb(255 34 68 / 0.15) | (the form button’s own) | the Submit button’s fill after a failed send |
Translucent blacks are opacity modifiers on ink: Black 80 = ink/80 (roles, answers, prices, a section label),
Black 60 = ink/60 (the footer’s column labels), Black 50 = ink/50 (question numbers, a focused field’s border, the
Submit button’s hover), Black 30 = ink/30 (outlined circles and pills, placeholders), Black 20 = ink/20 (the
slideshow’s arrows), Black 02 = ink/2 (the cards’ fill: facts, awards, services, the contact form).
Corners are 10px (rounded-[10px]: photos, project frames, cards, gallery tiles, the hero), 4px on the form fields, the
Submit button, the service rows’ photos and the testimonial portraits, and round on buttons, pills and arrow circles.
Text styles
Section titled “Text styles”Named as in Framer. Inter is one variable font with an optical-size axis, pinned to 14 in every style (Framer’s “Inter”, the text cut). Weight 400 and no letter spacing; Display 01 is weight 500.
| Token | Framer name | Phone / tablet (md) / desktop (lg) |
Line height | Used for |
|---|---|---|---|---|
text.display |
Display 01 | 60 / 100 / 150 | 1 | the hero’s name ticker |
text.h1 |
Heading 1 | 30 / 40 / 54 | 1.1 | page titles |
text.h1Small |
Heading 1 (Small) | 24 / 26 / 28 | 1.2 | the hero’s introduction |
text.h2 |
Heading 2 | 28 / 38 / 48 | 1.1 | section titles, the big numbers |
text.h3 |
Heading 3 | 26 / 30 / 36 | 1.1 | About’s block titles, the contact card’s title |
text.h4 |
Heading 4 | 22 / 26 / 30 | 1.2 | a service’s price row, the 404’s “404” |
text.h5 |
Heading 5 | 20 / 24 / 28 | 1.2 | card and row titles, questions, the footer’s “Let’s Connect” |
text.h6 |
Heading 6 | 20 / 22 / 24 | 1.2 | quotes, award titles, numbered rows |
text.big |
Big Paragraph | 18 | 1.4 | leads, descriptions, rich text, prices, the footer’s links |
text.paragraph |
Medium Paragraph | 16 | 1.4 | card text, roles, small print |
text.menu |
Menu | 16 | 1.2 | the header’s links and clock, button labels |
text.label |
Label | 12, upper case | 1.2 | the labels with a dot above section titles |
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 10 / 20 / 30 |
sectionPadding |
vertical padding 40 / 60 / 80 |
sectionGap |
gap between the blocks of a section 50 |
splitPadding |
the two-column pages’ section: 20 / 30 / 30 on top, 40 / 50 / 50 below |
The content runs the full width (Framer’s “Inner” has no maximum); SplitLayout caps its row at 1728. The header
sticks to the top, 70 tall on phones and 95 from tablets up, with a 1px Line under it that scrolls away.
Motion
Section titled “Motion”The template has no scroll, appear or page transitions; the hero’s words are the only load animation.
| Spring | Token | Values | Used by |
|---|---|---|---|
| S0 | spring |
no bounce, 0.4 s | nearly every variant change: buttons and links, the phone menu, the hamburger, Collapse, the service rows dimming, WordAppear; the default of every Motion element (MotionProvider) |
| S2 | springSoft |
bounce 0.2, 0.4 s | FaqList (the row’s height), the portfolio cards moving after a filter, the footer links dimming |
| SL | slideSpring |
stiffness 200, damping 40, mass 1 (about 1.35 s) | TestimonialSlider’s step |
| Timing | Token | Value | Used by |
|---|---|---|---|
| Second hover stage | hoverDelay |
500 ms | MenuLink, MenuTab, ArrowLink (the solid underline, the arrow’s turn) |
| Word stagger | wordStagger |
0.05 s | WordAppear |
| Slide interval | slideInterval |
4000 ms | TestimonialSlider |
| Name ticker speed | nameTickerSpeed |
30 px/s | the hero’s Ticker |
| Filter delay | filterDelay |
420 ms | Portfolio’s filter: the cards move this long after the tab |
The easing and animation tokens of theme.css (Tailwind utilities ease-s0, animate-turn …):
| Token | Holds |
|---|---|
--ease-s0 |
Spring S0 as a linear() curve, run over 400 ms (duration-400): ProjectCard’s hover, ServiceList’s dimming |
--ease-s2 |
Spring S2 as a linear() curve (a slight overshoot), over 400 ms: Gallery tiles, the arrow circles of ServiceRow, ServiceCard, AwardRow and FaqList, the footer links |
--ease-form |
cubic-bezier(0.44, 0, 0.56, 1): the SubmitButton’s fills (0.2 s) and the LoadSpinner fade (0.3 s) |
--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 Primary: a pill (8 / 16) with the label in Menu 16 that rolls up to a second copy on hover (S0); the colours stay. A link with href (an external one opens in a new tab), otherwise a <button> |
tone (black default, white over a photo), href, type, onClick |
Home (hero, About, projects), About, a service page, Showcase, 404, Footer |
| actions | RollingLabel |
the label roll on its own: two copies 10 apart, the column rolls up 29px on hover | variants (the parent’s hover stages) |
inside Button, MenuLink, MenuTab |
| actions | MenuLink |
Framer Button/Menu: Menu 16 over 10px, in the text colour; hover rolls the label and grows a faint underline, a solid one 0.5 s later | href, current (aria-current only), onClick |
Header, the social links (Home hero, About, Contact) |
| actions | MenuTab |
Button/Menu as a filter tab: a <button> with aria-pressed; the active one is at 50% with the solid underline |
active, onClick |
Portfolio |
| actions | ArrowLink |
Framer Secondary: the label and a 14px arrow; hover grows the underlines and turns the arrow 45° 0.5 s later | href |
Home hero, 404 |
| brand | Logo |
the “Daniel Mercer” wordmark as inline SVG in the text colour, a link home; 62 wide on phones, 72 from tablets | href, label (the link’s name), onClick |
Header |
| icons | Icon |
a Phosphor icon as inline SVG in the text colour (arrow-up-right, plus, in icons/paths.ts) |
name (IconName), className (the size; 14px when left out), label |
inside ArrowLink, ServiceRow, ServiceCard, AwardRow, FaqList |
| motion | Collapse |
a box that grows from nothing to its height and back (S0), hiding closed content from the keyboard and screen readers | open, id (the button’s aria-controls) |
— (no Lookis page uses it yet) |
| cards | ProjectCard |
Framer Card/Project: a 565 : 600 photo; on desktop hover the frame shrinks 14px and a blurred cover with corner marks fades in over the title and summary; on tablets and phones the cover always shows | data (ProjectCardData: href, title, summary, image), sizes |
Home, Portfolio, a project (related projects) |
| cards | ServiceRow, ServiceList |
Framer Service With Image: photo, title, text, price pill and arrow circle in one row on desktop, a column on tablets and phones; ServiceList sets the rows between Line dividers and dims the others on hover |
data (ServiceRowData: href, title, text, price, image); list: items |
Home |
| cards | ServiceCard, ServiceCardList |
Framer Service No Image: a Black 02 card with the title, text and price pill, and an arrow circle that fills on desktop hover | data (ServiceCardData: href, title, text, price); list: items |
Services, a service page (Other Services) |
| cards | TestimonialCard |
Framer Card/Testimonial: the quote (Heading 6) and the client — portrait (80px, 40px above the name on phones), name, role | data (TestimonialCardData: quote, name, role, photo) |
inside TestimonialSlider |
| cards | AwardRow |
Framer Card/Award: a Black 02 card link with the year, an arrow circle that fills on hover (S2), the title and who gave it | data (AwardRowData: year, title, by, href), titleAs |
About |
| data | FactList |
Framer Number cards: Black 02 boxes, two columns from tablets, with the number (Heading 2), the label and an optional line | items (FactData), grid (a whole class) |
Home, About (without lines) |
| data | NumberList |
Framer Misc/Number Text: rows numbered 01, 02 … between Line dividers, in Heading 6; an empty entry drops out without renumbering | items (strings) |
a service page (Perfect for, What’s Included) |
| patterns | RichText |
CMS rich text in Big Paragraph: headings, paragraphs with italic and line breaks, bulleted and numbered lists | blocks (RichTextBlock), headings (h2 or h3 style), width (a whole class) |
a project (Overview), a service page |
| patterns | Ticker |
Framer Ticker: items moving left forever; the pointer slows it to a stop unless slowOnHover is false; still for reduced motion |
speed (px a second), gapClassName, copies, slowOnHover, label |
Home hero (the name) |
| patterns | TestimonialSlider |
Framer Slideshow/Testimonial: one quote at a time, the next one peeking in; moves every 4 s (SL), loops, waits off screen; two arrows | items (TestimonialCardData), label, previousLabel, nextLabel |
Home, Services, a service page |
| patterns | Gallery |
Framer Misc/Gallery: square photos in 5 / 4 / 2 columns, each a link; hover shrinks the photo to 90% (S2); children sits over the centre |
images, href, children |
Showcase (above the footer on every page) |
| patterns | WordAppear |
Framer “appear by word, on mount”: each word rises 10px out of a 10px blur, 0.05 s apart, once | text, className (the text style) |
Home hero |
| patterns | LoadOnScroll, LoadSpinner |
Framer “load on scroll”: the first pageSize blocks and a spinner that asks for the next page within 500px of the screen; every block is in the page for crawlers and without JavaScript. LoadSpinner is the ring on its own |
items, pageSize, label; spinner: label, onNear, className (a whole class) |
Portfolio (the spinner; LoadOnScroll itself is not used by a page) |
| patterns | FaqList |
Framer Card/Question list: numbered questions between Line dividers, each opening on its own; the circle fills and the plus turns into a cross (S2) | items (FaqItem: question, answer) |
Services |
| navigation | Hamburger |
Framer Button/Hamburger, 24 × 16: two lines that meet (between) and then cross into an X (open); the header times the steps |
phase (HamburgerPhase), onClick, label, controls |
Header (phones) |
| layout | Section |
a page section: gutters, vertical padding, the content across the full width, clipped like Framer’s sections. Also exports sectionGutters, sectionPadding, sectionGap |
padding, gap (whole class strings), innerClassName, id, as, label |
every page section except the Home hero |
| layout | SectionLabel |
Framer Label: a 6px square dot and the label in Label 12, Black 80; light is White, over a photo |
light |
SectionIntro; About, Contact, Services, a service page |
| layout | SectionIntro |
Framer Title Section: the label, the title (Heading 2), an optional lead and an optional action | label, title, lead, action, align (left, center, center-md), light, as, titleClassName, leadClassName, capClassName, labelGap |
most sections |
| layout | SplitLayout |
Framer’s two-column page shell: the page photo on the left (sticky from tablets), the blocks on the right. Also exports splitPadding |
image, preload, gap (a whole class) |
About, Services, a service page, Contact, a project |
| 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 |
| forms | FieldControl, FormField, fieldSurface |
Framer form input: a White field with a 1px Line border drawn inside, 4px corners; focus turns the border Black 50. FieldControl is the control alone, named through label for assistive technology (the contact form’s fields); FormField adds a visible label with a red asterisk on a required field; fieldSurface is the class string |
name, label, type (text, email, tel, url, date, select, textarea), placeholder, required, autoComplete, defaultValue, options, className (the grid placement) |
Contact (FieldControl); FormField is for a form with visible labels |
| forms | SubmitButton |
Framer Submit (Default, Loading, Success, Error, Disabled), 40 tall: Black, Black 50 on hover, a White ring while sending, red on a pale red fill after a failure | status (FormStatus), label, successLabel, errorLabel, disabled |
inside Form |
| forms | honeypotField, FormAction, FormState |
shared by Form and the server action (a plain module, so server code can import it) |
— | src/lib/actions-contact.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 | — | 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 projects, the services …) 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.