Skip to content
Sign inJoin waitlist

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.

  • 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; md is 810 and lg 1200. (Motion variants animate colours as rgba(5,5,5,…) or var(--color-…) strings: Motion cannot interpolate the color-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”).
  • 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, SectionTitle textClassName, RichText headingSpace / blockSpace / listSpace, Ticker fadeClassName, Form submitClassName) 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. GoBack is 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 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 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)
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.

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)

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.

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