Kurulum
Gereksinimler, kurulum komutu, CLI soruları ve sonraki adımlar.
Hızlı başlangıç
Şablonlar Node.js ^22.22.2, ^24.15.0 veya 26 ve üstünü ister. Önerilen paket yöneticisi pnpm’dir; npm, yarn ve bun da desteklenir.
$ pnpm dlx virastack@latestBu komut etkileşimli menüyü açar. Sessiz kurulum ve tüm bayraklar için CLI sayfasına bak.
CLI ne sorar?
- Proje adı: klasör adı
- Şablon: Next.js App Router veya TanStack Start
- AI kodlama araçları: Claude Code, Cursor veya ikisi (ikisi de seçili gelir). Hiçbirini seçmezsen düz kurallar
.agents/rules/içine kurulur. - i18n: çoklu dil şablonu istiyor musun?
- Araçlar:
@virastack/mask,@virastack/password,@virastack/addressgibi opsiyonel paketler.
Kurulum sonrası
Ardından CLI projeyi şu sırayla hazırlar:
- Git deposunu oluşturur ve bağımlılıkları kurar. Böylece husky hook’larını kurabilir.
- Sadece Next.js:
AGENTS.mddosyasına Next.js bloğunu yazar. Bu blok agent’larınode_modules/next/dist/docs/içindeki dokümana yönlendirir. - ViraStack AI seçtiğin AI araçlarıyla çalışır: kurallar
.claude/rules/virastack/ve.cursor/rules/virastack/içine, kural haritasıAGENTS.mdiçine yazılır. Kurulan dosyalar sayfasına bak. - Üç tasarım skill’i kurar.
- İlk commit’i atar.
git statustemiz kalır.
Tasarım skill’leri
Üç skill, Cursor ve diğer agent’ların okuduğu .agents/skills/ içine kopyalanır. Claude Code seçiliyse .claude/skills/ içine de gider; Claude Code tek araçsa yalnızca oraya. Skill’ler symlink değil, dosya olarak kopyalanır.
emil-design-eng(emilkowalski/skills): Emil Kowalski’nin animasyon, etkileşim ve detay odaklı tasarım mühendisliği.better-ui(jakubkrehel/skills): Jakub Krehel’in yüzey, ikon ve animasyon için net değerler veren arayüz cilası.better-accessibility(jakubkrehel/skills): erişilebilir bileşenler, odak yönetimi ve semantik HTML.
Her skill ayrı kurulur. Biri başarısız olursa diğerleri durmaz. Skill’ler sadece çevrimdışıyken atlanır; CLI o zaman sonradan eklemek için komutu yazdırır. --skip-install onları atlamaz.
.prettierignore neden AI dosyalarını içerir
Şablonun .prettierignore dosyası AGENTS.md, CLAUDE.md, .agents, .claude, .cursor, .virastack ve skills-lock.json dosyalarını hariç tutar. ViraStack AI bu dosyaları özetle (hash) izler; Prettier biçimlendirseydi sonraki güncelleme onları senin düzenlemen sayıp güncellemeyi bırakırdı. Böylece lint:ci da senin yazmadığın dosyalar yüzünden başarısız olmaz.
Projeyi çalıştır
Proje dizinine girip geliştirme sunucusunu başlat:
$ pnpm devAna sayfa src/features/home içindeki kısa başlangıç sayfasıdır. Kendi ürününe geçerken silebilirsin.
İlk yapılacaklar (FIXME)
Şablonlar ilk yapılacakları FIXME: yorumlarıyla işaretler. Repoda bu işareti ara, sonra sırayla güncelle:
- Adım 1: Site meta verisi (
src/config/site.config.ts): varsayılan açıklama ve sosyal linkleri ürün adın, metnin ve URL’lerinle değiştir. Ad ve kök URL.envüzerinden gelir:- Next.js için
NEXT_PUBLIC_APP_NAME,NEXT_PUBLIC_APP_URL - TanStack Start için
VITE_APP_NAME,VITE_APP_URL
- Next.js için
- Adım 2: Uzak görseller (yalnızca Next.js) (
next.config.ts): CDN veya medya host’larınıimages.remotePatternsaltına ekle. Bu FIXME yalnızca Next şablonlarındadır; TanStack Start’ta karşılığı yoktur. - Adım 3: API auth header (
src/lib/api.ts): auth isteğe bağlı olduğu için bu adımda FIXME işareti yok. Auth çözümünü seçtikten sonracreateApiçağrısınagetHeadersver. Bu başlıklar yalnızca kendi API’ne gider. Tüm şablonlarda ortaktır. - Adım 4: Env ve asset’ler:
.enviçinde ad/URL’yi güncelle; yeni değişken eklerkensrc/env.tsve.env.exampledosyalarını şablonunun prefix’iyle (NEXT_PUBLIC_*veyaVITE_*) senkron tut. Favicon ve statikleripublic/altında değiştir, web manifest’teki FIXME’nin istediği 192x192 ve 512x512 ikonları ekle.