Skip to content
Sign inJoin waitlist

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.

  • 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; md is 810 and lg 1200.
  • 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, SplitLayout gap, FactList grid, RichText width, SectionIntro titleClassName, capClassName and labelGap, LoadSpinner className) 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.
  • 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 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)
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.

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

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.

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