npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@creative-os/core

v3.0.0

Published

Creative OS — SOTD-tier design and engineering framework, tokens, components, patterns, and MCP server

Readme

Creative Operating System (COS)

Creative OS is a high-discipline, metadata-driven design and engineering framework engineered to systematically eliminate generic, template-driven user interfaces in favor of editorial, visually differentiated digital products. By establishing a unified registry of design tokens, development paradigms, and empirical agency benchmarks, the system provides creative teams with the strategic blueprints, visual constraints, and pre-release audit systems required to deliver Awwwards-tier visual craft and measurable business authority.

Overview

Creative OS exists to solve the progressive homogenization of modern web design, commonly characterized by generic card systems, glowing gradient borders, and boilerplate copywriting. Traditional product development workflows separate strategic brand discovery, design layout phase, and frontend engineering into isolated silos, which dilutes visual intent and compromises performance budgets.

This framework solves these coordination failures by:

  • Unifying brand strategy, content design, layout engineering, and motion physics into a single traceable system.
  • Mapping digital interfaces to verified visual and technical benchmarks from world-class creative studios and digital agencies.
  • Enforcing strict performance and design tokens budgets programmatically to prevent visual drift during the development lifecycle.
  • Providing role-based review gates to ensure that visual craftsmanship and code quality remain aligned with client business objectives.

The system is designed for multi-disciplinary product teams, including designers, developers, brand strategists, creative directors, and founders, who aim to build digital experiences that establish category dominance and justify premium pricing models.

Core Philosophy

The design philosophy of Creative OS is rooted in the rejection of standard, template-driven web aesthetics in favor of visual tension, typographical structure, and absolute visual restraint. The system operates on the following core principles:

  • Asymmetric Grid Balance: Symmetrical alignments are rejected. Visual interest is generated by balancing large, clean display typography against extensive negative space and offset imagery.
  • Typography as Structure: Grids and containers are built around typographical blocks first. Layout containers are constructed to contain text, rather than forcing text to conform to arbitrary boxes.
  • High Contrast, Curated HSL Spaces: Saturated primary colors and raw hex codes are replaced with mathematically precise HSL harmonies, anchoring interfaces on warm or cool off-whites, obsidian canvases, and single, high-discipline accent tones.
  • Motion as Attention Pacing: Animation is treated as a narrative pacing mechanism rather than decoration. Transitions are designed to map to native scroll behaviors, guiding user attention through choreographic beats without introducing interface latency.
  • Traceable Design Integrity: Every design choice must be traceable to a verified benchmark or a strategic brand decision, preventing aesthetic drift and maintaining high operational standards.

System Architecture

Creative OS is structured as a collection of interdependent modules that govern the lifecycle of a digital project from initial kickoff to final deployment.

                                 [ Strategy Layer ]
                     Kickoff Brief -> Research -> Intelligence
                                         │
                                         ▼
                                 [ Core Design OS ]
                     Typography -> Color -> Visual Rules & Tokens
                                         │
                                         ▼
                               [ Interactive Layer ]
                     Layout Engine -> Motion -> Interaction
                                         │
                                         ▼
                               [ Engineering Layer ]
                     Frontend Architecture -> Creative Tech -> Components
                                         │
                                         ▼
                                 [ Quality & QA ]
                     Design Decision Engine -> Awwwards Scorecard -> QA Gates

Module Responsibilities

  • Strategy Module: Establishes brand positioning, conducts competitive audits, and translates business goals into storytelling narrative beats.
  • Design System Module: Declares the typographic scales, color spaces, spacing constraints, and structural rules that define the visual system.
  • Interactive Module: Choreographs scroll transitions, controls custom pointer physics, and handles layout grids.
  • Engineering Module: Manages Vite-based chunk-splitting budgets, WebGL canvas overrides, and accessible component architectures.
  • Quality QA Module: Runs automated traceability validations and scoring checklists to verify that the build meets elite performance and visual criteria.

Information Flow

Information flows linearly from the strategic brief down to the design token configuration, which compiles into semantic code. During this flow, downstream engineering components dynamically query the typography scales and layout tokens to ensure structural compliance. The review and QA files act as a feedback loop, forcing layout revisions whenever visual or performance metrics fall below the established thresholds.

Repository Structure

The project files are organized into dedicated system directories:

creative-os/
├── 00_CREATIVE_OS_INDEX.md
├── PROJECT_BRIEF_TEMPLATE.md
├── architecture/
│   ├── 08_LAYOUT_ENGINE.md
│   ├── 11_FRONTEND_ARCHITECTURE.md
│   └── 37_CREATIVE_TECH_SYSTEM.md
├── design/
│   ├── 01_DESIGN_OS.md
│   ├── 02_ART_DIRECTION.md
│   ├── 03_VISUAL_RULES.md
│   ├── 04_TYPOGRAPHY_SYSTEM.md
│   ├── 10_COLOR_SYSTEM.md
│   └── 14_DESIGN_ANTI_PATTERNS.md
├── interaction/
│   └── 06_INTERACTION_SYSTEM.md
├── libraries/
│   ├── 24_WORLD_CLASS_BENCHMARKS.md
│   ├── 28_LAYOUT_PATTERNS_LIBRARY.md
│   ├── 29_CASE_STUDY_LIBRARY.md
│   ├── 34_VISUAL_LANGUAGE_LIBRARY.md
│   ├── 44_SYSTEM_PROMPTS_LIBRARY.md
│   ├── 45_BENCHMARK_TRACEABILITY_SYSTEM.md
│   └── 46_BENCHMARK_DECISION_MATRIX.md
├── motion/
│   ├── 05_MOTION_SYSTEM.md
│   ├── 26_ANIMATION_LIBRARY.md
│   └── 27_SCROLL_STORY_LIBRARY.md
├── review/
│   ├── 12_CREATIVE_QA.md
│   ├── 13_AGENCY_REVIEW_SYSTEM.md
│   ├── 20_DESIGN_DECISION_ENGINE.md
│   ├── 21_AWWWARDS_EVALUATION_SYSTEM.md
│   ├── 22_CREATIVE_DIRECTION_GENERATOR.md
│   ├── 25_FINAL_CREATIVE_REVIEW.md
│   └── 41_DESIGN_GOVERNANCE_SYSTEM.md
├── strategy/
│   ├── 07_STORYTELLING_SYSTEM.md
│   ├── 15_BRAND_STRATEGY_OS.md
│   ├── 16_INFORMATION_ARCHITECTURE.md
│   ├── 17_CONVERSION_ARCHITECTURE.md
│   ├── 18_PREMIUM_PERCEPTION_SYSTEM.md
│   ├── 36_CONTENT_DESIGN_SYSTEM.md
│   ├── 38_DESIGN_RESEARCH_SYSTEM.md
│   ├── 39_BUSINESS_STRATEGY_SYSTEM.md
│   ├── 40_EXPERIENCE_ARCHITECTURE_SYSTEM.md
│   ├── 42_CREATIVE_INTELLIGENCE_SYSTEM.md
│   └── 43_PROJECT_KICKOFF_SYSTEM.md
└── tokens/
    ├── 35_DESIGN_TOKENS.json
    └── 35_DESIGN_TOKENS.md

Directory Roles and Purposes

  • root: Houses the 00_CREATIVE_OS_INDEX.md registry, the PROJECT_BRIEF_TEMPLATE.md, and validation scripts.
  • architecture: Contains the layout configurations, build budgets, and WebGL execution plans.
  • design: Hosts the core visual guidelines, including art direction, typography scale, HSL color system, and the design anti-pattern checklists.
  • interaction: Configures pointer tracking, magnetic cursor pulls, and touch overrides.
  • libraries: Contains the benchmark profiles, visual templates, case study guides, and system prompts.
  • motion: Governs animation physics, transition speeds, and scroll storytelling progress transforms.
  • review: Holds the pre-launch checklists, Awwwards scorecards, role audits, and design governance protocols.
  • strategy: Outlines the strategic intelligence framework, information paths, conversion strategies, copy guidelines, and kickoff workshop plans.
  • tokens: Defines the programmatic HSL colors, typography scales, layout spaces, and motion constants.

Framework Components

01_DESIGN_OS

  • Purpose: Establishes the core visual guidelines and rules that reject generic web layouts.
  • Key Responsibilities: Enforcing asymmetric visual balance, maintaining negative space budgets, and providing layout templates.
  • Inputs: Strategic brand targets and selected creative directions.
  • Outputs: CSS layouts, clean DOM components, and layout parameters.
  • Dependencies: 04_TYPOGRAPHY_SYSTEM.md.
  • Usage: Reference as the foundational layout framework for all marketing canvases.

02_ART_DIRECTION

  • Purpose: Outlines emotional and aesthetic parameters for photography, lighting, and imagery.
  • Key Responsibilities: Setting composition standards, maintaining desaturated color temperatures, and specifying vertical asset ratios.
  • Inputs: Selected imagery assets, SVGs, and brand style configurations.
  • Outputs: Art-directed CSS media blocks and responsive HTML photo containers.
  • Dependencies: 01_DESIGN_OS.md.
  • Usage: Apply style classes to product imagery and portfolio showcases.

03_VISUAL_RULES

  • Purpose: Enforces geometric grid alignments, padding, and negative space limits.
  • Key Responsibilities: Maintaining a 40% empty canvas budget, applying Golden Ratio padding, and defining offset viewport margins.
  • Inputs: Media assets and viewport dimensions.
  • Outputs: Responsive spacing grids, column offsets, and CSS margins.
  • Dependencies: 01_DESIGN_OS.md.
  • Usage: Structure container files using asymmetric spacing grid templates.

04_TYPOGRAPHY_SYSTEM

  • Purpose: Establishes dynamic typography scales, font pairings, and pacing rules.
  • Key Responsibilities: Executing viewport clamp formulas, managing leading-to-size compression ratios, and adjusting letter tracking.
  • Inputs: Viewport width values and text fields.
  • Outputs: CSS typography variables (--font-display, --font-body) and font scale classes.
  • Dependencies: None.
  • Usage: Define all typography baseline structures using relative units (rem, em).

05_MOTION_SYSTEM

  • Purpose: Standardizes physics-based animations, exit curves, and transit speeds.
  • Key Responsibilities: Setting custom cubic-bezier properties and limiting transition durations.
  • Inputs: Interaction events and UI state triggers.
  • Outputs: Framer Motion JS configs and custom CSS transition curves.
  • Dependencies: 01_DESIGN_OS.md.
  • Usage: Reference transition constants for modals, slide-ins, and page navigation.

06_INTERACTION_SYSTEM

  • Purpose: Controls pointer behavior, cursor transitions, and magnetic hover ranges.
  • Key Responsibilities: Tracking cursor coordinates, applying movement lag, and bypassing mobile touch events.
  • Inputs: Mouse movement coordinates and pointer target fields.
  • Outputs: React cursor elements and magnetic hover effects.
  • Dependencies: 05_MOTION_SYSTEM.md.
  • Usage: Mount custom pointer tracking scripts on creative views.

07_STORYTELLING_SYSTEM

  • Purpose: Sequences webpage content into five cinematic narrative beats.
  • Key Responsibilities: Hooking user attention, presenting problem tension, revealing solution details, displaying validation metrics, and guiding users to primary steps.
  • Inputs: Brand copywriting lines and case study outputs.
  • Outputs: Scroll-linked storytelling rows and React storytelling containers.
  • Dependencies: 15_BRAND_STRATEGY_OS.md.
  • Usage: Sequence landing layouts based on storytelling beat files.

08_LAYOUT_ENGINE

  • Purpose: Coordinates asymmetric layouts and overlaps across grid layers.
  • Key Responsibilities: Shifting description margins, positioning sticky headings, and structuring vertical image spans.
  • Inputs: Layout components and viewport width targets.
  • Outputs: 12-column grid architectures and offset margin alignments.
  • Dependencies: 03_VISUAL_RULES.md.
  • Usage: Build major marketing layout grids using asymmetric column classes.

09_COMPONENT_SYSTEM

  • Purpose: Outlines lightweight, semantic UI components.
  • Key Responsibilities: Ensuring keyboard accessibility and preventing design tokens bypasses.
  • Inputs: User input events and design tokens properties.
  • Outputs: Keyboard-navigable UI modules.
  • Dependencies: 35_DESIGN_TOKENS.json.
  • Usage: Implement accordions, tabs, and modals using semantic components.

10_COLOR_SYSTEM

  • Purpose: Standardizes HSL color spaces and WCAG AA contrast compliance.
  • Key Responsibilities: Mapping HSL color variables and enforcing contrast boundaries.
  • Inputs: Hex target themes and dark mode preferences.
  • Outputs: Programmatic CSS color mappings.
  • Dependencies: 08_LAYOUT_ENGINE.md.
  • Usage: Declare background fills and typography colors using color variables.

11_FRONTEND_ARCHITECTURE

  • Purpose: Sets performance budgets and Vite chunk-splitting setups.
  • Key Responsibilities: Restricting bundle sizes, executing dynamic imports, and checking assets file types.
  • Inputs: Source code files and compiler targets.
  • Outputs: Optimised Vite builds.
  • Dependencies: 35_DESIGN_TOKENS.json.
  • Usage: Run build commands to inspect chunk sizes against performance budgets.

12_CREATIVE_QA

  • Purpose: Outlines visual, performance, and accessibility checks.
  • Key Responsibilities: Reviewing layout alignment, testing layout shifting, and auditing loading budgets.
  • Inputs: Development builds.
  • Outputs: Quality checklists and error reports.
  • Dependencies: 21_AWWWARDS_EVALUATION_SYSTEM.md.
  • Usage: Perform pre-release reviews on staging environments.

13_AGENCY_REVIEW_SYSTEM

  • Purpose: Coordinates role-based review checks for directors.
  • Key Responsibilities: Auditing brand strategy, reviewing design alignment, and inspecting performance logs.
  • Inputs: Complete page builds.
  • Outputs: Review logs and approval records.
  • Dependencies: 12_CREATIVE_QA.md.
  • Usage: Conduct review workshops before final deployment.

14_DESIGN_ANTI_PATTERNS

  • Purpose: Catalogues design patterns to avoid.
  • Key Responsibilities: Banning bento cards, neon glows, glassmorphism, and scrolljacking loops.
  • Inputs: Layout concept layouts.
  • Outputs: Compliance scorecard reviews.
  • Dependencies: 01_DESIGN_OS.md.
  • Usage: Cross-reference layout concepts during the visual review phase.

15_BRAND_STRATEGY_OS

  • Purpose: Maps projects to brand archetypes and strategic positionings.
  • Key Responsibilities: Aligning designs with archetypes, mapping moats, and setting visual constraints.
  • Inputs: Kickoff briefs.
  • Outputs: Brand archetypes and style guidelines.
  • Dependencies: 43_PROJECT_KICKOFF_SYSTEM.md.
  • Usage: Align visual direction templates with chosen archetypes.

16_INFORMATION_ARCHITECTURE

  • Purpose: Defines clean navigation structures.
  • Key Responsibilities: Enforcing click limits, setting header item caps, and structuring fullscreen menus.
  • Inputs: Page maps.
  • Outputs: Overlay menus and footer templates.
  • Dependencies: 08_LAYOUT_ENGINE.md.
  • Usage: Construct navigation bars using overlay templates.

17_CONVERSION_ARCHITECTURE

  • Purpose: Coordinates high-intent user journeys.
  • Key Responsibilities: Delaying CTA button displays, embedding inline gateways, and creating context-rich links.
  • Inputs: Copywriting files and product details.
  • Outputs: Form components.
  • Dependencies: 16_INFORMATION_ARCHITECTURE.md.
  • Usage: Embed contact gateways inside layout narratives.

18_PREMIUM_PERCEPTION_SYSTEM

  • Purpose: Outlines guidelines for visual restraint and exclusivity.
  • Key Responsibilities: Minimising branding components, setting wide margins, and aligning layout offsets.
  • Inputs: Design briefs and assets catalogs.
  • Outputs: Tailwind layout blocks.
  • Dependencies: 17_CONVERSION_ARCHITECTURE.md.
  • Usage: Apply visual style rules to product showcase panels.

19_ENTERPRISE_CLIENT_SYSTEM

  • Purpose: Coordinates stakeholder presentation workflows and compliance checks.
  • Key Responsibilities: Preparing interactive prototypes, running performance logs, and checking approvals.
  • Inputs: Staging builds.
  • Outputs: Presentation briefs and compliance checklists.
  • Dependencies: 09_COMPONENT_SYSTEM.md.
  • Usage: Package staging builds for enterprise approvals.

20_DESIGN_DECISION_ENGINE

  • Purpose: Validates design directions using a 10-point checklist.
  • Key Responsibilities: Testing brand narratives, checking visual durability, and auditing layout originality.
  • Inputs: Page mockup files.
  • Outputs: Approval registers.
  • Dependencies: 14_DESIGN_ANTI_PATTERNS.md.
  • Usage: Run reviews on mockup files before coding starts.

21_AWWWARDS_EVALUATION_SYSTEM

  • Purpose: Scores project builds against global design standards.
  • Key Responsibilities: Rating visual design, creativity, accessibility, and content innovation.
  • Inputs: Complete page builds.
  • Outputs: Scorecard reports.
  • Dependencies: 20_DESIGN_DECISION_ENGINE.md.
  • Usage: Evaluate builds before scheduling launch dates.

22_CREATIVE_DIRECTION_GENERATOR

  • Purpose: Defines 11 distinct creative directions to explore during discovery.
  • Key Responsibilities: Presenting style pairings, color templates, and typography sets.
  • Inputs: Brand kickoff details.
  • Outputs: Three visual direction concepts.
  • Dependencies: 41_DESIGN_GOVERNANCE_SYSTEM.md.
  • Usage: Select and draft three distinct visual directions during week 1.

23_FUTURE_PROOFING_SYSTEM

  • Purpose: Manages code isolation, naming patterns, and dependency updates.
  • Key Responsibilities: Auditing frameworks, isolating custom code, and updating packages.
  • Inputs: Project dependencies logs.
  • Outputs: Dependency audits.
  • Dependencies: 19_ENTERPRISE_CLIENT_SYSTEM.md.
  • Usage: Run audits quarterly to check code status.

24_WORLD_CLASS_BENCHMARKS

  • Purpose: Stores profiles of top digital design agencies and products.
  • Key Responsibilities: Logging principles, mapping influences, and scoring performance.
  • Inputs: Benchmark links.
  • Outputs: Style matrices.
  • Dependencies: 25_FINAL_CREATIVE_REVIEW.md.
  • Usage: Reference style profiles to resolve layout conflicts.

25_FINAL_CREATIVE_REVIEW

  • Purpose: Runs pre-launch checks and coordinates lead approvals.
  • Key Responsibilities: Enforcing code freezes, verifying tokens compliance, and checking performance.
  • Inputs: Production code builds.
  • Outputs: Final approval logs.
  • Dependencies: 22_CREATIVE_DIRECTION_GENERATOR.md.
  • Usage: Complete final checks 48 hours before launch.

26_ANIMATION_LIBRARY

  • Purpose: Provides Framer Motion, GSAP, and CSS transitions presets.
  • Key Responsibilities: Exporting layout transitions, text reveals, and hover dynamics.
  • Inputs: DOM triggers.
  • Outputs: React animations.
  • Dependencies: 05_MOTION_SYSTEM.md.
  • Usage: Use preset modules for page element reveals.

27_SCROLL_STORY_LIBRARY

  • Purpose: Manages scroll choreography and pacing.
  • Key Responsibilities: Scaling content, transforming opacity, and providing mobile fallbacks.
  • Inputs: Scroll progress values.
  • Outputs: Animated overlays.
  • Dependencies: 06_INTERACTION_SYSTEM.md.
  • Usage: Build scroll-linked presentation views.

28_LAYOUT_PATTERNS_LIBRARY

  • Purpose: Collects approved CSS grid and column templates.
  • Key Responsibilities: Providing asymmetrical columns and monolithic splits.
  • Inputs: Page data.
  • Outputs: CSS grids.
  • Dependencies: 24_WORLD_CLASS_BENCHMARKS.md.
  • Usage: Frame section layouts using approved patterns.

29_CASE_STUDY_LIBRARY

  • Purpose: Defines templates for outcome-centered case studies.
  • Key Responsibilities: Formatting metadata sidebars, styling displays, and managing grids.
  • Inputs: Project copy.
  • Outputs: Case study views.
  • Dependencies: 28_LAYOUT_PATTERNS_LIBRARY.md.
  • Usage: Format projects using structured template files.

30_ENTERPRISE_UX_SYSTEM

  • Purpose: Sets data display and layout rules for enterprise products.
  • Key Responsibilities: Styling data tables, managing details view spacing, and optimizing charts.
  • Inputs: Structured datasets.
  • Outputs: Data grids.
  • Dependencies: 09_COMPONENT_SYSTEM.md.
  • Usage: Build administration panels using grid styling classes.

31_LUXURY_BRAND_SYSTEM

  • Purpose: Guides visual restraint and margins for luxury sites.
  • Key Responsibilities: Setting wide margins, pacing content, and applying image ratios.
  • Inputs: High-end product listings.
  • Outputs: Typography frameworks.
  • Dependencies: 09_COMPONENT_SYSTEM.md.
  • Usage: Set product landing pages using vertical image layouts.

32_AI_PRODUCT_SYSTEM

  • Purpose: Sets layouts and UI components for AI products.
  • Key Responsibilities: Building input containers, styling status states, and formatting outputs.
  • Inputs: Dynamic model queries.
  • Outputs: Input elements.
  • Dependencies: 09_COMPONENT_SYSTEM.md.
  • Usage: Structure AI response grids using component states.

33_PORTFOLIO_SYSTEM

  • Purpose: Guides asymmetric layouts and galleries for portfolios.
  • Key Responsibilities: Offsetting thumbnails, mapping transitions, and building filters.
  • Inputs: Agency project items.
  • Outputs: Image galleries.
  • Dependencies: 09_COMPONENT_SYSTEM.md.
  • Usage: Build gallery pages using offset columns.

34_VISUAL_LANGUAGE_LIBRARY

  • Purpose: Stores SVG overlays and textures.
  • Key Responsibilities: Exporting grid masks, noise filters, and light backdrops.
  • Inputs: Page container coordinates.
  • Outputs: SVG code blocks.
  • Dependencies: 29_CASE_STUDY_LIBRARY.md.
  • Usage: Add textures using background overlay classes.

35_DESIGN_TOKENS

  • Purpose: Serves as the programmatic source of truth for variables.
  • Key Responsibilities: Declaring colors, typography clamp values, spacing margins, and motion constants.
  • Inputs: Theme preferences.
  • Outputs: JSON/Markdown token constants.
  • Dependencies: 04_TYPOGRAPHY_SYSTEM.md.
  • Usage: Reference tokens variables inside styles and layout configurations.

36_CONTENT_DESIGN_SYSTEM

  • Purpose: Outlines copywriting rules and language archetypes.
  • Key Responsibilities: Limiting text length, enforcing active voice, and framing headlines.
  • Inputs: Product specs copy.
  • Outputs: Text modules.
  • Dependencies: 40_EXPERIENCE_ARCHITECTURE_SYSTEM.md.
  • Usage: Filter product copywriting against text line limits.

37_CREATIVE_TECH_SYSTEM

  • Purpose: Manages WebGL strategy and 3D canvas loads.
  • Key Responsibilities: Setting FPS limits, checking device support, and limiting draw calls.
  • Inputs: 3D scene settings.
  • Outputs: React Three Fiber canvases.
  • Dependencies: 11_FRONTEND_ARCHITECTURE.md.
  • Usage: Mount WebGL elements inside performance monitor containers.

38_DESIGN_RESEARCH_SYSTEM

  • Purpose: Standardizes competitor visual audits and mapping.
  • Key Responsibilities: Analyzing competitor failures, plotting style grids, and sourcing print ideas.
  • Inputs: Competitor research items.
  • Outputs: Visual territory grids.
  • Dependencies: 42_CREATIVE_INTELLIGENCE_SYSTEM.md.
  • Usage: Map competitor positions during kickoff workshops.

39_BUSINESS_STRATEGY_SYSTEM

  • Purpose: Aligns layout choices with business models.
  • Key Responsibilities: Mapping moats, detailing categories, and structuring price options.
  • Inputs: Discovery briefs.
  • Outputs: Value proposition statements.
  • Dependencies: 01_DESIGN_OS.md.
  • Usage: Position primary product moats inside hero sections.

40_EXPERIENCE_ARCHITECTURE_SYSTEM

  • Purpose: Guides user journey design and pacing.
  • Key Responsibilities: Structuring attention pacing, building curiosity elements, and managing routes.
  • Inputs: Storytelling copy beats.
  • Outputs: Curiosity elements.
  • Dependencies: 07_STORYTELLING_SYSTEM.md.
  • Usage: Map user journeys based on product type.

41_DESIGN_GOVERNANCE_SYSTEM

  • Purpose: Enforces tokens use and checks styling overrides.
  • Key Responsibilities: Running style linters, checking custom code overrides, and planning audits.
  • Inputs: Component stylesheets.
  • Outputs: Styling audit logs.
  • Dependencies: 13_AGENCY_REVIEW_SYSTEM.md.
  • Usage: Run linter commands during code packaging.

42_CREATIVE_INTELLIGENCE_SYSTEM

  • Purpose: Gathers strategic inputs using three questions.
  • Key Responsibilities: Answering moat questions, validating risks, and planning decisions.
  • Inputs: Client details.
  • Outputs: Decision blueprints.
  • Dependencies: 39_BUSINESS_STRATEGY_SYSTEM.md.
  • Usage: Document strategic inputs during discovery phases.

43_PROJECT_KICKOFF_SYSTEM

  • Purpose: Coordinates kickoff workshops and interviews.
  • Key Responsibilities: Running visual direction checks, interviewing stakeholders, and setting KPIs.
  • Inputs: Client briefs.
  • Outputs: Goal worksheets.
  • Dependencies: 38_DESIGN_RESEARCH_SYSTEM.md.
  • Usage: Structure discovery workshops during week 1.

44_SYSTEM_PROMPTS_LIBRARY

  • Purpose: Stores reusable system prompts for development.
  • Key Responsibilities: Exporting developer configurations, copy guidelines, and QA rules.
  • Inputs: AI task targets.
  • Outputs: Prompts strings.
  • Dependencies: 34_VISUAL_LANGUAGE_LIBRARY.md.
  • Usage: Inject prompts configurations during build phases.

45_BENCHMARK_TRACEABILITY_SYSTEM

  • Purpose: Logs direct website inspections and secondary findings.
  • Key Responsibilities: Tracking research status, mapping influences, and scoring confidence.
  • Inputs: Live website checks.
  • Outputs: Traceability status reports.
  • Dependencies: 44_SYSTEM_PROMPTS_LIBRARY.md.
  • Usage: Run checks to verify benchmark details.

46_BENCHMARK_DECISION_MATRIX

  • Purpose: Mappings benchmarks to project categories.
  • Key Responsibilities: Choosing primary sources, avoiding styles, and resolving layout conflicts.
  • Inputs: Project brief template variables.
  • Outputs: System lists.
  • Dependencies: 24_WORLD_CLASS_BENCHMARKS.md.
  • Usage: Check the matrix table during kickoff to select baseline styles.

Design System

The visual design system of Creative OS translates the core philosophy into responsive styles using tokens:

  • Visual Principles: Focuses on asymmetrical balance, visual tension, and positive space isolation.
  • Layout Methodology: Implements a 12-column grid system where elements are offset by specific track numbers. It avoids bento structures, using open, editorial column shifts instead.
  • Typography Approach: Uses dynamic scales driven by clamp viewport equations. Sizing and tracking are adjusted dynamically to compress line heights for displays while opening letter spaces for metadata.
  • Motion Philosophy: Anchors animation on mechanical weight, friction, and drag. CSS transitions use custom bezier curves, and scroll animations map progress to native scroll hooks, avoiding scrolljacking.
  • Interaction Patterns: Combines custom pointer tracking with smooth lag interpolation. Magnetic classes pull cursors toward buttons, and hover events reveal monospaced labels nearby.
  • Design Token Structure: Programmatic token files coordinate warm ivory/obsidian scales, typography sizes, relative margins, custom motion bezier curves, and grid definitions.

Experience Architecture

The experience architecture maps page interactions to user journeys:

  • User Journey Thinking: Starts with a minimal, high-tension statement or hook to build curiosity. Users are guided through a paced narrative that reveals features gradually.
  • Storytelling Systems: Uses five cinematic beats (Hook, Tension, Reveal, Proof, Gateway) to structure layouts. Section reads are kept short, and scroll triggers reveal text blocks sequentially.
  • Information Architecture: Restricts header navigation menus to 4 options. Fullscreen overlays replace traditional multi-tier dropdown menus, and secondary paths are offloaded to footers.
  • Conversion Architecture: CTAs are removed from primary heroes. Users are transitioned into high-intent flows through inline inputs or text invitations embedded in case study copy.
  • Experience Design Methodology: Focuses on continuous, smooth route transitions that maintain visual identity across states, customising the path for luxury launches, dev platforms, or enterprise hubs.

Development Workflow

The development workflow coordinates project execution:

[Kickoff/Discovery] ──> [Strategy & Research] ──> [Architecture & Tokens]
                                                               │
                                                               ▼
[Final Deployment]  <──   [QA & Role Audits]   <──   [Layout & Development]
  1. Research: Conduct competitive audits and plot visual territory grids. Sourced inspiration comes from print publications, editorial layouts, and industrial designs rather than templates.
  2. Strategy: Populate kickoff briefs using the 8 parameters, select target directions, and answer the three strategic questions (Moat, Sacrifice, Price) to build decision blueprints.
  3. Architecture: Establish baseline typography scales, configure Vite Manual Chunk parameters, and outline WebGL performance rules.
  4. Design: Build layouts around text blocks using relative units, setting warm HSL canvases, wide margins, and custom pointer trackers.
  5. Development: Implement views using semantic HTML containers, Framer Motion transitions, and design token classes, avoiding custom utility overrides.
  6. Review: Pass builds through role reviews, where directors verify storytelling alignment, typographic hierarchy, and accessibility metrics.
  7. Delivery: Enforce code freezes 48 hours before deployment. Runs audits to verify that speed index and bundle budgets match targets before release.

File Relationships

Understanding the dependency hierarchy is critical for system modifications:

      35_DESIGN_TOKENS (JSON) <── Programmatic Source of Truth
               │
               ├─> 04_TYPOGRAPHY_SYSTEM  (Baseline typography scales)
               │            │
               │            ├─> 08_LAYOUT_ENGINE (Asymmetric grid structures)
               │            │            │
               │            │            └─> 01_DESIGN_OS (Core layout configurations)
               │            │
               │            └─> 10_COLOR_SYSTEM (HSL contrast scales)
               │
               └─> 11_FRONTEND_ARCHITECTURE (Build budgets & performance checks)
  • Foundational Files: 35_DESIGN_TOKENS.json acts as the program source of truth. All downstream systems query 04_TYPOGRAPHY_SYSTEM.md to confirm font scales before initializing 08_LAYOUT_ENGINE.md.
  • Dependent Files: Component layout and styling files depend on design tokens. Copywriting and interactive story files depend on experience architecture rules.
  • Recommended Reading Order:
    1. Master Index: 00_CREATIVE_OS_INDEX.md
    2. Tokens Reference: 35_DESIGN_TOKENS.md
    3. Design Foundations: 01_DESIGN_OS.md
    4. Strategic Framework: 43_PROJECT_KICKOFF_SYSTEM.md
  • Recommended Implementation Order:
    1. Kickoff brief and target creative direction mapping.
    2. Spacing margins, color values, and typography variables declaration.
    3. Grid structure, scroll tracking, and cursor physics configuration.
    4. Core components development and story beat construction.
    5. QA checklists run and role-based review gates verification.

Benchmarking System

The benchmarking system evaluates the output quality of project builds:

  • Benchmark Methodology: Outlines profiles for 10 core agencies, detailing strategy, typography pairings, motion, and technology rules.
  • Evaluation Criteria: Checks builds against Awwwards criteria, grading design contrast, visual transition creativity, form usability, and content layouts.
  • Quality Standards: Sets strict requirements for FCP (< 0.8s), SpeedIndex (< 1.5s), stable 60fps framerates on mid-tier mobile hardware, and zero design anti-pattern usage.
  • Review Processes: Combines automated traceability checks with manual department approvals. Visual audits inspect for layout shifts and hardcoded styling overrides.
  • Validation Mechanics: The verify_traceability.py script scans all files on build passes, confirming that every markdown document has a traceability section. The script flags invalid tags and enforces the rule that Bureau Borsche references must use the [SECONDARY] tag.

Usage Guide

To use Creative OS for a new project, follow these step-by-step instructions:

Step 1: Initialize the Project Brief

Copy PROJECT_BRIEF_TEMPLATE.md into the new project's root directory, naming it PROJECT_BRIEF.md. Fill out all 8 parameters: Industry, Audience, Business Goal, Brand Personality, Competitive Landscape, Primary Differentiator, Desired Creative Direction, and Success Metrics.

Step 2: Select the Target Direction

Review the 11 directions catalog inside 22_CREATIVE_DIRECTION_GENERATOR.md. Draft and explore three distinct paths before selecting the final visual direction.

Step 3: Run the System Activation Mode

Identify the project category using 46_BENCHMARK_DECISION_MATRIX.md. Enable the corresponding activation mode (Mode A to G) defined in the Master Index 00_CREATIVE_OS_INDEX.md to load only the required files and prevent context limits.

Step 4: Map the Visual Territory

Analyze competitors against the research checklist in 38_DESIGN_RESEARCH_SYSTEM.md. Define your visual territory on the 2x2 grid, sourcing inspiration outside standard web designs.

Step 5: Answer the Strategic Questions

Establish your competitive moats by answering the Moat, Sacrifice, and Price questions in 42_CREATIVE_INTELLIGENCE_SYSTEM.md. Compile these answers into a strategic decision blueprint.

Step 6: Define Story Beats and Journey

Sequence the project narrative into five cinematic beats using the component in 07_STORYTELLING_SYSTEM.md. Map out the complete user journey and curiosity details based on 40_EXPERIENCE_ARCHITECTURE_SYSTEM.md.

Step 7: Declare Layout Grid and Tokens

Configure relative typography scales and color sets in 35_DESIGN_TOKENS.json. Use 04_TYPOGRAPHY_SYSTEM.md clamp equations to set font boundaries.

Step 8: Build Layouts and Components

Develop responsive views using the structural containers in 01_DESIGN_OS.md and custom physics constants in 05_MOTION_SYSTEM.md. Ensure that components use only tokens variables, without custom utility overrides.

Step 9: Audit and Review the Build

Review layouts against the anti-patterns list in 14_DESIGN_ANTI_PATTERNS.md and the validation checks in 20_DESIGN_DECISION_ENGINE.md. Run verify_traceability.py to check for missing document references.

Step 10: Complete the Launch checklist

Conduct a pre-release review using the scorecard in 21_AWWWARDS_EVALUATION_SYSTEM.md. Secure sign-offs from the Creative Director, Art Director, and Tech Director 48 hours before deployment, as required by 25_FINAL_CREATIVE_REVIEW.md.

Best Practices

  • Grid Shifts: Shift layout containers offset by a col-width or grid row to disrupt symmetrical patterns.
  • Typographic Precedence: Typographic legibility overrides color choices. If color variables reduce reading clarity, modify the color fill rather than changing font sizing.
  • Negative Space: Keep at least 40% of the viewport completely empty. Space is a premium layout variable.
  • Copy length: Restrict display text and copy lines to under 3 rows on desktop screens to maintain visual pacing.
  • Active Voice: Keep copywriting quiet and direct, using active voice to state metrics clearly.
  • No Glow Borders: Banish glowing gradient borders. Use solid border offsets or negative space instead.
  • No Bento layouts: Reject standard card farms and bento grids. Use asymmetric editorial columns instead.
  • Dynamic Loading: Dynamically import large interactive libraries only when their target viewports enter the screen.
  • Aria Attributes: Include aria-expanded, aria-label, and role properties on all interactive components.
  • Keyboard Navigation: Ensure modals and fullscreen navigation panels can be closed using the Escape key.

MCP Server Integration

Creative OS is wrapped in a Model Context Protocol (MCP) server, allowing you to access all guidelines, tokens, pattern libraries, and automated checkers directly in your AI IDE (such as Claude Code, Cursor, or Windsurf).

Quick Start

  1. Navigate to /creative-os/creative-os-mcp/
  2. Install dependencies and compile:
    npm install
    npm run build
  3. Connect the MCP server in your IDE configuration by adding the following server config:
    • Command: node
    • Args: ["/absolute/path/to/creative-os/creative-os-mcp/dist/index.js"]

Available Tools

  1. cos_activate: Activate senior creative technologist mode.
  2. cos_project_init: Initialize project context variables inside memory.
  3. cos_tokens: Retrieve design tokens by category (color, typography, etc.).
  4. cos_pattern: Retrieve production-ready animation and interaction code.
  5. cos_benchmark: View JSON profiles of SOTD-winning studios.
  6. cos_benchmark_compare: Compare design stack/principles between two studios.
  7. cos_concept: Pressure-test project briefs.
  8. cos_signature: Generate signature interactions for briefs.
  9. cos_stack: Retrieve the recommended creative tech stack and rationale.
  10. cos_audit: Audits code snippets for px sizes, hex colors, and accessibility.
  11. cos_fix: Automatically patches code violations.
  12. cos_score: Grades a project brief against Awwwards criteria.
  13. cos_launch_check: Analyzes repository structure for preloads and accessibility.
  14. cos_case_study: Generates structured FWA/Awwwards case studies.
  15. cos_awwwards: Returns Awwwards evaluation guidelines.
  16. cos_recommend_modules: Orchestrates Creative OS manuals based on project type and goals.
  17. cos_router: Recommends specific Creative OS modules and benchmarks based on project and goal briefs.
  18. cos_decide: Creative Decision Engine for architectural and design queries.

Contributing

To modify the Creative OS framework files while preserving system integrity:

  1. Traceability Compliance: Every new or updated markdown document must feature a Benchmark Traceability section containing evidence rules tagged with exact allowed tags ([DIRECT], [INFERRED], [SECONDARY], [ASSUMED]).
  2. Agency Mappings: Updates to benchmark definitions must be mapped inside knowledge_graph.json under the relevant keys.
  3. Bureau Borsche Rules: Any reference to Bureau Borsche must use the [SECONDARY] evidence tag. Sourcing details must be restricted to secondary design archives due to persistent service errors.
  4. Validation checks: Run python3 verify_traceability.py before committing changes. The validation build will fail if any files miss traceability headers, use invalid tags, or feature format conflicts.

Appendix

Terminology & Glossary

  • Asymmetric Grid Shift: Offsetting layout containers by a column width or row offset to break symmetrical grids and create visual tension.
  • Cubic Bezier Easing: Mathematical curves that define animation acceleration. Creative OS uses a Sovereign Curve cubic-bezier(0.16, 1, 0.3, 1) for smooth exit transitions.
  • Design Token: A programmatic constant defining style variables (colors, spacing, type sizes, transition times) to maintain consistency across views.
  • Fluid Typography: Dynamic sizing equations that scale font sizes fluidly based on viewport width, using CSS clamp rules.
  • Focal Isolation: Framing primary visual assets inside extensive whitespace to signal premium perception.
  • Moat Statement: A copywriting framework that states the product's primary technological or operational moat, avoiding marketing buzzwords.
  • Negative Space: Viewport canvas areas left completely empty to guide attention and create visual prestige.
  • Prestige Pricing Psychology: The design practice of signaling high value by using minimal layouts, zero promotions, and research-focused content.
  • Sovereign Archetype: A design persona focusing on high prestige, monochromatic HSL scales, serif display fonts, and extensive margins.
  • Traceability Section: A mandatory section in all Creative OS documents listing benchmark details and evidence validation tags.

Internal Framework Definitions

  • Activation Mode: A predefined loading rule defined in the master index that preloads specific system manuals based on project type.
  • Anti-Pattern Catalog: A checklist of overused visual styles and clichés that are banned from all project builds.
  • Awwwards Scorecard: A review rubric rating design contrast, transition creativity, input usability, and copywriting layout out of 10 points.
  • Cinematic Beat: One of the five narrative sections used to sequence page copy, limiting layout reads to under 150 words.
  • Decision Blueprint: A strategy document detailing the project's brand archetypes, competitive visual limits to avoid, and performance goals.
  • Design Token Linter: An automated compilation rule that rejects styling classes using hardcoded pixel values.
  • Direct website Inspection: Primary research conducted by inspecting the source code, script loaders, and CSS stylesheets of live benchmark sites.
  • Draw Calls: Commands sent to the GPU to render 3D meshes. Creative OS limits draw calls to under 50 per frame.
  • Sovereign Easing: The custom cubic-bezier constant cubic-bezier(0.16, 1, 0.3, 1) used for luxury exits and entries.
  • Visual Territory Map: A 2x2 grid Audit plotting competitor visual patterns to identify empty design sectors.

Benchmark Traceability

No direct benchmark dependencies.