Şablonlar
Dört üretim şablonu: Next.js ve TanStack Start, her biri sade veya i18n’li.
Framework seçimi
CLI’de iki ana framework vardır; ikisi de eşit önceliklidir:
- Next.js App Router: Server Components, Turbopack, React Compiler. next-intl ile i18n şablonu ayrı tutulur.
- TanStack Start: tip güvenli routing ve SSR. i18n için Paraglide JS kullanılır.
Çoklu dil desteği kod içinden silinerek değil, ayrı şablonlar ile sağlanır. CLI “Çoklu dil desteği ister misiniz?” diye sorduğunda ilgili şablon kopyalanır:
templates: sade (tek dil)templates-i18n: locale routing ve çeviri altyapısı dahil
Ortak stack
Framework’e özel routing dışında her şablon aşağıdaki paketlerle gelir:
| Alan | Paketler |
|---|---|
| State | TanStack Query, Zustand, nuqs |
| Form | React Hook Form, Zod |
| Hooks | usehooks-ts |
| UI | Base UI, Framer Motion, Lucide React |
Tema desteği ve Zod ile env doğrulama da şablonla birlikte gelir.
ViraStack AI bu seçimleri ajan kurallarına işler. Tasarım skill’leri Start kurulumuyla ayrıca eklenir (emil-design-eng, make-interfaces-feel-better).
Klasör Yapısı
src/
├── app/ | routes/ # Next.js App Router | TanStack file-based routing
├── features/
│ └── landing/ # Örnek feature (silinebilir)
│ ├── api/
│ ├── components/
│ ├── data/
│ ├── helpers/
│ ├── hooks/
│ ├── icons/
│ ├── schemas/
│ ├── stores/
│ ├── types/
│ └── index.ts
├── components/
│ ├── ui/
│ └── shared/
├── hooks/
├── stores/
├── schemas/
├── providers/
├── lib/
├── config/
├── constants/
├── helpers/
├── types/
├── styles/
└── env.ts
.agents/
└── skills/ # emil-design-eng, make-interfaces-feel-better
.cursor/
└── rules/ # ViraStack AI mimari kuralları
AGENTS.md
CLAUDE.mdKuruluma dönmek için kurulum, bayraklar için CLI sayfalarına bakın.
