Next.js

Scaffold a Next.js workspace with React, TypeScript, and the App Router.

Why Use This Command?

Installs Next.js 15 with React 19, TypeScript, and the App Router so you can start building pages immediately.
Auto-detects monorepo or workspace mode so the same command works whether you're starting fresh or adding to an existing project.
Wires up next dev, next build, and next start scripts so the workspace runs without extra configuration.

Requirements

Node.js runtime — Use any Node.js LTS release.
Empty directory (monorepo mode) or monorepo root (workspace mode) — The command auto-detects which mode to use.

Usage

Options

Flag	Description
`-d, --dry-run`	Preview changes without writing files.
`--name <name>`	Project or workspace name.
`--workspace-name <name>`	Workspace directory name.
`--output <dir>`	Output directory.

Output Structure

{project-slug}/
├── package.json
├── nova.config.json
├── apps/
│   └── {workspace-name}/
│       ├── package.json
│       ├── next.config.mjs
│       ├── tsconfig.json
│       └── src/
│           └── app/
│               ├── layout.tsx
│               ├── page.tsx
│               └── globals.css
└── packages/

How It Works

Interactive Wizard

When run without flags, the command walks you through an interactive wizard:

Monorepo mode (no package.json found):

Project name — Enter a slug for your monorepo (e.g. my-app).
Workspace name — Enter a slug for the workspace directory (default: nextjs).
Where should the project be created? — Choose between creating a new directory or building in the current working directory.
Output directory — If creating a new directory, confirm the path (default: ./{project-name}).
Run generators — Optionally run project-level generators (.editorconfig, .gitignore, LICENSE, etc.).

Workspace mode (package.json with workspaces found):

Package name — Enter a slug for the workspace package (e.g. my-app).
Workspace name — Enter a slug for the workspace directory (default: nextjs).
Output directory — Confirm the workspace path (default: ./apps/{workspace-name}).

Non-Interactive Mode

Provide --name, --workspace-name, and --output to skip all prompts:

nova scaffold app nextjs --name my-app --workspace-name nextjs --output ./my-app

Next Steps

After scaffolding, consider running generators to add essential project files like .editorconfig, .gitignore, LICENSE, and README.md.