KorDent design system — Next.js
Content-free building blocks of the KorDent 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-primary,text-muted,ease-spring-a,shadow-float,spring— never a hex or a font size typed into a component; a value used twice becomes a token. Phone is the default;mdis 810 andlg1200. - No content imports, no copy. The only strings in components are the form’s fallbacks (“Submit”, “Thank you”, “Something went wrong”).
cnonly joins class names. It does not merge Tailwind classes; where a default has to change it is a prop that takes a whole class string (Sectionpadding,gap,inner;SectionTitletitleWidth;FormsubmitClassName).- Positioning belongs to the caller (
classNamefor margins, grid placement, absolute positions). - State and motion make a client component (
"use client"). Plain constants (fieldSurface) live in server-safe files; the style guide wraps stateful demos insrc/app/style-guide/parts.tsx. - Hovers run in CSS with the spring curves of
theme.css(duration-400 ease-spring-a), so nothing stays stuck in a hover state; Motion runs the appear effects, the menu link’s letters, the accordion’s height and the phone menu. - Framer first. A deliberate refinement is written in the component’s leading comment and in the spec’s Deviations.
Tokens
Section titled “Tokens”| File | Holds |
|---|---|
theme.css |
Colours, breakpoints, the font variable (Inter), --ease-appear, --ease-form, --ease-spring-a/-b (springs as linear() curves), --shadow-float, --animate-turn, the page background |
tokens/text.ts |
The 15 text styles, per breakpoint |
tokens/motion.ts |
Spring A, Spring B, Spring Menu, the appear tween and distances, the form tween |
utils/cn.ts, utils/href.ts |
cn; isExternalHref, externalLinkProps |
Colours
Section titled “Colours”Framer’s colour styles are unnamed in the published site (--token-<uuid>); the names are ours.
| Token | Hex | Used for |
|---|---|---|
primary |
#00ADA2 | the accent: primary buttons, active tabs, icons, chips (/80 chip text, /10 chips, /5 hovers and panels) |
ink |
#222222 | headings and strong text |
black |
#000000 | the secondary button, simple buttons on hover (/5 hairlines on white) |
muted |
#6F7278 | body text, labels, meta |
white |
#FFFFFF | cards, the header (/5 the footer’s social buttons) |
stone |
#F5F3F2 | hairlines, fields, info panels, the Outcomes and CTA bands |
page |
#F8FAFC | the page |
lime |
#E9F885 | the yellow button, icon covers |
night |
#020618 | the footer |
mist |
#CAD5E2 | footer text (/30 its hairline) |
red-deep |
#AD0009 | the emergency number’s hover (Contact) |
amber |
#FFB900 | review stars |
blue, green, red |
#155DFC, #009966, #E7000B | the facts’ tints (/10); red the emergency card’s hover line |
error |
#FF2244 | the submit button’s error label (/15 its fill) |
placeholder |
#999999 | placeholders, the select chevron |
Radii: 2 (review tags), 6 (chips, icon boxes, header links), 8 (buttons, cards, fields), 12 (outcome and dentist cards, hero photo, banners, video), round.
Text styles
Section titled “Text styles”Inter (Google), one variable font pinned to optical size 14 — Framer serves the text cut at every size.
| Token | Phone / tablet / desktop | Used for |
|---|---|---|
text.h1 |
36 / 44 / 56, lh 1.1, 600 | page titles, the Home hero |
text.h2 |
28 / 32 / 36, lh 1.2, 600 | section titles |
text.h3 |
26 / 28 / 32 | rich-text headings |
text.h4 |
24 / 26 / 28 | rich-text headings |
text.h5 |
20 / 22 / 24 | the safety banner |
text.h6 |
18 / 19 / 20 | card titles, quotes |
text.bodyLarge |
16, lh 1.3 | leads, descriptions |
text.body / text.bodyBold |
14, lh 1.3, 400 / 700 | card text, lists / names, labels |
text.menu |
15, lh 1.2, 500 | header links |
text.button |
14, lh 1.2, 500 | buttons, tabs, footer links |
text.caption / text.captionBold |
12, lh 1.3, −0.02em | chips, meta / prices, legal links |
text.tiny / text.tinyBold |
10, lh 1.3 | disclaimer / review tags |
All at −0.03em except the 12px (−0.02em) and 10px (0) styles.
Spacing
Section titled “Spacing”Section: gutters 15 / 20 / 30 (sectionGutters), padding 60 / 80 / 100 (sectionPadding), a column at most 1300 wide,
60 between the title block and the content (gap). The header (68 / 78 / 78) lies over the page and scrolls away with it;
the root layout pads <main> by its height.
Motion
Section titled “Motion”| Name | Token | Values | Used by |
|---|---|---|---|
| Spring A | spring, ease-spring-a |
bounce 0, 0.4 s | buttons (label flip, icon covers), the post title, the service card hover, the phone menu, Collapse default |
| Spring B | springSoft, ease-spring-b |
bounce 0.2, 0.4 s | tabs, Accordion, Hamburger, SocialButton, RatingField |
| Spring Menu | springMenu |
bounce 0, 0.2 s, 0.075 s per letter | MenuLink |
| Appear | appear, ease-appear |
tween 1 s, ease 0.59 0.25 0.12 1.17 | Appear, TextAppear |
| Scroll / load appear | appearDistance 18, appearAmount 0.5, loadDistance 7 |
Appear |
|
| Form | formTween, ease-form |
tween 0.2 s, ease 0.44 0 0.56 1 | SubmitButton |
Components
Section titled “Components”| Group | Component | What it is | Props that matter |
|---|---|---|---|
| actions | Button |
Framer Button/Primary, 8 variants: primary, secondary, lime, green, text, footer, iconPrimary, iconSecondary; the label flips on hover, the icon box slides its colour covers |
variant, children (label), icon (IconName), href or type/onClick, label (accessible name; required for the icon-only variants) |
| actions | MenuLink |
Framer Button/Menu: header link; Active = Primary on Primary 10; hover = Primary 5 and the letters rise in Primary | href, label, current, onClick |
| actions | SocialButton |
Framer Button/Social Media: 36px round, White 5; hover Primary | name (facebook, instagram, x), href, label |
| brand | Logo |
the site’s SVG (125 × 28), a link when href is given; hover 80% |
href, label, className (size) |
| icons | Icon |
Phosphor (regular; star fill) in the text colour |
name, className (size), label |
| icons | ShapeIcon |
the template’s line icons, one per service and per “Why Choose Us” feature (shapeNames), and the review star |
name, className, label |
| motion | Appear, useRevealed |
appear effect on scroll (18px, half in view) or on load (7px) with the appear tween | on (scroll, load), delay, as, amount |
| motion | TextAppear |
the hero’s text effect: words from 10px lower, blurred 7px, all together; or one block (mode="block") |
as, runs ({ text, className }), mode, delay |
| motion | Collapse |
the height of an opening row (0 ↔ auto) | open, id, transition |
| navigation | Hamburger |
Framer Button/Hamburger: 28px Primary box, three lines → X on Ink | open, onClick, label, controls |
| navigation | ContentsNav |
Framer “Card” table of contents (service page): numbered links, Stone hairlines; the entry whose block is under the top of the window (≤ 50px) turns Primary with an arrow; hover Ink; spring B | items ({ number, label, id }), label |
| layout | Section |
page section: gutters, padding, 1300 column | padding, gap, inner (whole class strings), className, id, label |
| layout | SectionTitle |
Framer Title Section: chip, Heading 2, lead | eyebrow, eyebrowIcon, title, lead, layout (center, split, start), titleWidth, as |
| layout | Chip |
Framer Misc/Eyebrow: default (icon + Caption, Primary 10), green, grey |
children, icon, tone |
| cards | ServiceCard |
Framer Card/Service: icon, price, title, summary, details, facts panel, Learn More + Book; hover lifts (red line when urgent) |
data: ServiceCardData, titleAs |
| cards | PostCard |
Framer Card/Post: 3:2 photo, meta, title, excerpt; hover turns the title Primary | data: PostCardData, titleAs, sizes |
| cards | TestimonialCard |
Framer Card/Testimonial: patient, badge, stars, treatment tag, quote | data: TestimonialCardData, quoteAs |
| cards | OutcomeCard |
Framer Card/Outcome: category, title, text, quality list, timeline, treatment chips, four photos | data: OutcomeData (with id for the anchor), titleAs |
| cards | DentistName, DentistDetails, DentistHours, DentistPhoto, DotList |
the parts of Framer Card/Dentist (name row, details with lists, office hours panel, 225:281 portrait, dot list) | data: DentistData; active, photoClassName; nameAs, showName |
| data | CheckItem |
Framer Misc/Icon Text: Primary check circle + Body Muted | as (p, li), children |
| patterns | Accordion |
Framer Part/Reasons: one row open at a time, spring B | items ({ title, text }), defaultOpen, titleAs, numbered (01, 02 … in the mark: the Services page’s first-visit steps) |
| patterns | CardAccordion |
Framer About accordion (Active/01–03): numbered white cards that fill the given height; the open one grows (spring A) and uncovers its text at the bottom, the closed ones at 70% | items ({ title, text }), defaultOpen, titleAs, className (give it a height) |
| patterns | FilterTabs, SearchField |
Framer Tab (Default/Active) buttons; the search input with a magnifying glass | tabs, value, onChange, label; value, onChange, placeholder, label |
| patterns | RichText |
Framer rich text (posts, legal pages): Body Large in Ink, 20 between blocks, 40 above headings (each level in its own text style and tag), bold runs, links (Primary, underlined), bulleted/numbered lists, tables (Placeholder 25 hairlines, radius 8, header row Placeholder 10, cells at least 107 wide) | blocks, width (800), headingSpace (per level, whole classes), listSpace |
| forms | Form |
posts to a server action, shows progress on the submit button, honeypot | action, submitLabel, successLabel, errorLabel, redirectTo, submitClassName |
| forms | FormField, FieldControl, fieldSurface |
label (Body Bold, Muted) over a Stone field (radius 8, 42 tall; text area 150) | name, label, type (incl. date, time, held at 42), placeholder (a select without one starts on defaultValue), required, options, radius (whole class; Contact, booking: rounded-[6px]), areaHeight (booking notes: h-[100px]), className |
| forms | RatingField |
Framer Radio Group: five 24px stars as radio buttons | name, label, defaultValue, starLabel (“{n} stars”) |
| forms | ChoiceCard |
Framer “Service Check” / “Dentist Check”: a radio as a white card (Mist hairline, radius 8), optional 40px photo, title and one-line text; the radio turns Primary with a white check | name, data: ChoiceCardData (value, title, text, image), checked/defaultChecked, onChange, required |
| forms | SubmitButton |
Framer form button: Primary, hover Primary 80, pressed Lime; spinner; Thank you; error | status, label, successLabel, errorLabel, className |
| providers | MotionProvider |
reduced motion, spring A as the default transition | — |
| utils | CurrentYear |
the visitor’s year without a hydration mismatch | — |
Page sections live in src/components/sections/ (Home’s in home/, the shared CtaSection); 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.