Documentation

Everything Numb.Design

The AI-powered frontend builder. Bootstrap any project with zero bloat — install only the packages you actually need.

Overview

Numb.Design is a complete frontend toolkit that helps you bootstrap projects faster — with zero bloat. It combines a curated catalog of free design resources with a CLI that installs only what your project needs.

Built for developers, designers, and AI agents, Numb.Design eliminates the friction of discovering, evaluating, and installing the right frontend packages every time you start something new.

Zero Bloat

Install only the packages your project actually needs. No junk.

100% Free

Every resource in our catalog is free and open-source.

AI-Ready

Designed for AI agents. One command to scaffold and install.

Quick Start

Get started in under a minute.

1. Run the CLI wizard

bash
npx numb-design init

Follow the prompts to configure your project type, style, and features.

Or use the web wizard

Visit the Interactive Wizard to generate your install plan in the browser.

2. Install the packages

bash
# The CLI generates a ready-to-run install plan npx numb-design init  # Or install specific resources npx numb-design add shadcn-ui framer-motion recharts

Pro tip

Use npx numb-design search buttons to find resources by keyword before installing.

CLI Commands

Every command is designed to be simple, memorable, and fast.

bash
npx numb-design init

Interactive project bootstrap wizard. Prompts for type, style, and features, then generates a complete install plan.

bash
npx numb-design add <resource...>

Quick-install one or more resources. Automatically determines the correct npm command for each.

bash
npx numb-design template <name>

Scaffold a pre-built project template with all dependencies pre-configured.

bash
npx numb-design search <query>

Search the entire resource catalog by keyword. Returns matching resources with categories.

bash
npx numb-design skills

Install pre-built AI agent skill files for Claude Code, Cursor, and other AI coding agents.

npm Package

Use Numb.Design programmatically in your Node.js projects.

Install

bash
npm install numb-design

Generate an install plan

js
import { generatePlan } from 'numb-design';

const plan = generatePlan(
  'landing-page',
  ['modern', 'minimal'],
  ['animations', 'forms', 'icons']
);

console.log(plan);
/* [
  { name: 'Tailwind CSS', install: '', ... },
  { name: 'shadcn/ui', install: 'npx shadcn@latest init ...', ... },
  { name: 'Framer Motion', install: 'npm install motion', ... },
  ...
] */

Analyze an existing project

js
import { analyzeProject } from 'numb-design';

const recs = analyzeProject('./my-project');
// Returns recommendations based on
// what's already installed vs. missing

Browse the resource catalog

js
import { resources } from 'numb-design';

// Full JSON catalog with 500+ resources
console.log(resources.length);
// Filter by category
const uiResources = resources.filter(r => r.category === 'ui');

Binaries

The package ships two CLI binaries: numb and create-numb-app. Run npx numb to invoke the CLI.

Agent Skills

Pre-built skill files for AI coding agents. Give your agent deep design expertise in one command.

Install agent skills

bash
npx numb-design skills

Installs skill files for animation, typography, design systems, and transitions.

Animation

Framer Motion, CSS transitions, scroll-based animation patterns

animation/SKILL.md

Design

Color theory, layout, spacing, visual hierarchy principles

design/SKILL.md

Transitions

Page transitions, shared layouts, route animations

transitions/SKILL.md

Typography

Font pairing, hierarchy, responsive type scales

typography/SKILL.md

Design Tokens

A CSS variable layer that enforces visual consistency across your project.

bash
npx numb-design init
# Select "Apply consistency layer" in the wizard

Generated tokens include

--color-brand
Primary brand palette (50-900)
--font-sans
System font stack
--font-mono
Monospace font stack
--radius
Border radius scale
--shadow
Box shadow scale
--spacing
Spacing scale (4px base)

Resource Catalog

A curated collection of 500+ free design and frontend resources.

120+
UI Components
80+
Icons
60+
Templates
50+
Animations
70+
Fonts
120+
Tools
bash
# Search the catalog npx numb-design search icons  # Browse categories on the web open https://numb.design
uiiconsfontsanimation3dformsauthchartscolorscssimagesutilsemailparticlespayment

Numb.Design is 100% free and open-source. MIT licensed.