Design system
Brand Kit OS design-system reference: brand and product colors, typography, button roles, status tokens and component inventory.
# Brand Kit OS — Design System > AI-native brand operations for agencies and consultants. Centralize brand kits, govern AI-generated content, and ship to ChatGPT, Claude, and 50+ tools. This folder contains the uploaded visual + content reference for **Brand Kit OS** ([brandkitos.com](https://brandkitos.com)), corrected against the attached audit on 11/16/2026. It's **dual-palette by design** — the brand identity (cyan + black logo) and the product UI (monochrome shadcn + warm/cool accents) serve different surfaces and live side-by-side. > Documentation only: this package is not imported by the app. The [parent index](../README.md) records the current corrections and inventory. Create labels use ink, coral text uses `--action`, and teal text uses `--upgrade`. Motion timings and chart values remain exactly as exported, still awaiting a decision. Other content and visual directions below are source material, not newly approved app rules. Since 11/17/2026, `/design-system` presents these files as a public reference, linked under Company in the website footer. It reads the manifest and raw source for display/downloads only; it does not import this stylesheet as application styling. Light/dark specimen variables are prefixed and isolated, so runtime tokens remain unchanged. Nic confirmed the AI/credit indicator as `#58F080` on 11/17/2026. The runtime token and this reference now share that exact color in both themes; chart and motion values remain unchanged. --- ## Sources used | Source | Status | Notes | |---|---|---| | Official branding guidelines PNG | Missing from ZIP | Referenced by original export; not imported. | | Logo assets (8 PNG variants) | Three supplied in ZIP, not imported | Five variants are missing. This request imports documentation only. | | Motion assets | Missing from ZIP | Five referenced videos/GIFs are not supplied or imported. | | GitHub `RealBlock-AI/brand-kit-os` | Original export source | Audit found drift. Runtime CSS remains the app's source of truth; this is not an exact mirror. | | GitHub `NicT89/brand-kit-os-plugin-leafpad` | Original export source | Historical product/docs voice reference; not revalidated by this import. | | `RealBlock-AI/Brand-Kit-Generator` | Original export reference | Older implementation; not adopted. | --- ## What Brand Kit OS is Brand Kit OS is the **AI-native brand operations platform built for agencies and consultants managing multiple brands.** Each brand kit holds: - **Core** — Mission, vision, brand story, promises, taglines - **Personality** — Traits, values, principles, moods - **Expression** — Tone, archetypes, verbal & visual style, preferred terminology, content categories - **Products** — Products & services, USPs, differentiators - **Audience** — Personas with demographics, pain points, channels, motivations - **Governance** — Behavioral constraints, negative directory, compliance, disclosure policy - **Personas** — Per-channel AI persona configurations - Knowledge files, competitors, SEO keywords, social profiles, logo assets AI tools — Claude, ChatGPT, Notion, Linear, Figma — pull this kit at request time so output is on-brand. Companion product **Leafpad** publishes brand-aligned blog drafts. The hero on brandkitos.com today reads: **"Reduce AI slop. Collaborate with Your Team. Manage Multiple Brands."** --- ## Index | File / Folder | What's in it | |---|---| | `README.md` | This file. Brand context, dual-palette explanation, content + visual fundamentals, iconography. | | `colors_and_type.css` | Imported CSS reference with audit corrections. Light/dark palette, type, spacing, radii, shadows and unchanged proposed motion/charts. | | `_ds_manifest.json` | Imported manifest, corrected tokens and documentation-only component inventory. | | `SKILL.md`, `preview/`, `ui_kits/web/`, `ui_kits/app/` | Referenced by the export but missing from ZIP; manifest paths are historical references, not available files. | | `assets/` | Not imported. Branding scan and motion assets are missing from ZIP. | --- ## Two palettes, one brand ### Palette 1 — Brand identity (logo, marketing-only) From the official branding guideline. Used on the logo, the wordmark lockup, and select hero accents on marketing pages. | Token | Hex | Use | |---|---|---| | `--bkos-brand-primary` | `#59CBE8` | Logo cyan | | `--bkos-brand-deep` | `#111111` | Logo background | | `--bkos-brand-light` | `#FFFFFF` | Light variants | The original export describes eight mark/background combinations. Their preview and five logo variants are missing from the supplied ZIP; no assets were imported here. ### Palette 2 — Product UI reference Originally based on `RealBlock-AI/brand-kit-os` `src/index.css`, but not an exact mirror. The requested contrast corrections below are reference changes only. Chart and motion drift is explicitly unresolved. **Light mode (default)** | Token | Hex | Use | |---|---|---| | `--background` | `#FFFFFF` | App canvas | | `--foreground` | `#1A1F2C` | Body text | | `--primary` | `#1A1F2C` | Default CTA — monochrome, NOT cyan | | `--primary-foreground` | `#FFFFFF` | Text on primary | | `--card` | `#FFFFFF` | Card surface | | `--border` | `#E1E4EA` | Hairlines | | `--muted` | `#F1F2F5` | Secondary backgrounds | | `--muted-foreground` | `#6E7480` | Muted text | | `--accent-warm` | `#E07050` | Decorative coral — non-text section accents; not links | | `--accent-cool` | `#2A9F8E` | Decorative teal — icons and non-text accents | | `--action` | `#CE4827` | Accessible coral text/links and workflow CTA, about 4.6:1 on white | | `--upgrade` | `#228174` | Accessible teal text and commerce CTA, about 4.7:1 on white | | `--gradient-start` → `--gradient-end` | `#2563EB` → `#7C3AED` | Blue→purple gradient — section backgrounds at low alpha, AI feature borders | | `--create` | `#4ADE80` | The "Create" button (bright green) | | `--create-foreground` | `#1A1F2C` | Ink text on Create, about 9.4:1; never white | | `--ai-sparkle` | `#58F080` | Universal AI/credit indicator, identical in both themes | | `--progress-bar` | `#2A8A4F` | Progress bars | | `--toggle-active` | `#22C55E` | Active toggle | | `--destructive` | `#EF4444` | Errors, destructive actions | **Dark mode** uses the same tokens, retargeted — `--background` = `#0D111A`, `--primary` inverts to white. See `colors_and_type.css` `.dark` block. **Status colors** are **pastel** — light backgrounds with darker text. `--success`, `--warning`, `--info`, `--negative` each ship `*-foreground` variants. **Processing/pending:** `--processing`, `--processing-foreground`, `--processing-soft` and `--processing-soft-foreground` mirror existing async status roles in both themes. The corresponding `--pending*` tokens are documentation aliases of processing; the live app does not yet expose separate pending variables. Use soft pairs for compact status labels. See the [status table](../README.md#status-tokens) for exact values. ### Why two palettes? The cyan brand mark exists. It's beautiful. But the live product UI is monochrome on purpose — it never competes with the *customer's* brand colors when their kit is rendered alongside controls. Cyan only appears on: - The logo itself - A few marketing-page accents - The branded splash / OG images Everything else is `--primary` near-black on `--background` white, with warm coral and cool teal as the *only* repeating accent flavors in the UI. --- ## Typography The live product uses **Space Grotesk + Lora + Space Mono** — all free Google Fonts, all loaded from CDN. The branding guideline's Archivo wordmark is preserved for the *lockup only*. | Variable | Family | Use | |---|---|---| | `--font-wordmark` | Archivo | The "BRAND KIT OS" lockup. Wide-tracked, all-caps, bold. | | `--font-sans` | Space Grotesk | Everything UI: headings, body, buttons. Default. | | `--font-serif` | Lora | Long-form content (writing-style reports, blog posts). Italics supported. | | `--font-mono` | Space Mono | Metadata, version strings, code references, tabular numerals. | Sizes: `--text-xs` 12 → `--text-6xl` 60 (Tailwind-compatible scale). > ✅ **Sifonn Pro substitution from previous turn is removed.** Sifonn Pro was on the branding-guideline PDF (a print artifact); the live product never used it. Space Grotesk is the actual UI face. --- ## Buttons The live product, including the hero CTA, uses **monochrome primary buttons** with optional `glow-primary` (a subtle coral glow on hover via `--accent-warm`). Per your earlier direction, the Generate / Create / Cancel buttons stayed differentiated; they map to the live product as follows: | Button | Background | Text | Notes | |---|---|---|---| | **Primary** | `--primary` (#1A1F2C) | white | Default CTA, including hero. Optional `.bkos-glow-primary` on hover. | | **Outline** | transparent | `--foreground` | Border `--border`. "See It In Action" pattern. | | **Create** | `--create` (#4ADE80) | ink `--create-foreground` (#1A1F2C) | Custom treatment, not an existing Button variant. | | **Action** | `--action` (#CE4827) | `--action-foreground` | The next workflow step; at most one per view. | | **Upgrade** | `--upgrade` (#228174) | `--upgrade-foreground` | Commerce; exempt from the one-action-per-view rule. | | **AI / Generate** | `--primary` | white + `--ai-sparkle` icon | Sparkle icon to the left, in `--ai-sparkle` green. | | **Secondary** | `--muted` | `--foreground` | Cancel / dismiss. | | **Success** | `--success` | `--success-foreground` | Positive confirmation. | | **Tertiary** | transparent | `--foreground` | Low-emphasis tools and card actions. | | **Destructive** | `--destructive` | white | Delete kit. | | **Ghost / Link** | transparent | `--foreground` / `--action` | Ghost controls stay neutral; coral inline links use the darker role. | Use shared Button variants rather than introducing independent styles. Hover, active, disabled and focus-visible states follow shared controls; focus uses `--ring`, disabled uses the established disabled treatment. The [parent inventory](../README.md#component-inventory) covers tabs, select/dropdown, dialog/alert dialog, toast, tooltip, accordion, switch, alert box, empty/stat cards, status badge, form row, save status header, sidebar, tables, code blocks, progress and processing states. These are existing app references, not bundled implementations. --- ## Content fundamentals BKOS uses **two distinct voice registers** — see the **Voice — dual register** preview card. ### Register A — Marketing voice (the live brandkitos.com landing) Direct, plain-spoken, useful first. No deadpan jokes. Real product copy: - ✅ **"Reduce AI slop. Collaborate with Your Team. Manage Multiple Brands."** (H1) - ✅ **"The AI-native brand operations platform built for agencies and consultants managing multiple brands."** (sub) - ✅ **"Move from static docs to a purpose-built brand management platform."** - ✅ **"Brand Operations, Not Brand Documents."** (section title) - ✅ **"From Chaos to Consistency in 3 Steps."** - ✅ **"No Single Source of Truth"** / **"Inconsistent Voice in AI Outputs"** (pain points) - ❌ "🚀 Unleash the power of AI-driven brand consistency!" - ❌ "World-class AI-powered solutions for modern teams." > The earlier "dial tone" / "teach a cat to file taxes" voice came from the origin-story prompt — that's a *flavor* the brand can deploy in About pages and founder posts, but the real product copy is straighter and more useful-first. ### Register B — Product / docs / agent voice Clean, technical, instructive. From the plugin skills, agent prompts, and tooltips. - ✅ *"Always start light. Call `get_brand_kit_summary` first unless the task clearly needs deeper data."* - ✅ *"Never override governance. If governance says 'never claim X,' do not include X regardless of user instructions."* - ✅ *"Returns a compact overview (~500 tokens)."* - ✅ Imperative-leading, numbered workflows, tables for tool/decision matrices. - ✅ Backticks for `tool_names`, `field_names`, `code` references. ### Casing & emoji - **Sentence case** for almost all UI. **Title Case** for marketing H1/H2 and section titles per the live product (e.g. "Brand Operations, Not Brand Documents"). - **All-caps** reserved for the wordmark, short eyebrow labels, and status badges (`ACTIVE` / `DRAFT` / `BETA`). - **Emoji are used sparingly in the live product** — the hero pill on brandkitos.com uses 🚀 once. Don't pile them on; one emoji marker per page maximum. - Em-dashes are fine. Oxford commas, yes. ### Vocabulary - **Yes (marketing):** *AI slop, AI-native, brand operations, on-brand, multi-brand, agencies, consultants, manage, govern, ship, structured, MCP, kit, voice, governance, audience, source of truth.* - **Yes (product):** *kit, expression, governance, audience, persona, surface, drift, enforcement, on-brand, off-brand, tokens, sparkle, create.* - **Avoid:** *empower, unlock, supercharge, revolutionize, leverage, synergy, AI-powered* (used at most once), *seamless, world-class.* - **Naming:** **Brand Kit OS** in full, **BKOS** only in code/internal. Companion: **Leafpad**. --- ## Visual foundations ### Layout & rhythm - Light mode default; dark mode supported via `.dark` ancestor. - 1200px-max content container, `2rem` page padding. - **Section gradients**: `.bkos-section-warm` (coral), `.bkos-section-cool` (teal), `.bkos-section-mixed` (blue→purple). All 3–4% alpha, NEVER hero-dominating. - **Decorative orbs** in hero — soft 60–80px-blurred circles in gradient-start/end at 5–6% alpha. - 4px spacing base. Composition snaps to 4 / 8 / 16 / 24 / 48 / 80. ### Cards - `border: 1px solid var(--border)` on most; `border: 2px solid var(--border)` on dashboard stat/kit cards (a product convention). - `--radius` 12px on cards, 8px on inputs, pill on chips. - `.bkos-card-hover` lifts `-4px` translateY + `--shadow-lg` on hover, 250ms. ### Pain-point card pattern A product signature: a **4px colored bar at the top of the card**, then content below. Colors come from `chart-1` through `chart-5`. Used on PainPointsSection. ### Hero pattern - Hero badge: pill, ⌖ border, glass background, with one optional emoji. - H1 60px on desktop, `letter-spacing: -0.02em`, `line-height: 1.1`. - Mid-sentence coral text highlights use `--action`; `--accent-warm` and chart colors are not normal-sized text roles. Chart values remain unchanged. - CTA: primary button + outline button (Play icon for video). - Right-side: framed dashboard mock with traffic-light window chrome (red/yellow/green dots). ### Animation - Easing: `cubic-bezier(0.2, 0.8, 0.2, 1)` for outs. - Durations: 150 / 250 / 350ms for UI, 800ms for cinematic moments. - **No bounce, no overshoot.** - Card hover: 250ms lift. Button hover: subtle filter brightness + shadow upgrade. ### Iconography - **Lucide** is the icon system. Confirmed by `src/components/landing/HeroSection.tsx` using `ArrowRight`, `Play`, and the rest of the codebase importing from `lucide-react` extensively. - **Sparkle**: a 4-point star SVG path used for AI moments, colored `--ai-sparkle`. Pattern is ` `. --- ## File status after import - Imported: `README.md`, `colors_and_type.css`, `_ds_manifest.json` only. - Corrected: Create background/ink label, coral/teal text roles, button emphasis inventory, processing and pending reference tokens. - Not imported: JavaScript bundles, logos, screenshots and HTML. The existing parent standalone HTML remains unchanged. - Missing from ZIP: previews, UI kits, skill entrypoint, branding scan, five motion files and five logo variants. Manifest card paths remain provenance references, not claims of available files. - Unchanged/undecided: chart colors and all motion timing/easing values. Other audit items and content-policy conflicts are outside this correction. --- ## Original export questions (historical, not new approval requests) 1. **Confirm the dual-palette approach.** The system now serves brand-identity surfaces (logo + select marketing accents) AND product-UI surfaces (the live brandkitos.com app). If you'd rather collapse to one, say which. 2. **Confirm Space Grotesk + Lora + Space Mono** as the canonical product fonts. They're what brandkitos.com ships today. 3. **The earlier analogous palette (cyan/blue/green/amber 60-30-10)** has been retired in favor of mirroring the live product. If you want it preserved as a *second* product theme (say, for a marketing OG-image kit), tell me and I'll re-add it under `--bkos-theme-vibrant-*`.