Kurulum

Gereksinimler, kurulum komutu, CLI soruları ve sonraki adımlar.

Hızlı başlangıç

Node.js 20.9+ gerekir. Önerilen paket yöneticisi pnpm’dir; npm, yarn ve bun da desteklenir.

$ pnpm dlx virastack@latest

Bu komut etkileşimli menüyü açar. Sessiz kurulum ve tüm bayraklar için CLI sayfasına bakın.

CLI ne sorar?

Proje adı: klasör adı
Şablon: Next.js App Router veya TanStack Start
i18n: çoklu dil şablonu istiyor musunuz?
Araçlar: @virastack/mask, @virastack/password gibi opsiyonel paketler.

Kurulum sonrası

Bağımlılıklar kurulur; ardından ViraStack AI AGENTS.md, CLAUDE.md ve .cursor/rules dosyalarını yazar.

İki tasarım skill’i .agents/skills/ altına eklenir:

emil-design-eng: Emil Kowalski tasarım / UI dili
make-interfaces-feel-better: Jakub Krehel arayüz hissi ve animasyon

Proje dizinine girip geliştirme sunucusunu başlatın:

$ pnpm dev

Ana sayfa örnek landing feature’ını gösterir — kendi ürününüze geçerken silebilirsiniz.

İlk yapılacaklar (FIXME)

Şablonlar ilk yapılacakları FIXME: yorumlarıyla işaretler. Repoda bu işareti arayın, sonra sırayla güncelleyin:

Adım 1 — Site meta verisi (src/config/site.config.ts): varsayılan açıklama ve sosyal linkleri ürün adınız, metniniz ve URL’lerinizle değiştirin. 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
Adım 2 — Uzak görseller (yalnızca Next.js) (next.config.ts): CDN veya medya hostlarınızı images.remotePatterns altına ekleyin. 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 çözümünü seçtikten sonra buildHeaders içinde token’ı ekleyin (yorumdaki Authorization: Bearer örneği). Tüm şablonlarda ortaktır.
Adım 4 — Env ve asset’ler: .env içinde ad/URL’yi güncelleyin; yeni değişken eklerken src/env.ts ve .env.example dosyalarını şablonunuzun prefix’iyle (NEXT_PUBLIC_* veya VITE_*) senkron tutun. Favicon ve statikleri public/ altında değiştirin.

Kurulum sonrası

Bağımlılıklar kurulur; ardından ViraStack AI AGENTS.md, CLAUDE.md ve .cursor/rules dosyalarını yazar.

İki tasarım skill’i .agents/skills/ altına eklenir:

emil-design-eng: Emil Kowalski tasarım / UI dili

make-interfaces-feel-better: Jakub Krehel arayüz hissi ve animasyon

Proje dizinine girip geliştirme sunucusunu başlatın:

$ pnpm dev

Ana sayfa örnek landing feature’ını gösterir — kendi ürününüze geçerken silebilirsiniz.

İlk yapılacaklar (FIXME)

Şablonlar ilk yapılacakları FIXME: yorumlarıyla işaretler. Repoda bu işareti arayın, sonra sırayla güncelleyin:

Adım 1 — Site meta verisi (src/config/site.config.ts): varsayılan açıklama ve sosyal linkleri ürün adınız, metniniz ve URL’lerinizle değiştirin. 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

Adım 2 — Uzak görseller (yalnızca Next.js) (next.config.ts): CDN veya medya hostlarınızı images.remotePatterns altına ekleyin. 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 çözümünü seçtikten sonra buildHeaders içinde token’ı ekleyin (yorumdaki Authorization: Bearer örneği). Tüm şablonlarda ortaktır.

Adım 4 — Env ve asset’ler: .env içinde ad/URL’yi güncelleyin; yeni değişken eklerken src/env.ts ve .env.example dosyalarını şablonunuzun prefix’iyle (NEXT_PUBLIC_* veya VITE_*) senkron tutun. Favicon ve statikleri public/ altında değiştirin.