Skip to content

Repository files navigation

ViraStack Start

Production-grade scaffolding CLI for modern React — integrate ecosystem tools in one command.

ViraStack Start npm version npm downloads Node License: MIT @virastack


Why ViraStack Start?

  • 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: Integrates ViraStack AI automatically — architecture rules, 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.

Quick Start

Recommended (pnpm):

pnpm dlx virastack

Alternatives:

npx virastack
# or
yarn dlx virastack
# or
bunx virastack

What it asks

What is your project named?
  virastack-app

Which template would you like to use?
  › Next.js App Router
    TanStack Start

Would you like multi-language (i18n) support?
  › Yes
    No

Which ViraStack tools would you like to include?
  [ ] @virastack/mask
  [ ] @virastack/password

Tools

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 Password visibility toggle with customizable icons and text

Commands and options

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)
--i18n / --no-i18n Enable or disable the i18n template
--yes, -y Non-interactive mode (flags + defaults)
--skip-install Scaffold files only; skip install + AI setup
--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

Included by default

Every 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, Framer Motion, Lucide React

ViraStack AI encodes these choices as agent rules so assistants follow the same stack from day one.

Telemetry

To keep usage statistics, ViraStack collects strictly anonymous data (template, i18n choice, selected tools, package manager, and CLI version). Absolutely no personal data, project names, or file paths are collected.

Opt out anytime: pnpm dlx virastack --telemetry-disable

Contributing

Ideas and bug reports are welcome — open an issue.

Explore the ViraStack Ecosystem

Discover all ViraStack tools, libraries, and boilerplates at virastack.com.

License

Licensed under the MIT License.

Maintainer

A project by Ömer Gülçiçek

Follow Ömer Gülçiçek

Used by

Contributors

Languages