Scaffolding CLI for Next.js and TanStack Start: ViraStack tools and AI rules in one command
- Interactive CLI: Interactive prompts for template selection, project naming, and ecosystem tool integration.
- Production-Ready Foundations: Scaffolds Next.js or TanStack Start projects with pre-configured feature-sliced architecture.
- Built-in AI Protocols: Asks which AI coding tools you use (Claude Code, Cursor) and sets up ViraStack AI for them — architecture rules in each tool's native format,
AGENTS.md, and design skills from Emil Kowalski and Jakub Krehel — giving your coding agents a strict "constitution" from day one. - End-to-End Type Safety: Strict TypeScript rules, Zod validation, and native package manager alignment (pnpm, npm, yarn, bun).
- Ecosystem Integration: Add optional ViraStack tools (
@virastack/mask,@virastack/password) seamlessly.
Recommended (pnpm):
pnpm dlx virastackAlternatives:
npx virastack
# or
yarn dlx virastack
# or
bunx virastackWhat is your project named?
virastack-app
Which template would you like to use?
› Next.js App Router
TanStack Start
Which AI coding tools do you use?
[x] Claude Code
[x] Cursor
Would you like multi-language (i18n) support?
› Yes
No
Which ViraStack tools would you like to include?
[ ] @virastack/mask
[ ] @virastack/password
Select none to get plain rules in .agents/rules/ that any agent can read through AGENTS.md.
- Copies the template and sets the project name.
- Installs dependencies with the package manager you ran it with.
- Next.js only: adds the Next.js block to
AGENTS.md, pointing agents at the docs bundled innode_modules/next/dist/docs/. - Runs
@virastack/ai init --agent <your choice>. It never overwrites files you changed. - Installs three design skills:
emil-design-eng(Emil Kowalski),better-uiandbetter-accessibility(Jakub Krehel). They go to.agents/skills/and, with Claude Code, to.claude/skills/. With Claude Code as the only tool, they go only to.claude/skills/. - Creates the first git commit, so
git statusis clean.
--skip-install skips step 2. Offline, steps 2, 4 and 5 are skipped and the commands to run later are printed.
| Tool | Description |
|---|---|
@virastack/ai |
Pre-configured AI layer and coding rules for modern AI assistants (included in templates by default) |
@virastack/mask |
Input masking and formatting (Phone, IBAN, etc.) |
@virastack/password |
Accessible password field hook: show/hide, NIST-style strength, confirmation and server validation |
| Command / flag | Description |
|---|---|
init [name] |
Create a new project (default; also runs with no command) |
add <tool> |
Add a tool to an existing project (mask, password, ai) |
--name <name> |
Project name (or pass as positional / .) |
--template <name> |
nextjs or tanstack |
--tools <list> |
Comma-separated tools (mask,password) |
--agent <list> |
AI coding tools: claude, cursor (comma separated) or none. Default with --yes: both |
--i18n / --no-i18n |
Enable or disable the i18n template |
--yes, -y |
Non-interactive mode (flags + defaults) |
--skip-install |
Skip dependency install (AI rules and skills are still added) |
--tr |
Turkish prompts |
--telemetry-disable |
Permanently disable anonymous usage tracking |
-v, --version |
Print CLI version |
-h, --help |
Show usage |
pnpm dlx virastack add mask
pnpm dlx virastack add password
pnpm dlx virastack add ai
pnpm dlx virastack add ai --agent cursorEvery template ships with this stack already installed:
| Area | Packages |
|---|---|
| State | TanStack Query, Zustand, nuqs |
| Form | React Hook Form, Zod |
| Hooks | usehooks-ts |
| UI | Base UI, Motion, Lucide React |
| Test | Vitest, Testing Library, MSW |
ViraStack AI encodes these choices as agent rules so assistants follow the same stack from day one.
The CLI collects anonymous usage data only: template, options, tools, package manager and CLI version. Opt out: pnpm dlx virastack --telemetry-disable
Ideas and bug reports are welcome — open an issue.
Part of the ViraStack ecosystem: Academy · AI · Mask · Password · Guide