Templates
Four production templates: Next.js and TanStack Start, each plain or with i18n.
Framework choice
The CLI offers two main frameworks; both have equal priority:
- Next.js App Router: Server Components, Turbopack, React Compiler. The i18n template with next-intl is kept separate.
- TanStack Start: type-safe routing and SSR. Uses Paraglide JS for i18n.
Multi-language support isn’t stripped from code; it’s provided via separate templates. When the CLI asks “Do you want multi-language support?”, the matching template is copied:
templates: plain (single language)templates-i18n: includes locale routing and translation infrastructure, with messages insrc/messages/
Shared stack
Aside from framework-specific routing, every template ships with these packages already installed:
| Area | Packages |
|---|---|
| State | TanStack Query, Zustand, nuqs (Next.js; TanStack Start uses validateSearch) |
| Form | React Hook Form, Zod |
| Hooks | usehooks-ts |
| UI | Base UI, Lucide React |
Theme support and Zod-based env validation also ship with the template.
ViraStack AI encodes these choices as agent rules (see the rule catalog). Start also installs three design skills: emil-design-eng, better-ui and better-accessibility (details).
Tests
Every template ships with Vitest, Testing Library and MSW ready to use.
vitest.config.tsandsrc/test/: jsdom setup, arenderWithProvidershelper and an MSW server that fails on unhandled requests.npx virastack add usersbrings example tests: a helper (get-initials.test.ts), an API function with MSW (get-users.api.test.ts) and a component (UsersDirectory.test.tsx).pnpm testruns once andpnpm test:watchkeeps watching. CI runs the tests before the build. See scripts.
Folder structure
src/
├── app/ | routes/ # Next.js App Router | TanStack file-based routing
├── features/
│ └── home/ # Start page (deletable)
│ ├── components/
│ ├── constants/
│ ├── helpers/
│ └── icons/
├── components/
│ ├── ui/
│ └── shared/
├── config/
├── constants/
├── helpers/
├── hooks/
├── lib/
├── messages/ # i18n templates only
├── providers/
├── schemas/
├── stores/
├── styles/
├── test/ # Vitest setup, render helper, MSW server
├── types/
└── env.ts
.agents/skills/ # emil-design-eng, better-ui, better-accessibility
.claude/ # Rules and skills (with Claude Code)
.cursor/rules/virastack/ # ViraStack AI rules (with Cursor)
.virastack/ai.json # ViraStack AI manifest
AGENTS.md
CLAUDE.mdESLint blocks imports between features and parent-relative ../ imports, so the boundaries in this tree are enforced, not just suggested.
Return to installation to set up, or see the CLI page for flags.