Marai Neesu design system — Next.js
Content-free building blocks of the Marai Neesu 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-black,text-black/80,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. (Motion variants animate colours asrgba(5,5,5,…)orvar(--color-…)strings: Motion cannot interpolate thecolor-mix()Tailwind writes for an opacity modifier.) - 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,SectionTitletextClassName,RichTextheadingSpace/blockSpace/listSpace,TickerfadeClassName,FormsubmitClassName) or another variant.- Positioning belongs to the caller. A component does not place itself (no offsets, margins or grid placement of its
own); the caller adds them through
className.GoBackis the exception: it is fixed to the bottom of the window. - 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 Manrope), the ease-form curve, the animations with their keyframes (turn, ticker-x, ticker-y), the page background and text colour |
tokens/text.ts |
The 15 text styles (text.h2 …), per breakpoint |
tokens/motion.ts |
The Framer transitions S1, S2, S3, SL and instant, 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 | Value | Framer style | Used for |
|---|---|---|---|
black |
#050505 | Black | text, the filled buttons, the current menu link, a ticked box |
black/80 |
80% | Black 80 | leads, descriptions, card text, the Submit button pressed, the logo’s seal |
black/60 |
60% | Black 60 | meta lines, the current breadcrumb, placeholders, a focused field’s border |
black/30 |
30% | Black 30 | the rule between a lesson’s number and title, the veil over a post’s cover |
black/10 |
10% | Black 10 | dividers, field and checkbox borders, the module pill’s hairline |
black/5 |
5% | Black 05 | card hairlines (cardSurface), field fills |
black/3 |
3% | Black 03 | card surfaces, chips, accordion rows, the outline button |
grey |
#9FA0A3 | Grey | the rolling roles, the place under the logo; the secondary product button’s hairline |
accent |
#FC5000 | Accent | hover colour of links and buttons, the stars, the e-mail’s second copy, GoBack on hover |
background |
#F6F6F6 | Background | the page, text on Black |
white |
#FFFFFF | White | the tick of a checkbox, the Submit spinner |
white/50 |
50% | White 50 | the header’s link pill and the logo pill (with a 10px blur) |
white/5, white/3 |
5%, 3% | White 05, White 03 | the Course page’s label chip on its dark block |
available |
#1FB514 | (Framer’s own value) | the dot of StatusBadge |
error |
#FF2244 | (Framer’s own value) | at 15% (bg-error/15): the Submit button’s fill after a failed send |
Corners: 10px on cards and their photos (cardSurface), 8px on the experience, testimonial and accordion cards and the
course image, 4px on product buttons, fields and checkboxes, 2px on the accordion’s and module’s boxes and the social
tiles, round on buttons, chips, pills and avatars.
Text styles
Section titled “Text styles”Named as in Framer, all Manrope (one variable font). Displays are 400, headings 500 at line height 1.2, scaled per breakpoint; the paragraphs are the same size everywhere. Bold runs in rich text are 700.
| Token | Framer name | Phone / tablet (md) / desktop (lg) |
Used for |
|---|---|---|---|
text.display1 |
Display 01 | 38 / 52 / 64, 400 | the Home hero’s title |
text.display2 |
Display 02 | 24 / 36 / 42, 400 | page titles |
text.h1 |
Heading 1 | 24 / 26 / 28 | an inner page’s <h1> (SectionTitle as="h1") |
text.h2 |
Heading 2 | 22 / 24 / 26 | section titles |
text.h3 |
Heading 3 | 20 / 22 / 24 | rich-text headings |
text.h4 |
Heading 4 | 20 / 21 / 22 | the course card’s title, FooterLink |
text.h5 |
Heading 5 | 18 / 19 / 20 | service, product, experience and accordion titles |
text.h6 |
Heading 6 | 16 / 17 / 18 | project, post, tool, module and lesson titles |
text.h6Small |
Heading 6 Small | 14 | the logo’s name, a CV line’s subtitle, a lesson’s number |
text.big |
Big Paragraph | 18 / 1.4 | a post’s body, a testimonial’s name |
text.paragraph |
Medium Paragraph | 16 / 1.4 | leads, descriptions, rich text, form labels, breadcrumbs |
text.small |
Small Paragraph | 14 / 1.2 | meta, chips, labels |
text.tiny |
Tiny Paragraph | 12 / 1.2 | the place under the logo |
text.menu |
Menu | 13, 500, 0.03em apart | the header’s links |
text.button |
Button | 12 / 1.1, 500, upper case | button labels, links with an arrow (the copy stays mixed case) |
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 | Value |
|---|---|
sectionGutters |
side padding 20 / 30 / 40 |
sectionPadding |
vertical padding 40 / 50 / 50 |
sectionGap |
50 between the blocks of a section |
The content is at most 1200 wide (Framer “Inner”). The fixed header is 74 / 84 / 92 tall; the root layout pads <main>
by that.
Motion
Section titled “Motion”| Name | Token | Values | Used by |
|---|---|---|---|
| S1 | spring |
spring 0.4 s, bounce 0.2 | nearly every hover: Button, NavLink, UnderlineLink, the logo, SocialTiles, ProductButton, PostCard, ToolCard, GoBack, CourseModule; the default transition of MotionProvider |
| S2 | springFlat |
spring 0.4 s, no bounce | the header’s scroll look and the phone menu, ProjectCard, ProductCard, ServiceCard, Accordion |
| S3 | springRoll |
spring 0.5 s, no bounce | EmailLink’s roll |
| SL | slideSpring |
stiffness 200, damping 40, mass 1 | Framer’s Slideshow: WordRoll, the testimonials on phones |
| — | instant |
duration 0 | a change Framer makes at once (the underline snapping back) |
The CSS tokens of theme.css (Tailwind utilities ease-form, animate-turn …):
| Token | Holds |
|---|---|
--ease-form |
cubic-bezier(0.44, 0, 0.56, 1): the SubmitButton’s colours (0.2 s) |
--animate-turn |
one turn a second, linear: the SubmitButton spinner |
--animate-ticker-x, --animate-ticker-y |
the Ticker belt over one copy (--ticker-period); each Ticker sets its duration inline, right and down run them in reverse |
Components
Section titled “Components”| Group | Component | File | What it is | Props that matter |
|---|---|---|---|---|
| actions | Button |
actions/Button.tsx |
Framer Button/Primary: a 36px pill, the label in Button 12; with icon a 14px icon that turns 45° on hover. Primary is Black and lifts with a shadow stack, Outline (Black 03, hairline) fills Black, Accent (Accent 03, inner glow) adds outer shadows. A link with href (external in a new tab), otherwise a <button> |
tone (primary default, outline, accent), icon, href, type, onClick |
| actions | UnderlineLink |
actions/TextLink.tsx |
Framer Button/Secondary: label, a 12px arrow and an underline that grows on hover (S1) and snaps back; label and arrow turn Accent, the arrow turns 45° | href, arrow (true), size (button: Button 12 upper case; small: Small Paragraph, the CV’s links) |
| actions | NavLink |
actions/TextLink.tsx |
Framer Button/Menu: Menu 13 on a 10 / 16 pill; the current page is a Black pill without hover, the others turn Accent and grow the underline | href, current (aria-current), onClick |
| actions | FooterLink |
actions/TextLink.tsx |
the footer’s links in Heading 4; Accent and underlined on hover, at once (CSS) | href |
| actions | EmailLink |
actions/EmailLink.tsx |
Framer Button/Text (the hero’s e-mail): Medium Paragraph that rolls up to an Accent copy on hover (S3) | email |
| actions | ProductButton |
actions/ProductButton.tsx |
Framer Button/Product: 32 tall, 4px corners; primary Black → Accent, secondary Grey hairline → filled Black; with a label a 16px icon turns 45° on hover, without one only the icon (the cart) |
href, tone (secondary default), icon (arrow-up-right), label (name of an icon-only button), className (width) |
| actions | GoBack |
actions/GoBack.tsx |
Framer Back: a Black pill fixed 20 above the bottom of the window, Accent on hover; goes back, or to fallbackHref when the previous page is not on this site |
fallbackHref, label |
| brand | Logo |
brand/Logo.tsx |
Framer Misc/Logo: a 34px avatar, the name (Heading 6 Small) over the place (Tiny, Grey), linking home. pill: on a White 50 blurred pill with the verified seal; hover swaps the lines for hoverLines and the seal for a back arrow |
href, name, place, avatar, verifiedLabel, pill, hoverLines |
| icons | Icon |
icons/Icon.tsx, icons/paths.ts |
a Phosphor icon as inline SVG in the text colour; the 14 icons are in paths.ts |
name (IconName), className (size; 14px when left out), label (an image with a name; decorative without) |
| cards | ProjectCard |
cards/ProjectCard.tsx |
Framer Card/Project: a 4:3 photo, title, a two-line summary and the meta line; the whole card links; hover (S2) zooms the photo to 105%, squares its bottom corners, the title turns Accent | ProjectCardData (href, title, summary, image, service, date, dateTime), heading, sizes |
| cards | MetaLine, cardSurface |
cards/ProjectCard.tsx |
two texts in Small Paragraph, Black 60, with a dot; the card surface class (Black 03, Black 05 hairline, 10px corners) | items |
| cards | ProductCard |
cards/ProductCard.tsx |
Framer Card/Product: a half-grey photo, the title, tagline and price pill, the cart and “View Details” buttons; hover (S2) colours and zooms the photo | ProductCardData (href, title, tagline, price, image, buyUrl, buyLabel, detailsLabel), heading |
| cards | PostCard |
cards/PostCard.tsx |
Framer Card/Post: a 4:3 photo, the category and date, a two-line title; the whole card links; hover adds a soft shadow, squares the photo’s bottom corners, the title turns Accent | PostCardData (href, title, image, category, date, dateTime), heading |
| cards | ServiceCard |
cards/ServiceCard.tsx |
Framer Card/Service: title, price, description and “More Details”; two columns of photos at the right that roll on hover (S2, 5 px/s); phones: one row above, always rolling | ServiceCardData (title, priceLabel, description, link, images) |
| cards | TestimonialCard |
cards/TestimonialCard.tsx |
Framer Card/Testimonial: 340 × 300 (350 wide on phones), the person, the Accent stars and the quote; no hover | TestimonialCardData (name, role, photo, quote, rating, ratingLabel) |
| cards | CourseCard |
cards/CourseCard.tsx |
Framer Card/Course (Home): the image, the Framer-mark chip, title, text and a Primary button; no hover | CourseCardData (label, title, text, image, link) |
| cards | CourseModule |
cards/CourseModule.tsx |
Framer Card/Module: the module pill, title and caret as a button; open (S1), the lessons with number, rule, title and a “Free Preview” link; each module opens on its own | CourseModuleData (label, title, lessons), defaultOpen, heading (h4) |
| cards | ExperienceCard |
cards/ExperienceCard.tsx |
Framer Card/Experience (About): the job title, the company and period with icons, the description; no hover | ExperienceCardData (title, company, period, description), heading |
| cards | ToolCard |
cards/ToolCard.tsx |
Framer Card/Stack (About): a link to the tool (new tab) with its logo, name and category; hover fills it Black 03 and grows an arrow | ToolCardData (href, title, category, logo), heading |
| cards | CvCard, CvPostCard |
cards/CvCard.tsx |
Framer Card/CV: the date (120 wide) and a small UnderlineLink, subtitle and description; CvPostCard is the CV’s Writing row (date, photo, title, category), the whole row a link |
CvCardData (date, dateTime, link, subtitle, text); CvPostCardData (href, title, category, image, date, dateTime), heading |
| data | StatusBadge |
data/StatusBadge.tsx |
Framer Subtitle chip of the CV: an available dot and the label on a Black 03 pill |
children |
| navigation | Breadcrumbs |
navigation/Breadcrumbs.tsx |
Framer Breadcrumbs: Medium Paragraph links (Accent and underlined on hover), “/” between, the current page in Black 60 | items ({ label, href? }), label (the nav’s name) |
| navigation | SocialTiles |
navigation/SocialTiles.tsx |
Framer Misc/Social List: 24px tiles with two letters; hover fades the others to 30% and shows the profile’s icon | items (SocialTile: label, short, href, icon) |
| patterns | RichText |
patterns/RichText.tsx |
CMS rich text: headings (levels 2–6), paragraphs with **bold**, `code` and line breaks, bulleted and numbered lists, nested |
blocks (RichTextBlock), headings (style per level), headingSpace, blockSpace, listSpace, className (paragraph style and colour) |
| patterns | Ticker |
patterns/Ticker.tsx |
Framer Ticker: items moving forever, measured in the browser so items keep their own sizes; faded ends; still for reduced motion | speed (px/s), direction (left, right, up, down), running, gapClassName, copies, fade, fadeClassName, label |
| patterns | WordRoll |
patterns/WordRoll.tsx |
Framer Slideshow of texts (the hero’s and the CV’s roles): one line up every interval seconds with SL, forever |
items, interval (4), lineHeight, itemClassName |
| patterns | Accordion |
patterns/Accordion.tsx |
Framer Card/Accordions (the FAQs of Services and Course): Black 03 rows with a Heading 5 title button and a plus / minus box; each row opens on its own (S2) | items ({ title, content }), defaultOpen ([0]), heading (h3) |
| layout | Section, Divider |
layout/Section.tsx |
a page section: gutters, vertical padding, blocks 50 apart, content at most 1200 wide; Divider is the 1px Black 10 line between sections. Also exports sectionGutters, sectionPadding, sectionGap |
padding, gap (whole class strings), innerClassName, className, id, as, label |
| layout | SectionTitle |
layout/SectionTitle.tsx |
Framer Title: Heading 2 (Heading 1 as h1) and a Black 80 lead, at most 550 wide (750 wide); with action a button at the right (under it on phones) |
title, text, as, wide, textClassName (a whole class), action |
| forms | Form |
forms/Form.tsx |
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; posts without JavaScript too | action, submitLabel, successLabel, errorLabel, redirectTo, submitClassName |
| forms | FormField, FieldControl, CheckboxGroup, fieldSurface |
forms/FormField.tsx |
Framer form field: a Medium Paragraph label 10 over a control (Black 05 fill, Black 10 hairline, 4px corners; focus: Black 60), no required mark (as in Framer); FieldControl is the control alone, fieldSurface its class string; CheckboxGroup a fieldset of 16px checkboxes, every ticked one sent under one name |
name, label, type (text, email, tel, url, date, textarea), placeholder, required, autoComplete, defaultValue; CheckboxGroup: name, label, options |
| forms | SubmitButton |
forms/SubmitButton.tsx |
Framer Submit (Default, Loading, Success, Error, Disabled): a 33px Black pill, Accent on hover, Black 80 pressed; a white ring while sending; Error on a 15% red fill; Disabled at 50% | status (idle, pending, success, error), label, successLabel, errorLabel, disabled |
| forms | honeypotField, FormAction, FormState |
forms/form-state.ts |
shared by Form and the server actions (a plain module, so server code can import it) |
— |
| providers | MotionProvider |
providers/MotionProvider.tsx |
honours reduced motion (transforms and layout animations skipped, fades stay) and makes S1 the default transition of every Motion element that sets none | — |
| utils | CurrentYear |
utils/CurrentYear.tsx |
the visitor’s current year, without a hydration mismatch | — |
| utils | LocalTime |
utils/LocalTime.tsx |
Framer Time & Date: the time in a time zone (“7:41 PM”), following the clock; empty until the script runs | timeZone |
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.