TheBlueprint

TheBlueprint is Nodus design intelligence for building client websites with range: high-motion, high-craft, conversion-aware, and specific to the client instead of copy-pasted from one template.

It combines two layers:

• A searchable design data engine: product categories, styles, palettes, typography, UX rules, chart guidance, and stack guidance.
• A Hunt craft layer: critique, motion direction, asset strategy, conversion judgment, mobile polish, and anti-template guardrails.

The rule is simple:

Diversity in visual language. Consistency in craft.

What It Is For

Use TheBlueprint for websites, landing pages, product pages, pricing pages, hero sections, service pages, portfolio pages, dashboards with a visual design requirement, and frontend UI audits.

The default posture is high-motion premium. Pull motion back only when credibility, regulation, accessibility, or performance demands restraint.

Install

npm install -g the-blueprint-cli
the-blueprint init --ai claude
the-blueprint init --ai codex
the-blueprint init --ai all

Global install:

the-blueprint init --ai claude --global
the-blueprint init --ai codex --global

MCP server:

the-blueprint-mcp

Search

Generate a Hunt-filtered design direction:

python3 .claude/skills/the-blueprint/scripts/search.py "premium agency website kinetic typography" --design-system -f markdown -p "Agency"

Search specific domains:

python3 .claude/skills/the-blueprint/scripts/search.py "cinematic hospitality booking" --domain landing
python3 .claude/skills/the-blueprint/scripts/search.py "scroll performance accessibility" --domain ux
python3 .claude/skills/the-blueprint/scripts/search.py "Next.js image performance" --stack nextjs

Source Layout

src/the-blueprint/          # Source of truth
  data/                     # Searchable design data
  scripts/                  # Python search and design-system generator
  templates/                # Generated skill templates
  references/               # Hunt craft docs
  evals/                    # Regression prompts for website directions

cli/                        # Installer package
  assets/                   # Packaged copy of src/the-blueprint
  src/                      # CLI and MCP implementation

.claude/skills/the-blueprint/ # Local generated Claude skill for this repo

Edit src/the-blueprint/ first, then sync into cli/assets/ before building or publishing the CLI.

Development

Sync packaged assets after source changes:

cd cli
npm run sync:assets

Build the CLI:

cd cli
npm install
npm run verify

Verify generated installs:

cd cli
npm run verify

The verifier builds the CLI, checks source/asset parity, runs direction evals, installs every platform template into temporary homes, verifies uninstall behavior, and smoke-tests the MCP server.

Design-System Output

--design-system includes the raw recommendation plus the Hunt layer:

• brand_range
• motion_profile
• motion_lane
• hunt_scores
• guardrail_overrides
• template_risk
• motion_recipe
• site_blueprint
• asset_strategy
• conversion_notes
• hunt_critique

The data engine suggests. Hunt craft judges.

Structured output:

python3 .claude/skills/the-blueprint/scripts/search.py "law firm trust website" --design-system --json
python3 .claude/skills/the-blueprint/scripts/search.py "restaurant hospitality booking" --site-blueprint --json

License

TheBlueprint is MIT licensed by Nodus.