Skip to content

virastack/start

Repository files navigation

ViraStack Start

ViraStack Start

One command. Production-ready stack.

Scaffold new projects and add tools from the ViraStack ecosystem.

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


Who is this for?

  • Teams that want a consistent Next.js or TanStack Start foundation
  • Developers who want AI rules, architecture, and tooling ready on day one
  • Anyone bootstrapping a new product without reinventing the stack

Prerequisites

  • Node.js >=20.9

Quick Start

npx virastack

Turkish prompts:

npx virastack --tr

Non-interactive (CI / scripts):

npx virastack my-app --yes
npx virastack init my-app --template nextjs --tools mask,password --yes
npx virastack my-app --yes --skip-install

Add a ViraStack tool to an existing project:

npx virastack add mask
npx virastack add password

What it asks

  1. Project name — a folder name, or . for the current directory.
  2. Template — Next.js App Router or TanStack Start.
  3. Multi-language (i18n) — Choose whether you need built-in internationalization support.
  4. ViraStack tools — optional @virastack/mask, @virastack/password.

Scaffolded projects include a pre-configured ViraStack AI layer (architecture & rules), alongside specialized design skills from Emil Kowalski and Jakub Krehel.

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: npx virastack --telemetry-disable

Contributing

Ideas and bug reports are welcome — open an issue.

Explore the ViraStack Ecosystem

Discover all tools and libraries 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