CodeByte · v0.1 · Foundational design system

Software,
built with taste.

Tokens, primitives, and a small set of composed patterns. Built on top of Hero UI Pro v3, anchored to Apple Glass. Dark first, light first-class, bilingual EN/HE, and product override slots wired through a single token.

Foundation
Hero UI Pro v3
Display
Inter
Body
Inter · Heebo
Mono
JetBrains Mono
A11y
WCAG 2.2 AA

00 · Identity

Brand

The CodeByte identity: byte-grid mark, wordmark, voice, and the four colours everything else is mixed from.

Brand

CodeByte

A design-led engineering identity. Built on a byte-grid — every square deliberate, nothing decorative.

Who we are, in pixels.

A premium engineering studio. The brand is the work: clean code, honest scope, and a single mint accent that signals where attention belongs. No gradients for show, no noise — just structure, restraint, and craft.

  • WordmarkInter · 600
  • HebrewHeebo · 800
  • Mono / labelsJetBrains Mono
Mint#86EFAC
Canvas#050605
Surface#161917
Foreground#FCFCFC

01 · Foundations

Tokens

Every design decision in the system is held in a token. Components reference tokens; tokens reference primitives. To re-skin a product, override exactly one token — --brand-primary.

Mint Theme Token Explorer

Interactive Swatches · Light & Dark Sets

Click any token swatch to explore its properties, compare Light and Dark values side-by-side, check contrast, and understand its semantic role in the Mint design system.

Active Token Details

Accent / Mint Green

Primary interactive color and single focus accent across the whole system.

CSS Variable:--accent
Light HEX:#86efac
Dark HEX:#86efac
MINT LIGHT
#86efac
WCAG AA Compliant
MINT DARK
#86efac
WCAG AA Compliant
PRODUCT ACCENT DEMONSTRATIONS (LOCALLY SCOPED)
Product 01 (Emerald)
Product 02 (Persimmon)
Do / Don't
  • Use brand.primary for primary CTAs, focus rings, active states.
  • Don't introduce a second saturated accent. The system holds exactly one.
Product override
  • Override --brand-primary + --brand-primary-muted per [data-brand].
  • Flip theme and language in the top nav — every token adapts live.
Accessibility
  • Brand on canvas passes 4.5:1 in both themes (accent is dynamic).
  • Focus rings always paint with --brand-primary, 2px + 2px offset.

Typography Scale & Layout

Inter (Latin) & Heebo (Hebrew)

The typography system scales from micro labels to heroic headlines. Below is the responsive scale detailing font sizes, tracking, and leading values for both Inter and Heebo.

EN · LTR · Inter
Software, built with taste.display-xl · Inter (Bold) · Size: Variable · Leading: 1.0
From prototype to production.display-lg · Inter · Size: Variable · Leading: 1.04
AI automation that ships.display-md · Inter · Size: Variable · Leading: 1.08
A senior engineering studio.display-sm · Inter · Size: Variable · Leading: 1.15
For founders, CTOs, and product leads who recognise the difference between Vercel/Linear/Stripe-grade craft and generic AI-agency output.text-xl · Inter · Size: 20px · Leading: 1.5
A senior engineering studio for founders who can tell the difference. We build custom software, AI automation, SaaS products, and enterprise modernisation work.text-md · Inter — Body Default · Size: 16px · Leading: 1.6
We'll reply within one business day.text-sm · Inter — Helper · Size: 14px · Leading: 1.5
HE · RTL · Heebo
תוכנה, בנויה בטעם.display-xl · Heebo (Bold) · Size: Variable · Leading: 1.0
מאב־טיפוס לפרודקשן.display-lg · Heebo (Bold) · Size: Variable · Leading: 1.04
אוטומציה שמגיעה לפרודקשן.display-md · Heebo (Bold) · Size: Variable · Leading: 1.08
סטודיו הנדסי בכיר.display-sm · Heebo (Bold) · Size: Variable · Leading: 1.15
למייסדים, מנהלי טכנולוגיה ומובילי מוצר שמבדילים בין מלאכת מחשבה ברמת Vercel/Linear/Stripe לבין פלט גנרי של סוכנויות AI.text-xl · Heebo · Size: 20px · Leading: 1.5
סטודיו הנדסי בכיר ליזמים שיודעים להבחין. אנחנו בונים תוכנה בהתאמה, אוטומציה עם AI, מוצרי SaaS ומודרניזציה של מערכות.text-md · Heebo · Size: 16px · Leading: 1.6
נחזור אליכם תוך יום עסקים אחד.text-sm · Heebo · Size: 14px · Leading: 1.5
Do / Don't
  • Pair display-lg headlines with text-lg sub-copy; avoid stacking two display sizes.
  • Don't apply negative letter-spacing to Hebrew. It tightens awkwardly.
RTL behaviour
  • Mirror: paragraph alignment, headline alignment, line-end punctuation.
  • Preserve: numerals, dates, code, English brand names embedded in Hebrew copy.
Accessibility
  • Body sits at 16px / 1.6 — comfortable line-length 60–70ch.
  • Headings cascade with h1–h4; never skip levels for visual sizing.

Spacing Explorer

4px Base · Interactive Blueprint

Hover or click any spacing token to inspect its visual weight, pixel dimensions, and proportional layout values in real time.

space-14px
space-28px
space-312px
space-416px
space-520px
space-624px
space-732px
space-840px
space-948px
space-1064px
space-1196px
space-12128px
SPACING BLUEPRINT PREVIEW

--space-4

Pixel: 16pxREM: 1.0rem

Border Radius Showcase

Single Source Multiplier · 1rem (16px) Default

The entire curvature ladder of the system scales mathematically from a single source of truth: `--radius` (currently set to 1rem / 16px). This guarantees concentricity and layout consistency.

THE CORNER RADII LADDER
smcalc(var(--radius) * 0.375) · 6px
mdcalc(var(--radius) * 0.5) · 8px
lgcalc(var(--radius) * 0.75) · 12px
xl (Global)var(--radius) · 16px
2xlcalc(var(--radius) * 1.25) · 20px
glassvar(--radius) · 16px
MANDATORY 1REM CORE ALIGNMENT

Concentric card & button preview

Verify how actual HeroUI buttons and card containers map the default 1rem (16px) radius to maintain perfect alignment.

1rem Card

This nested container perfectly maintains standard border concentricity.

Elevation

shadows for both themes + glass
shadow-xs
shadow-sm
shadow-md
shadow-lg
glass

Motion

durations + easing
motion-fast · 150ms

Tooltips, popovers, toggle states. Anything you don't want to wait for.

motion-base · 240ms

Modals, drawers, accordion expand. The default for surface changes.

motion-slow · 360ms

Page transitions, hero entry. Used once per page, max.

--ease-out-soft:       cubic-bezier(0.22, 1, 0.36, 1);   /* entries */
--ease-in-out-precise: cubic-bezier(0.65, 0, 0.35, 1);   /* state changes */

Z-index

named scale
--z-base:     0;
--z-dropdown: 50;
--z-sticky:   100;   /* sticky nav */
--z-overlay:  200;   /* modal backdrop */
--z-modal:    300;
--z-toast:    400;   /* always above everything */

Hero UI integration

extendTheme configuration

Tokens plug into Hero UI Pro v3's extendTheme. The full snippet lives in heroui.theme.snippet.md; this is the theme setup:

import { heroui } from "@heroui/react";

export const codebyteTheme = heroui({
  themes: {
    "codebyte-dark": {
      extend: "dark",
      colors: {
        background: "var(--bg)",
        foreground: "var(--fg)",
        primary:    { DEFAULT: "var(--brand-primary)", foreground: "var(--brand-primary-fg)" },
        focus:      "var(--brand-primary)",
        content1:   "var(--surface)",
        divider:    "var(--hairline)"
      }
    }
  }
});

02 · Components

Primitives

Every primitive shown in EN/LTR and HE/RTL side by side. States: default, hover, focus, active, disabled, loading where relevant. Use the theme toggle to inspect light + dark; use the product toggle to inspect the accent override.

Buttons

primary · secondary · ghost · glass · icon · sizes
EN · LTR
HE · RTL

Inputs

text · textarea · search · select · validation
EN · LTR
Enter a positive number.
HE · RTL
הזינו מספר חיובי.

Checkbox · Radio · Switch

selection controls
EN · LTR
HE · RTL

Top navigation

glass treatment · mega-menu skeleton
EN · LTR
CodeByte
HE · RTL
CodeByte

Cards

default · glass · feature
EN · LTR
Default card

Hairline border, surface fill, no shadow at rest.

Custom software

Web and full-stack engineering, end to end.

HE · RTL
כרטיס ברירת מחדל

קו הפרדה דק, רקע משטח, ללא צל במנוחה.

תוכנה בהתאמה

הנדסת ווב ופול־סטאק, מקצה לקצה.

Tags · Chips · Badges

small surfaces
EN · LTR
DefaultBrandShippedIn reviewBlockedNote
312!
HE · RTL
ברירת מחדלמותגהושקבבדיקהחסוםהערה
312!

Tabs

underline + segmented
EN · LTR

A senior engineering studio for founders who can tell the difference.

HE · RTL

סטודיו הנדסי בכיר ליזמים שיודעים להבחין.

Accordion

FAQ pattern primitive
EN · LTR
How does engagement work?
Discovery sprint, fixed-scope build, or ongoing retainer. We scope the work in week one and write the proposal as code.
What stack do you build on?
TypeScript, React, Next.js, Postgres, and whichever AI/agent layer fits the brief — pragmatic over fashionable.
Do you work with Israeli SMBs only?
No. About half our work is Israeli SMBs and funded startups; the other half is international product work.
HE · RTL
איך עובדת ההתקשרות?
ספרינט גילוי, פיתוח בהיקף קבוע, או ריטיינר מתמשך. אנחנו קובעים את ההיקף בשבוע הראשון וכותבים את ההצעה כקוד.
על איזה סטאק אתם בונים?
TypeScript, React, Next.js, Postgres, ושכבת AI/סוכנים שמתאימה לפרויקט — פרגמטי על פני אופנתי.
אתם עובדים רק עם SMB ישראליות?
לא. כמחצית מהעבודה היא עם SMB ישראליות וסטארטאפים ממומנים; המחצית השנייה — עבודת מוצר בינלאומית.

Modal & Drawer

glass backdrop, soft elevation
EN · LTR · Modal
HE · RTL · Modal

Toasts & inline alerts

non-blocking notifications
EN · LTR
Brief sent.We'll reply within one business day.
Slow query detected.P95 above target on /api/projects.
Build failed.See logs at deploy #2348.
HE · RTL
התקציר נשלח.נחזור אליכם תוך יום עסקים אחד.
שאילתה איטית.P95 מעל היעד ב־/api/projects.
הבנייה נכשלה.ראו לוג ב־deploy #2348.

Avatar

single · group · sizes
EN · LTR
DGYHNKDGYHNK+4
HE · RTL
דגיהנקדגיהנק+4

Tooltip & Popover

contextual surfaces
EN · LTR
Copy link
Filter case studies

By industry, stack, or engagement type.

HE · RTL
העתקת קישור
סינון מקרי לקוח

לפי תעשייה, סטאק, או סוג התקשרות.

Stat tile

metric · delta
EN · LTR
Projects shipped128+18 this quarter
Avg. time to first deploy8d−2d vs target
Client satisfaction9.4+0.3 YoY
HE · RTL
פרויקטים שהושקו128+18 ברבעון
זמן עד דיפלוי ראשון8d−2d מהיעד
שביעות רצון לקוחות9.4+0.3 YoY

Section header pattern

eyebrow / heading / supporting
EN · LTR
Engineering studio

Software, built with taste.

Built for founders who can tell the difference between Vercel/Linear/Stripe-grade craft and generic AI-agency output.

HE · RTL
סטודיו הנדסי

תוכנה, בנויה בטעם.

בנוי ליזמים שיודעים להבחין בין מלאכת מחשבה ברמת Vercel/Linear/Stripe לבין פלט גנרי של סוכנויות AI.

Code block

agency audience — code is content
// app/api/projects/route.ts
import { NextResponse } from "next/server";
import { db } from "@/lib/db";

export async function GET() {
  const projects = await db.project.findMany({
    where: { status: "shipped" },\n                    orderBy: { shippedAt: "desc" },\n                    take: 12,
  });\n                  return NextResponse.json(projects);
}

Spinners & loaders

indeterminate · inline · sizes
EN · LTR
Fetching projects…
HE · RTL
טוען פרויקטים…

Progress

linear · circular · indeterminate
EN · LTR
Build progress62%
Deploy succeeded100%
Indexing repo…indeterminate
Quota used94%
63%100%25%
HE · RTL
התקדמות בנייה62%
הדיפלוי הצליח100%

Skeleton

content placeholders · shimmer
EN · LTR
HE · RTL

Slider

single value · range · with ticks
EN · LTR
Team size12
01020304050
Budget range$15k – $45k
HE · RTL
גודל הצוות12
01020304050

Dropdown menu

action menu · groups · shortcuts · destructive
EN · LTR
HE · RTL

Wayfinding

breadcrumbs · pagination · stepper
EN · LTR
BriefScope3Proposal4Kickoff
HE · RTL
אפיוןטווח3הצעה4השקה

Carousel

slides · glass arrows · dot indicator
EN · LTR
HE · RTL

Advanced inputs

file upload · OTP · number stepper · date
EN · LTR
Drop a PDF or click to uploadMax 10 MB · PDF, DOCX, MD
·
We sent a code to you@studio.com.
HE · RTL
גררו PDF או לחצו להעלאהעד 10MB · PDF, DOCX, MD
·
שלחנו קוד לכתובת you@studio.com.

Empty state

illustrated container
EN · LTR
No projects active

Tell us what you're building to establish a pipeline.

HE · RTL
אין פרויקטים פעילים

ספרו לנו מה אתם בונים כדי להתחיל את העבודה.

Command palette

keyboard-first nav
EN · LTR
Esc
Projects
Aurora · fintech rebuildGo to
Vesper · agent workflowGo to
HE · RTL
Esc
פרויקטים
אורורה · בניית פינטק מחדשמעבר אל
וספר · תהליך סוכןמעבר אל

Live HeroUI & Pro Components Showcase

Dynamic React & Pro primitives

These components are rendered in real time using official @heroui/react and @heroui-pro/react, verifying that all Mint theme variables, typography scales, and concentric radii are successfully inherited.

STANDARD OSS PRIMITIVES
CB
Standard Card Component

This standard card automatically inherits typography rules, background tokens, and spacing parameters.

HEROUI PRO V3 COMPONENTS
Interactive ItemCard TitleBeautifully structured layout rendering inside the active Mint token framework.
PRO

02.5 · Iconography

Icons

Every icon used across the marketing site, drawn inline at 24×24 with a 1.7 stroke and currentColor. No icon library — each glyph lives next to the component that uses it.

Site icons

24×24 · stroke 1.7 · currentColor · display only
logo
moon
sun
menu
close
chevron-down
arrow-right
arrow-up
check
plus
search
link
linkedin
x-share
calendar
shield
doc-check
clock
inbox

03 · Composed

Patterns

A small set of compositions that prove the system holds together. Not full marketing sections — just the proportions, hierarchy, and glass discipline. The marketing site lands in the follow-up generation.

Hero block skeleton

eyebrow / display-lg / supporting / actions / glass panel
Engineering studio

Software, built with taste.

A senior engineering studio for founders, CTOs, and product leads who recognise the gap between Vercel/Linear/Stripe-grade craft and generic AI-agency output.

Service card grid · 3-up

core services

Custom software

Web and full-stack product engineering, end to end. TypeScript, React, Next.js, Postgres.

Learn more

AI automation

LLM workflows, agents, and integrations that ship. Production-grade, not a demo.

Learn more

SaaS development

From MVP to scale. We've launched products from week-one pitch to first thousand customers.

Learn more

Logo cloud · product portfolio

accent overrides demonstrated
CodeByteProduct 01Product 02Future SaaS 03Future SaaS 04

Toggle the product swatch in the top nav to see --brand-primary shift across the entire styleguide. Sub-01 / Sub-02 marks above are scoped locally as a static demo.

Stats row · 4-up

numerical proof
Projects shipped128since 2019
Avg. time to first deploy8d−2d vs industry
Client retention94%3-year rolling
Engineers14senior+, no contractors

Testimonial card

long-quote layout
EN · LTR

"We've worked with three agencies before CodeByte. They're the first one that read our code before writing a proposal. The product shipped on the day they said it would."

EA
Eliav AharonCTO · Fintech series-A
HE · RTL

"עבדנו עם שלוש סוכנויות לפני CodeByte. הם הראשונים שקראו את הקוד שלנו לפני שכתבו הצעה. המוצר עלה לאוויר ביום שאמרו."

אא
אליאב אהרוןCTO · פינטק סדרה־A

Pricing card layout

three-tier engagement

Discovery sprint

$12k / 2 weeks

Scope, architecture, and a credible plan of attack.

  • Architectural diagram + proposal as code
  • Live working prototype
  • Fixed cost · two senior engineers

Retainer

From $24k / month

Embedded team for ongoing product work.

  • 1–3 senior engineers, your stack
  • Shared planning + retrospectives
  • No contractors, no offshoring

FAQ block

accordion + section header
Frequently asked

Before you brief us.

The questions we hear most before kick-off — answered without marketing.

What's your minimum engagement?
A two-week discovery sprint. We don't take on builds we haven't scoped.
Do you sign NDAs before discovery calls?
Yes. Mutual NDAs by default; we send a standard short-form on request.
Who actually writes the code?
Senior in-house engineers. No subcontractors, no offshore extension teams.
How do you price AI work?
Same as any product engineering: scoped sprint or fixed deliverable. We don't bill against tokens or runs.

CTA card · glass

end-of-page conversion surface
Ready when you are

Software, built with taste.

Tell us what you're building. We reply within one business day.

Footer pattern

brand col + 3 link columns

04 · Documentation

Manifest

The deliverables in this folder, what each file is for, and where it plugs into a Next.js + Hero UI Pro v3 project. Every per-component Do/Don't, RTL note, and a11y note is documented inline alongside each component above.

Files

root
src/app/theme/mint.css          — HeroUI v3 Mint theme, light + dark primitives
src/app/colors_and_type.css     — site tokens, type scale, product slots
src/app/globals.css             — Tailwind + HeroUI wiring, @theme inline map
src/app/marketing.css           — marketing-page components on the tokens
src/app/designsystem/           — this styleguide canvas (scoped CSS)
docs/design/MINT-DESIGN.md      — the Claude Design "Mint" reference
public/                         — byte-glyph, logo-mark, wordmark (SVG)

Product pattern

single-token override
[data-brand="sub-01"] {
  --accent:      #5ec787;   /* emerald */
  --accent-hover: #4fb878;
  --accent-soft: rgba(94, 199, 135, 0.15);
}

[data-brand="sub-02"] {
  --accent:      #aeffd3;   /* fresh mint */
  --accent-hover: #97ecc0;
  --accent-soft: rgba(174, 255, 211, 0.18);
}

Every other token — neutrals, semantics, glass, type, spacing, motion — is inherited. The Logo cloud in Patterns demonstrates both slots live.

Anti-patterns

do not introduce
Colour
  • Purple-to-teal gradient hero blobs
  • Rainbow accent palettes
  • Default Material/Bootstrap blues
Motion
  • Floating particles, animated stars
  • AI "shimmer" effects
  • Springs that overshoot > 1.05
Surface
  • Over-frosted Vista glass
  • Drop shadows as decoration
  • Emoji as iconography
Layout
  • Centred-by-default — hero only
  • Two primary CTAs on one surface
  • Reinventing Hero UI primitives