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.
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
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 SetsClick 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.
Accent / Mint Green
Primary interactive color and single focus accent across the whole system.
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.
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 BlueprintHover or click any spacing token to inspect its visual weight, pixel dimensions, and proportional layout values in real time.
--space-4
Border Radius Showcase
Single Source Multiplier · 1rem (16px) DefaultThe 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.
Concentric card & button preview
Verify how actual HeroUI buttons and card containers map the default 1rem (16px) radius to maintain perfect alignment.
This nested container perfectly maintains standard border concentricity.
Elevation
shadows for both themes + glassMotion
durations + easingTooltips, popovers, toggle states. Anything you don't want to wait for.
Modals, drawers, accordion expand. The default for surface changes.
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 configurationTokens 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 · sizesInputs
text · textarea · search · select · validationCheckbox · Radio · Switch
selection controlsTop navigation
glass treatment · mega-menu skeletonCards
default · glass · featureHairline border, surface fill, no shadow at rest.
Reserved for hero, modal, CTA, and nav.
Custom software
Web and full-stack engineering, end to end.
קו הפרדה דק, רקע משטח, ללא צל במנוחה.
שמור להירו, מודאל, CTA וניווט עליון.
תוכנה בהתאמה
הנדסת ווב ופול־סטאק, מקצה לקצה.
Tags · Chips · Badges
small surfacesTabs
underline + segmentedA senior engineering studio for founders who can tell the difference.
סטודיו הנדסי בכיר ליזמים שיודעים להבחין.
Accordion
FAQ pattern primitiveHow does engagement work?
What stack do you build on?
Do you work with Israeli SMBs only?
איך עובדת ההתקשרות?
על איזה סטאק אתם בונים?
אתם עובדים רק עם SMB ישראליות?
Modal & Drawer
glass backdrop, soft elevationStart a project
Tell us what you're building. We reply within one business day.
התחילו פרויקט
ספרו לנו מה אתם בונים. נחזור אליכם תוך יום עסקים אחד.
Toasts & inline alerts
non-blocking notificationsAvatar
single · group · sizesTooltip & Popover
contextual surfacesBy industry, stack, or engagement type.
לפי תעשייה, סטאק, או סוג התקשרות.
Stat tile
metric · deltaSection header pattern
eyebrow / heading / supportingSoftware, built with taste.
Built for founders who can tell the difference between Vercel/Linear/Stripe-grade craft and generic AI-agency output.
תוכנה, בנויה בטעם.
בנוי ליזמים שיודעים להבחין בין מלאכת מחשבה ברמת 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 · sizesProgress
linear · circular · indeterminateSkeleton
content placeholders · shimmerSlider
single value · range · with ticksDropdown menu
action menu · groups · shortcuts · destructiveWayfinding
breadcrumbs · pagination · stepperCarousel
slides · glass arrows · dot indicatorAdvanced inputs
file upload · OTP · number stepper · dateEmpty state
illustrated containerNo projects active
Tell us what you're building to establish a pipeline.
אין פרויקטים פעילים
ספרו לנו מה אתם בונים כדי להתחיל את העבודה.
Command palette
keyboard-first navLive HeroUI & Pro Components Showcase
Dynamic React & Pro primitivesThese 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 Card Component
This standard card automatically inherits typography rules, background tokens, and spacing parameters.
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 only03 · 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 panelSoftware, 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 servicesCustom 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 demonstratedToggle 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 proofTestimonial card
long-quote layout"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."
"עבדנו עם שלוש סוכנויות לפני CodeByte. הם הראשונים שקראו את הקוד שלנו לפני שכתבו הצעה. המוצר עלה לאוויר ביום שאמרו."
Pricing card layout
three-tier engagementDiscovery sprint
$12k / 2 weeksScope, architecture, and a credible plan of attack.
- Architectural diagram + proposal as code
- Live working prototype
- Fixed cost · two senior engineers
Fixed-scope build
From $80kFrom signed scope to a shipped, instrumented product.
- Sprint cadence, weekly demo
- Production infra, observability, runbooks
- 30-day post-ship hypercare
Retainer
From $24k / monthEmbedded team for ongoing product work.
- 1–3 senior engineers, your stack
- Shared planning + retrospectives
- No contractors, no offshoring
FAQ block
accordion + section headerBefore you brief us.
The questions we hear most before kick-off — answered without marketing.
What's your minimum engagement?
Do you sign NDAs before discovery calls?
Who actually writes the code?
How do you price AI work?
CTA card · glass
end-of-page conversion surfaceSoftware, built with taste.
Tell us what you're building. We reply within one business day.
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
rootsrc/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 introduceColour
- 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