Compose Digi design system — Next.js
Reusable, content-free building blocks of the Compose Digi template. Import everything from @/design-system.
Components never import @/content; sections pass data in through props (mapped in src/lib/to-ui.ts).
Every token and component is shown in its states at /style-guide (noindex, not in the sitemap).
Tokens
Section titled “Tokens”| File | Holds |
|---|---|
theme.css |
Colours with Framer’s names — ink Black 13 #101010, ink-soft Black 10, charcoal Black 09, grey Black 08, silver Black 06, line Black 05, mist Black 04, surface Black 03, background White #FCFCFC, white #FFF, accent #B3FF00, axis (process chart), error #FF2244; breakpoints md 810, lg 1200; ease-form (0.2 s Submit fills); animate-ticker, animate-turn. ease-spring-a/b/c (S0 / S2 / SC as CSS curves) are defined but unused at the moment |
tokens/text.ts |
Framer’s text styles: display (Display 01), h1–h6, huge (Huge Text, Inter), big / paragraph / small (Big / Medium / Small Paragraph), menu (Menu 13, upper case) |
tokens/motion.ts |
spring (S0: bounce 0, 0.4 s), springSoft (S2: bounce 0.2, 0.4 s), springCard (SC: stiffness 500, damping 60), springPop (SP: stiffness 400, damping 30) — measured in ../../../qa/interactions-home.md and interactions-pages.md |
utils/ |
cn (joins classes, no Tailwind merge), isExternalHref, externalLinkProps |
Components
Section titled “Components”| Component | Framer | What it does · motion |
|---|---|---|
| Actions | ||
Button (primary · secondary · outline · icon) |
Button/Primary (Default/Primary, No Icon/Secondary, Default/Secondary, Icon Only/Primary) | 40 tall pill, link or <button>; hover rolls the label (S0) and turns the arrow 45° (S2); no colour change |
FlipText |
Misc/Flip Text | two copies of a label 10 apart, rolled up 25.6 px by a hovered parent (S0) |
TextLink |
Button/Secondary | Menu label + arrow; hover grows the underline from the left and nudges the arrow 4 px (S2), the line goes at once on leave; icon={null} = No Icon; #id scrolls smoothly |
ActionButton |
Button/Action | the footer’s two 62 px circles; hover slides them together and turns the arrow (SC) |
SocialButton, SocialList |
Button/Social, Misc/Social List | 32 px circle; hover / focus fills it Black 13 and grows it to show the network’s name (SC); opens in a new tab |
| Brand and icons | ||
Logo |
Logo | the mark and wordmark as a link home; the caller sizes it (127 × 40, 95 × 30) |
Icon |
Phosphor icons | icons/paths.ts, current text colour, 14 px unless sized |
| Navigation | ||
NavLink |
Button/Menu | 28 px pill; hover fills Black 06 (S2) and rolls the label (S0); the current page is lime with no hover |
Hamburger |
Button/Hamburger | Menu / Close label and two lines that cross into an X (S2) |
| Layout | ||
Section, sectionGutters, sectionPadding |
page section, Inner | gutters 20 / 30 / 40, padding 60 / 80 / 100, content at most 1440 wide, clipped; cursor sets data-cursor |
Divider |
Misc/Divider | 1 px Black 06 line between sections, inset 50 / 30 / 20, 20 above and below |
SectionTitle |
section Title | Menu eyebrow over the heading (h2, Heading 2 unless headingClassName), 10 apart |
| Cursor | ||
Cursor |
Misc/Cursor | one per page (root layout), mouse only, over <main>; data-cursor picks the look (dot, active ring, labelled pill, none); morphs with SC |
| Cards | ||
ProjectTickerCard |
Card/Project | 450 × 370 (260 × 375 phone) ticker slot; View Project cursor, no hover |
ProjectCard |
Card/Project 2 | photo zoom 105 → 100 % (SC), meta, title, testimonial; variant="simple" drops the testimonial |
PostCard |
Card/Post | photo zoom 105 → 100 % (SC), date, title, excerpt; Read cursor |
PostNavCard |
Card/Post Prev / Next | label over a 72 px thumbnail (zoom, SC), date and title; side="end" mirrors it |
ServiceCard |
Card/Service 02 | photo zoom (SC) on hovering the card, name, summary, More Details link; More Details cursor with a plus |
JobCard |
Card/Job | three columns on desktops, title + type over the summary below; bottom rule; only More Details links |
TeamList |
Misc/Team List + Card/Team | 3 / 2 / 1 columns; desktop-only dimming of the other cards to 50 % (S2); social buttons per member |
| Data | ||
UserRating |
User Rating | stars, score / max, line, overlapping avatars + lime plus, caption; static |
ProcessGraph |
Card/We Work + Misc/Graph | two-row Gantt over a dashed axis; Start → Full once fully in view (S2 widths + fades), once; read as a list by assistive technology |
| Patterns | ||
ServiceAccordion |
Misc/Service List + Card/Service 01 | one row always open; S2 heights (Collapse), the circle’s fill cross-fades; buttons with aria-expanded |
TestimonialSlider |
Card/Testimonials Slide + Card/Client Name | quote + client chips; auto-advance every interval s, chip hover / active and height (SC); keyboard focus pauses it |
PricingCard |
Card/Pricing + Misc/Switch | Weekly / Monthly switch (S2 slider, label cross-fade, card height); features, price, CTA |
Ticker |
Ticker | endless row at speed px/s, direction, optional fade and pauseOnHover; clip={false} lets items run past the box; stops for reduced motion |
LoadMore |
Button/Load More under a CMS list | page sizes per breakpoint ({ base, md, lg }), every item rendered and hidden by class; button 150 × 40, Black 13 → lime at once; gone after the last page; focus moves to the first new item |
RichText |
formatted text | Medium (or size="big") Paragraph in Black 13; headings by Framer level; 20 / 40 / 32 spacing; bold, italic, label, lists |
Collapse |
accordion body | grows / shrinks the box (S0 by default, transition to change), content cut not faded, hidden when closed |
| Media and scroll | ||
VideoCard |
About Video card | veil 50 → 30 % and Play icon ×1.5 on hover (SP); Play opens a modal <dialog> with the player (80vw, 16:9), scroll lock, Escape / backdrop close, focus back to Play |
ScrollTransform |
Scroll Transform (In View) | content moves linearly from from (x, y, scale, opacity) to rest while its box crosses the screen; fromTablet / fromPhone; passive scroll listener writing style; reduced motion = none |
Parallax |
Parallax (speed, offset) | translateY = (scrollY − box top + offset) × (1 − speed/100); speedTablet / speedPhone; Project photos (80 / 95) and the Services CTA band’s photo (50, offset 50, a layer twice the band’s height) |
| Forms | ||
Form, FormField, FieldControl, CheckboxGroup, SubmitButton, fieldSurface, honeypotField |
Contact form, Form button | fields: Black 04 fill, Black 06 border, 4 px corners, focus Black 08 border on Black 03 (instant); round 16 px checkboxes (Black 13 when ticked); the form checks required / e-mail fields and shows each field’s error; Submit 36 tall, Black 13 → lime on hover (0.2 s ease-form), Black 10 pressed, spinner, “Thank you”, “Something went wrong” on Error 15 % |
| Providers and utilities | ||
MotionProvider |
— | root layout: reduced motion honoured, S0 as the default transition |
CurrentYear |
— | the visitor’s year in the copyright line, without a hydration mismatch |
Add every new component here and to /style-guide.