AI-native architecture kit for modern React — disciplined agent rules in one command.
- Smart Framework Isolation: Automatically detects your framework (Next.js or TanStack Start) via
package.jsonto inject only the relevant rules and prevent cross-framework hallucinations. - Strict Feature Boundaries: Enforces feature-sliced design, blocking cross-feature imports and mandating Zod-first validation at the API edge.
- Multi-Agent Ready: Ships with unified
AGENTS.mdandCLAUDE.mdentry points, ensuring Cursor, Claude Code, and Windsurf all follow the exact same architecture. - Mandatory Patterns: Imposes non-negotiable coding standards like TanStack Query
queryOptionsfactories, Safe Return Patterns, and strict error normalization (ApiError).
The initialization command safely injects .mdc files into your .cursor/rules directory, covering:
- Architecture: Core Principles, Feature Boundaries, React Best Practices
- Data & State: TanStack Query, Zustand, API & Error Normalization
- UI & Performance: UI Components, Tailwind, Forms, Core Web Vitals
- Quality: TypeScript Strictness, Testing
npx @virastack/ai initThe CLI reads your package.json, detects your stack, and writes AGENTS.md, CLAUDE.md, docs/, and .cursor/rules/*.mdc into your project root.
Starting a new project? ViraStack Start scaffolds Next.js or TanStack Start with these rules pre-installed.
| Flag | Description |
|---|---|
--force, -f |
Overwrite existing rule files without prompting. |
--framework |
Explicitly set the framework (nextjs or tanstack). |
--tr |
Run the CLI with Turkish prompts and success messages. |
Discover all ViraStack tools, libraries, and boilerplates at virastack.com.
Licensed under the MIT License.
A project by Ömer Gülçiçek
