Build Production-Ready Next.js Apps in Minutes
Nova is an extensible Next.js developer toolkit & CLI. Scaffold 9 turnkey starter templates, layer 35+ composable plugins, manage Kubernetes & Terraform infrastructure, and maintain codebases with automated migration and self-healing.
Architecture Presets
Production stacks pre-configured in seconds
Don't start from an empty project. Choose an official preset with battle-tested ORMs, auth, APIs, and observability.
Subscription SaaS
Production-ready SaaS with Drizzle ORM, Better Auth, transactional email, storage uploads, payments abstraction, and monitoring.
Included Architecture
- Better Auth with sessions & RBAC
- Drizzle ORM & Postgres migrations
- Transactional Email (React Email + Mailpit)
- Storage Abstraction & File Uploads
- Payments Architecture (Stripe / LemonSqueezy / Paddle)
- Sentry Error Monitoring & Health Probes
- Vitest + Playwright E2E testing
- Husky + lint-staged git hooks
$ nova create my-saas --preset saas
# Installed plugins:
Vercel AI SDK Integration
First-class Generative AI & Streaming
Nova ships native AI streaming routes, conversational chat components, and model provider integrations out of the box.
Stream AI responses with zero plumbing
Nova writes typed streaming route handlers (src/app/api/chat/route.ts) and client hooks (useChat) using the official Vercel AI SDK.
$ nova add ai openaiAdd AI streaming to any existing Nova project.
import { openai } from "@ai-sdk/openai";import { streamText } from "ai"; // streaming edge route handlerexport async function POST(req: Request) { const { messages } = await req.json(); const result = await streamText({ model: openai("gpt-4o"), messages, system: "You are a helpful Nova AI assistant." }); return result.toDataStreamResponse();}Interactive Plugin Composer
Compose your stack, one plugin at a time
Choose features during scaffolding or incrementally with `nova add`. Nova guarantees zero config drift and atomic rollback.
$ nova add ai openai drizzle tanstackQuery4 plugins selected — run in any existing Nova project.
Lifecycle Maintenance & Infrastructure
Keep your project healthy and cloud-ready
Nova isn't just a starter — it's a full project lifecycle engine with migration runners, Kubernetes/Terraform infrastructure, security auditing, and automated repair.
$ nova infra scan
[SEC-001] Non-root container execution check... PASS (securityContext.runAsNonRoot)
[SEC-002] Resource limits (CPU/Memory) check... PASS (limits & requests defined)
[SEC-003] Read-only root file system check... PASS
[SEC-004] Privilege escalation check... PASS (allowPrivilegeEscalation: false)
[SEC-005] TLS Ingress configuration check... PASS
✔ Infrastructure Security Score: 100/100 (0 findings, 10 benchmarks passed)
UI Frameworks
Pick the component layer you actually love
Nova wires the provider tree, theme tokens, dark mode, and demo dashboard for your chosen library during scaffolding.
- Default
shadcn/ui
--ui shadcnRadix UI primitives styled with Tailwind CSS.
- Source-based components
- Radix a11y primitives
- Default choice
Material UI
--ui muiGoogle Material Design system for React.
- Huge component ecosystem
- Theme cache provider
- Enterprise ready
Chakra UI
--ui chakraComposable, accessible component library.
- Fast developer experience
- Style props
- Dynamic theming
Ant Design
--ui antData-dense components for enterprise & admin.
- ConfigProvider integration
- Rich tables & forms
- i18n support
Mantine
--ui mantine100+ components with deep hooks library.
- Comprehensive hook set
- Color scheme engine
- Form helpers
HeroUI
--ui heroModern Tailwind-native component suite.
- Beautiful defaults
- Built-in micro-motion
- Tailwind tokens
DaisyUI
--ui daisySemantic class names on top of Tailwind.
- Lightweight footprint
- Theme presets
- No JS runtime
Headless UI
--ui headlessUnstyled, fully accessible interaction primitives.
- Heroicons integration
- Full styling freedom
- Zero design lock-in
Cloud Deployment System
Ship anywhere with one command
Run `nova deploy [provider]` to generate tailored CI/CD GitHub Actions workflows, Dockerfiles, and production configs.
Vercel
Zero-configuration Next.js deployment with global Edge network, automatic preview comments, and serverless compute.
Automatic vercel.json generation
Edge security headers & caching
Cloudflare Pages
Deploy globally on Cloudflare Pages and Workers with high-speed cold starts and nodejs_compat runtime.
wrangler.toml generation with nodejs_compat
Cloudflare Pages GitHub Actions workflow
Railway
Effortless fullstack hosting on Railway with Nixpacks builds, automated PostgreSQL/Redis provisioning, and zero-downtime deploys.
railway.json Nixpacks config
Automated DB & Redis provisioning templates
Render
Infrastructure-as-Code blueprints for deploying web services, background workers, and managed databases on Render.
render.yaml declarative blueprint
Web service + managed Postgres config
AWS App Runner & ECR
Fully managed container deployment to AWS App Runner with automated Docker image build and Amazon ECR publishing.
apprunner.yaml App Runner config
AWS ECR & App Runner GitHub Actions workflow
Docker & Self-Hosted
Production-hardened multi-stage Docker build, docker-compose orchestration, and Nginx/Traefik reverse proxy guides.
Multi-stage Dockerfile with non-root security
docker-compose.prod.yml with Postgres & Redis
Architecture & Pipeline
Predictable, Atomic, and Self-Healing
Nova uses a declarative execution plan with automatic rollback on failure and an authoritative project state manifest.
1. CLI Manifest & Validation
Checks constraints, conflicts, and resolves dependency tree before writing a single byte.
2. Base App Router Template
Strict TypeScript, next-intl i18n, typed API infrastructure, and auth token rotation.
3. UI Framework Layer
Injects chosen provider (shadcn, MUI, Mantine...) and demo design-system primitives.
4. Composable Plugin Overlays
Applies Drizzle/Prisma, AI SDK, Sentry, Redis, and patches configs transactionally.
5. Authoritative State Manifest
Writes .nova/project.json tracking plugin versions for future doctor/repair/upgrade commands.
{ "$schema": "https://nova.dev/schema/project.json", "schemaVersion": 1, "name": "my-app", "novaVersion": "0.2.4", "packageManager": "pnpm", "uiLibrary": "shadcn", "plugins": ["drizzle", "betterAuth", "ai", "openai"], "pluginVersions": { "drizzle": "1.0.0", "betterAuth": "1.0.0", "ai": "1.0.0" }}Everything Included
A batteries-included foundation without the bloat
Every integration is opt-in, generated as readable TypeScript source code inside your repository, and 100% yours to edit.
- Core
Next.js 16 App Router & proxy.ts
Server components, nested layouts, streaming SSR, and Next.js 16 native proxy.ts edge architecture.
- DevOps
Infrastructure as Code & K8s (`nova infra`)
Pluggable Infrastructure engine for Kubernetes manifests, Terraform HCL, CIS security scanner, and drift detection.
- AI
Vercel AI SDK & Streaming
Native AI streaming, model provider hooks (OpenAI, Claude, Ollama), and reactive chat components.
- Scaffolding
9 Official Starter Templates
Minimal, SaaS, Admin Dashboard, E-commerce, Blog CMS, AI, Realtime SSE, API, and Expo Mobile.
- Maintenance
Project Migration & Self-Healing
Automated migration engine (runProjectMigrations) and manifest reconstruction from package.json.
- Data
Storage & File Uploads
Multi-driver storage abstraction supporting Local filesystem, AWS S3, and Supabase Storage with FileUpload UI.
- APIs
Real-time Events & SSE
Server-Sent Events streaming, presence tracking, and NotificationCenter UI component out of the box.
- APIs
Payments & Billing Abstraction
Modular subscription and checkout architecture for Stripe, LemonSqueezy, Paddle, and Mock.
- CLI
Live Package Resolution
Dynamic npm registry resolution with compatible, latest, and exact strategies via `nova packages`.
TypeScript Strict & ESLint 9
Type-safe environment variables, strict tsconfig, and zero-compromise code hygiene.
Drizzle & Prisma ORMs
SQL-first Drizzle or declarative Prisma ORM with automated migrations and studio explorer.
Better Auth & Security
Modern auth core, session management, OAuth providers, and HTTP-only token rotation.
tRPC & GraphQL Yoga
End-to-end type-safe APIs or GraphQL codegen without manual schema synchronization.
TanStack Query & Table
Smart async caching, optimistic updates, and headless datatables with filters & sorting.
8 UI Frameworks
shadcn/ui, MUI, Chakra, Ant Design, Mantine, HeroUI, DaisyUI, Headless UI.
- Maintenance
Project Lifecycle CLI
nova doctor --fix, nova status, nova env, nova repair, nova upgrade, and nova infra.
Transactional nova add
Safely add or remove plugins to existing projects with atomic rollback and dry-run preview.
Internationalization (i18n)
next-intl locale routing (/en, /fa) with full RTL bidirectional support.
Forms & Zod Validation
React Hook Form with shared Zod validation schemas across client and server.
Vitest, Playwright & Husky
Fast unit tests, cross-browser E2E testing, and automated pre-commit git hooks.
Storybook 8 Component Workshop
Isolated UI component workshop with accessibility testing and theme toggles.
- DevOps
Cloud Deployment Hub
One-command deployment configurations for Vercel, Cloudflare, Railway, Render, AWS, Docker.
Docker Multi-Stage Containers
Production multi-stage containers and docker-compose service stacks.
Sentry Observability
Real-time error tracking, distributed tracing, and session replay.
React Email & Mailpit
Type-safe JSX emails with a local SMTP inbox for zero-fuss development.
Redis Caching & Invalidation
ioredis client singleton, rate limiting, and cache tag invalidation.
Security Headers & CSP
Strict Content Security Policy, HSTS, and X-Frame-Options in Next.js 16 proxy.ts.
Plugin SDK & Registry
Build, validate, test, and distribute custom plugins with trust verification.
Expo React Native Mobile
Expo SDK 52 mobile templates with shared schemas and NativeWind styling.
Workflow
From zero to running production app in four steps
A predictable, developer-first pipeline designed to scale from day one.
Step 1
1. Install or Run npx
Zero global install required. Runs the latest generator with preset and template options.
npx @darkalpha/nova my-appStep 2
2. Choose Architecture Stack
Interactive prompts with smart conflict detection and preset auto-fill.
Preset · UI Framework · PluginsStep 3
3. Scaffolding & State Manifest
Generates clean TypeScript source, validates dependencies, and initializes git.
Project + .nova/project.jsonStep 4
4. Run, Add Features & Maintain
Auth, database, i18n, AI, and CI are wired. Run nova add or nova doctor as you grow.
npm run dev & nova doctor
Developer Experience
Commands and code that stay out of your way
Three commands cover full scaffolding, adopting new capabilities, and running automated health checks.
$ npx @darkalpha/nova my-app --preset saasScaffold a new production SaaS application
$ nova add ai openai redisLayer generative AI and caching incrementally
$ nova doctor --fixDiagnose and repair environment or config drift
import { createEndpoint } from "@/lib/api"import { z } from "zod" // fully typed, validated, and documented endpointexport const getInvoice = createEndpoint({ input: z.object({ id: z.string().uuid() }), handler: async ({ input, db }) => { return db.invoice.findUniqueOrThrow({ where: { id: input.id }, }); },});Comparison
What you get on day one
create-next-app gives you a bare-bones canvas. Nova gives you the battle-tested architecture engineering teams end up rebuilding on every project.
| Capability | create-next-app | Nova |
|---|---|---|
| Infrastructure as Code & K8s Subsystem (nova infra) | ||
| CIS Security Benchmark Scanner (SEC-001 - SEC-010) | ||
| Official Starter Templates (9 Templates) | ||
| Architecture Presets System | ||
| Vercel AI SDK & LLM Streaming Integration | ||
| Automated Project Migration & Self-Healing Engine | ||
| Next.js 16 proxy.ts Native Edge Architecture | ||
| Live npm Package Resolver & Upgrade Engine (nova packages) | ||
| Storage & File Upload Abstraction (Local/S3/Supabase) | ||
| Real-time SSE & Notification Center Abstraction | ||
| Payments & Billing Abstraction (Stripe/LemonSqueezy...) | ||
| Interactive Plugin System (35+ plugins) | ||
| Transactional Plugin Lifecycle (nova add / remove) | ||
| Project Diagnostics & Auto-Repair (nova doctor --fix) | ||
| Environment Secret Management (nova env) | ||
| Authoritative State Manifest (.nova/project.json) | ||
| Manifest Auto-Reconstruction from package.json | ||
| Authentication & Token Rotation / Better Auth | ||
| Database Layer (Drizzle / Prisma / Supabase) | ||
| Type-safe APIs (tRPC / GraphQL / OpenAPI) | ||
| 8 Swappable UI Frameworks | ||
| Internationalization (next-intl + RTL) | ||
| Testing Suite (Vitest, Playwright, Cypress, Storybook, Husky) | ||
| Cloud Deployment Workflows (Vercel, Cloudflare, AWS...) | ||
| Docker Multi-stage & Compose Stacks | ||
| Sentry Error Monitoring & Tracing | ||
| Zero Vendor Lock-in (Plain Next.js code) |
Structure & Conventions
Architecture you can navigate on day one
Feature-first modular boundaries between UI, domain business services, and cross-cutting infrastructure.
- src/
- proxy.ts— Next.js 16 Edge proxy & auth
- app/[locale]/— App Router routes & i18n
- actions/— Server actions
- components/— ui, layout, forms, providers
- features/— domain modules (auth, billing, ai)
- lib/— api, auth, drizzle/prisma, storage, payments
- services/— business domain operations
- i18n/— next-intl navigation config
- messages/— en.json, fa.json translations
- .nova/
- project.json— state & plugin manifest
- docs/— in-repo architecture docs
Why Nova
Built for engineering teams shipping real software
- 01
Instant Production Foundation
Scaffold a complete enterprise architecture in 30 seconds rather than spending two sprints wiring auth, databases, API layers, and CI.
- 02
AI & LLM Ecosystem First
First-class integration with Vercel AI SDK, OpenAI, Anthropic, and Ollama with streaming route handlers and reactive chat UI.
- 03
Infrastructure as Code & Kubernetes
Pluggable infrastructure engine with `nova infra` generating hardened Kubernetes manifests, Terraform HCL, and CIS security benchmarks.
- 04
Migration Engine & Self-Healing
Automated project migrations (Next.js 16 proxy.ts, schema normalization), manifest reconstruction, and deterministic repair with `nova repair`.
- 05
Live Package Version Resolution
Dynamic npm registry package resolution with compatible, latest, and exact strategies — no stale hardcoded boilerplate versions.
- 06
Zero Vendor Lock-in
Everything Nova generates is plain, ordinary Next.js/React/TypeScript code you own completely. No runtime daemon or tracking.
Community
Trusted by engineers who read the generated code
“We replaced our 4,000-line messy internal boilerplate with Nova templates. Onboarding new engineers went from a full week to an afternoon.”
Mira KovacStaff Engineer, Fintech“nova add storage realtime payments did in one command what usually costs me two days of glue code, config patching, and typing issues.”
Daniel OrtizFull-stack Developer“The self-healing engine (nova repair) and dynamic package resolution make maintaining 20+ Next.js microservices completely painless.”
Aiko TanakaFrontend Platform Lead
FAQ
Frequently Asked Questions
Roadmap
Recently delivered, and what's next
Recently Delivered (v0.2.5)
- Infrastructure as Code Subsystem (Kubernetes, Terraform, Docker, Compose via nova infra)
- CIS Security Benchmark Scanner (SEC-001 - SEC-010) & Infra Drift Detection
- Automated Project Migration Engine (Next.js 16 proxy.ts, schema v1)
- Manifest Reconstruction from package.json & Inferred Discovery
- Live npm Package Resolver & Upgrade Pipeline (nova packages)
- 9 Official Starter Templates (Minimal, SaaS, Admin, Store, Blog, AI, Realtime, API, Mobile)
- Multi-Driver Storage Plugin (Local, AWS S3, Supabase Storage)
- Real-time Events & Streaming Plugin (SSE + Notification Center)
- Payments & Billing Abstraction Plugin (Stripe, LemonSqueezy, Paddle)
- Template & Preset Registry System (nova templates / template info)
- Advanced Self-Healing in nova repair & Compatibility Diagnostics
- Vercel AI SDK & LLM Streaming (OpenAI, Claude, Ollama)
In Active Development
Micro-frontends & Module Federation
Webpack Module Federation (@module-federation/nextjs-mf) and host/remote container orchestration for multi-team apps.
LangChain & LangGraph Orchestration
Complex agentic workflows, multi-agent systems, and memory persistence alongside Vercel AI SDK.
Multi-Tenant SaaS Workspace Abstractions
Subdomain / tenant-based routing proxy (org.app.com), workspace switching context, and tenant-isolated DB schemas.
Ready to build your next Next.js application?
Run one command to get full architecture presets, type-safe APIs, authentication, internationalization, and 32+ composable plugins.
$ npx @darkalpha/nova my-app