Ş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 misin?” diye sorduğunda ilgili şablon kopyalanır:
templates: sade (tek dil)templates-i18n: dil yönlendirmesi ve çeviri altyapısı içerir; mesajlarsrc/messages/klasöründedir
Ortak stack
Framework’e özel routing dışında her şablon aşağıdaki paketlerle gelir:
| Alan | Paketler |
|---|---|
| State | TanStack Query, Zustand, nuqs (Next.js; TanStack Start validateSearch kullanır) |
| Form | React Hook Form, Zod |
| Hooks | usehooks-ts |
| UI | Base UI, Lucide React |
Tema desteği ve Zod ile env doğrulama da şablonla birlikte gelir.
ViraStack AI bu seçimleri agent kurallarına dönüştürür (kural kataloğuna bak). Start ayrıca üç tasarım skill’i kurar: emil-design-eng, better-ui ve better-accessibility (ayrıntılar).
Testler
Her şablon Vitest, Testing Library ve MSW kurulu ve hazır gelir.
vitest.config.tsvesrc/test/: jsdom kurulumu,renderWithProvidersyardımcısı ve yakalanmayan isteklerde hata veren bir MSW sunucusu.npx virastack add usersörnek testlerle gelir: bir yardımcı fonksiyon (get-initials.test.ts), MSW ile bir API fonksiyonu (get-users.api.test.ts) ve bir bileşen (UsersDirectory.test.tsx).pnpm testbir kez çalışır,pnpm test:watchizlemeye devam eder. CI testleri build’den önce çalıştırır. Komutlar sayfasına bak.
Klasör yapısı
src/
├── app/ | routes/ # Next.js App Router | TanStack file-based routing
├── features/
│ └── home/ # Başlangıç sayfası (silinebilir)
│ ├── components/
│ ├── constants/
│ ├── helpers/
│ └── icons/
├── components/
│ ├── ui/
│ └── shared/
├── config/
├── constants/
├── helpers/
├── hooks/
├── lib/
├── messages/ # Sadece i18n şablonlarında
├── providers/
├── schemas/
├── stores/
├── styles/
├── test/ # Vitest kurulumu, render yardımcısı, MSW sunucusu
├── types/
└── env.ts
.agents/skills/ # emil-design-eng, better-ui, better-accessibility
.claude/ # Kurallar ve skill’ler (Claude Code ile)
.cursor/rules/virastack/ # ViraStack AI kuralları (Cursor ile)
.virastack/ai.json # ViraStack AI manifesti
AGENTS.md
CLAUDE.mdESLint, feature’lar arası import’ları ve üst dizine giden ../ import’larını engeller. Bu ağaçtaki sınırlar sadece önerilmez, uygulanır.
Kuruluma dönmek için kurulum, bayraklar için CLI sayfalarına bak.