create-impact-nova

Scaffold a ready-to-run Vite + React app with Impact Nova pre-wired:

• Tailwind + Impact Nova preset + Manrope fonts
• Layout shell (sidebar, header, router outlet)
• Premium page chrome — PageShell, PageStickyHeader, EmptyStateView, SummaryMetricCard (Item Smart parity)
• React Router + Home welcome page
• Shared primitives: PageStickyHeader, DataTable density/viewport helpers, AG Grid cell registry, filter guard
• Zustand stores — global UI, filters, notifications, KPI order (+ recipe session/preferences stores)
• Shell extras — command palette, notification panel, drag-sort KPI rail (@dnd-kit)
• AG Grid license hook + stacked Toaster
• Feature modules from six recipes — driven by your prompt, not baked into the base template
• Org AI setup — template/docs/AGENT_GUIDE.md, template/docs/AI_IDE_SETUP.md, .mcp.json / .cursor/mcp.json (Cursor, Windsurf, Claude Code)

See docs/TEMPLATE_STANDARDS.md and MCP resource impact-nova://ia-design-language (Figma-trained IA designer guide).

Usage

npm create impact-nova@latest my-app
cd my-app
npm run dev

From the impact-nova monorepo (links local impact-nova via file: automatically):

npx create-impact-nova my-app

From npm (uses impact-nova@^2.0.5 from the registry):

npx create-impact-nova my-app --from-npm

Other options:

npx create-impact-nova my-app --dir ./apps/my-app --skip-install
npx create-impact-nova my-app --link-monorepo   # force file: link when monorepo is present

Recipes (modules)

Pass modules when scaffolding programmatically or via MCP scaffold_impact_nova_app:

| Recipe | Use when | |--------|----------| | filtered-workspace | Planning / workflow: empty → FilterPanel → KPI + grid | | data-catalog | FilterStrip + DataTable list | | dashboard | KPI cards + composable chart (DashboardChartPanel) | | wizard-flow | Multi-step reporting wizard | | scenario-comparison | Simulation results variance panel | | product-config-flow | Item details tabs + add-placeholder + map-sku |

import { scaffoldProject } from 'create-impact-nova';

scaffoldProject({
  projectName: 'retail-planning',
  modules: [
    {
      recipe: 'filtered-workspace',
      slug: 'retail-planning',
      title: 'Retail Planning',
    },
  ],
});

MCP (Cursor, Windsurf, Claude Code)

Works in any MCP client — not Cursor-only. Commit .mcp.json / .cursor/mcp.json from the template so the org shares one server config.

Org rollout: template/docs/AI_IDE_SETUP.md. Portable rules: template/docs/AGENT_GUIDE.md.

In Cursor with impact-nova-mcp, ask:

Scaffold a retail planning prototype with Sales / Inventory / Receipts tabs

The agent calls scaffold_impact_nova_app with modules[] derived from your prompt.

Programmatic API

import { scaffoldProject, SCAFFOLD_RECIPES } from 'create-impact-nova';

scaffoldProject({
  projectName: 'my-app',
  targetDirectory: './my-app',
  skipInstall: true,
  usePublishedPackages: true,
});