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

Options

Flag Description
--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

Telemetry

To understand which tools and templates are preferred by the community, ViraStack collects strictly anonymous usage 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