ViraStack AI Rules

AI-native architecture kit for modern React. High-discipline protocols for autonomous agents.

• 🤖 Elite AI Persona: Transforms your LLM into a highly disciplined, specialized coding assistant.
• 🏗️ Feature-Driven Design: Enforces strict domain-based organization for maximum scalability.
• 🛡️ Zod-First Type Safety: Ensures end-to-end type safety derived from schemas.
• ⚡ Performance-First: Built-in rules for LCP optimization, CLS prevention, and maximum efficiency.
• 🌐 LLM Agnostic: Works seamlessly with Cursor, Windsurf, Claude Code, and other agentic tools.

Read the docs →

Protocol Coverage

| Protocol | Focus Areas | | :--- | :--- | | UI & UX | Atomic design, A11y SSOT, AI-Aesthetic bans, Skeleton states. | | API Layer | Zod-validation, SSR Safety, Error normalization, Branded types. | | Performance | Core Web Vitals targets, Bundle budgets, Image priority. | | State | Zustand selectors, Hydration safety, TanStack Query integration. | | Frameworks | Next.js 16 (RSC/Actions) & TanStack Start (Loaders/ServerFn). |

Quick Start

Initialize the elite protocols in your project with a single command:

npx @virastack/ai-rules init

How it Works

1. Install: Run npx @virastack/ai-rules init.
2. Context: The CLI injects specialized .mdc files into your .cursor/rules directory.
3. Reasoning: Agent (Cursor/Claude) automatically detects these rules based on your file activity.
4. Execution: Your AI assistant starts writing code according to the ViraStack High-Discipline protocols.

Explore the ViraStack Ecosystem

Projects

• Next.js Boilerplate - Production-ready Next.js 16+ starter template built with Tailwind CSS 4 and TypeScript.
• AI Rules - AI-native architecture kit and high-discipline protocols for modern React applications.
• Input Mask - Lightweight, zero-dependency input masking library optimized for React Hook Form.
• Password Toggle - Fully accessible and highly customizable password visibility hook for React.
• Modern Web in 3 Minutes - Master modern web development standards in just 3 minutes.

🚧 Coming Soon

• Start (CLI) - Automated scaffolding tool to initialize and scale high-discipline ViraStack architectures.
• TanStack Boilerplate - Production-ready TanStack Start starter template built with Tailwind CSS 4 and TypeScript.
• Standards - A unified suite of ESLint, Prettier, and architectural rules to enforce absolute code integrity.
• Error Guard - Pro-grade error handling and smart recovery protocols for zero-friction React environments.

... and more at virastack.com

License

Licensed under the MIT License.

Maintainer

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