Yeni başlangıç sayfası, eklenip kaldırılabilen modüller ve güncel araçlar

Yeni projeler kısa bir başlangıç sayfasıyla kuruluyor, hazır modüller tek komutla eklenip kaldırılıyor; API katmanı ve araç sürümleri yenilendi, dört paket yöneticisi destekleniyor, Node aralığı yükseldi.

Ne değişti

Başlangıç sayfası: Landing kalktı. Yerine sonraki adımları ve kullandığın stack'i sürümleriyle gösteren kısa bir sayfa geldi. Marka logosu font indirmeden inline SVG olarak çiziliyor.
virastack add <modül>: users, checkout-address ve checkout-card modüllerini virastack.com/r registry'sinden dört template'e de kurar. Yalnızca feature kurar, sayfa oluşturmaz: CLI import satırını yazar, modülün sayfası framework'üne ve sayfa yoluna göre prompt ve manuel adımlar verir. init modül kurmaz; başlangıç sayfası hazır modüllere yönlendirir. i18n'de çeviriler src/messages içine birleştirilir; çakışma varsa hiçbir dosya değişmez.
checkout-address: Teslimat ve fatura adresi seçimi, popup'ta ekleme ve düzenleme. Form @virastack/address ve @virastack/mask kullanır.
checkout-card: Kayıtlı kart seçimi ve yeni kart formu. Kart numarası ve CVV network'e çıkmaz; POST yalnızca dummy token, marka, son dört hane, son kullanma tarihi ve adı taşır.
virastack remove <modül>: Modülün dosyalarını, boş kalan klasörlerini ve çevirilerini siler, paketleri bırakır. Değiştirdiğin dosyalar varsa silmeden önce sorar.
API katmanı: api.ts içinde api.get(path, { schema }) yanıtı doğrular ve tipi çıkarır. ApiError.kind hatayı http, network, timeout ve parse olarak ayırır. createApi({ baseUrl, getHeaders }) ile auth başlıkları yalnızca kendi API'ne gider. Varsayılan zaman aşımı 10 saniye.
React Compiler: Next.js ve TanStack Start template'lerinin ikisinde de açık. Next.js tarafında artık yalnızca production'da değil.
Araçlar: ESLint 10, MSW 3, Vitest 5 ve pnpm 12. tsc TypeScript 7 ile, typescript-eslint ve next build TypeScript 6 ile çalışır.
Prettier: Varsayılanlar semi: false ve trailingComma: "none". Dört template'te aynı .prettierrc var.
SEO: Başlangıç sayfasında canonical var, APP_URL yoksa production'da uyarı çıkar, kökteki sabit og:url kalktı. Next.js X-Powered-By başlığını göndermez.
Paket yöneticileri: npm, Yarn, bun ve pnpm destekleniyor. init, ci.yml ve husky hook'larını seçtiğin paket yöneticisine göre yazar, gereken ayar dosyasını ekler.
i18n: Varsayılan dil / adresinde, diğer dil /tr altında. Dili yalnızca URL belirler, otomatik yönlendirme yok; hreflang etiketleri geliyor.
shadcn: Dört template'e components.json eklendi, shadcn add kurulu projede hazır çalışır.
Layout shift: TanStack Start template'lerinde Inter için metriği eşlenmiş fallback ve preload var.

Neden

Landing: Kullanıcının ilk silmek zorunda kaldığı bir pazarlama sayfasıydı ve bir sonraki adımı göstermiyordu.
Modüller registry'de: Template yalın kalıyor, modül istenince ekleniyor ve kaldırılıyor. Yeni modül için CLI sürümü gerekmiyor.
Sayfa kurulmaması: Hangi sayfaya gireceğine sen karar veriyorsun; iki modül aynı sayfada çakışmıyor, /checkout gibi bir sayfayı kendin birleştiriyorsun.
API: Aynı Zod kalıbı tekrar ediyordu, auth yalnızca yorum satırındaydı, retry hem api.ts hem TanStack Query içinde olunca çağrı sayısı katlanıyordu.
Araçlar: ESLint 9 artık desteklenmiyor. 1.2.0 template'leri pnpm 11 ve 12'de kurulumda ERR_PNPM_IGNORED_BUILDS basıyordu. TypeScript 7.0'da API yok, bu yüzden Microsoft'un önerdiği alias ile iki sürüm birlikte çalışıyor; tsc ölçümümüzde Next.js için 2,6 sn'den 0,51 sn'ye, TanStack Start için 2,3 sn'den 0,37 sn'ye indi.
Node: Node 20 desteği bitti. jsdom gibi bağımlılıklar da daha yüksek sürüm istiyor; Yarn 1 kurulumu bu yüzden düşüyordu.
Paket yöneticileri: Yalnızca pnpm yazan CI, diğer yöneticilerde düşüyordu. shadcn/ui pnpm-workspace.yaml dosyasını görüp npm projesinde pnpm çalıştırıyordu, Yarn 4'te Plug'n'Play build ve lint'i bozuyordu.
Tek yapı: ViraStack AI kuralları barrel'sız yapıyı ve tek alias'ı anlatıyor; template bununla çelişmemeli. Tek yönlü import, feature silindiğinde paylaşılan kodun bozulmamasını sağlıyor.
SEO: Sayfadaki openGraph kök ayarı tamamen ezdiği için sayfa bazında url senin kararın. Template'teki llms.txt ise kullanıcının sitesinde ViraStack'i anlatıyordu.
i18n: Google dile göre otomatik yönlendirmemeyi öneriyor.
Layout shift: Inter, TanStack Start template'inde CLS 0,207'ye yol açıyordu; üç ölçümde de 0,000 oldu.
Sınırlar: Windows denenmedi. Üretilen ci.yml GitHub Actions'ta çalıştırılmadı. api.ts gerçek bir üretim API'si ve auth ile denenmedi. Modüller yalnızca dummy API ve dummy veriyle çalışır; gerçek API'yi bağlamak sana kalır.

Kaynaklar

Geçiş

Bu sürüm mevcut projeleri değiştirmez. Aşağıdakiler 2.0.0 ile kurulan yeni projeler için geçerli; 1.x projeni taşımak istersen bunları elle uygulaman gerekir. virastack add users 2.0.0 projelerinde denendi, eski projelerde denenmedi.

Kırılan değişiklikler:

Node: Template'ler ^22.22.2 || ^24.15.0 || >=26.0.0 istiyor. Önceki taban >=20.9.0.
Alias: Yalnızca @/* var. @/ui, @/layout, @/hooks, @/schemas ve #/* kalktı.
Barrel: Uygulama kodunda index.ts barrel'ları kalktı, import'lar tanımlandığı dosyaya gider.
Tek yönlü import: Shared klasörler feature ve route, feature'lar route import ederse ESLint hata verir.
Mesajlar: i18n mesajları messages/ yerine src/messages/ altında. Paraglide ayarları baseLocale, locales ve {locale} kullanıyor.
api.ts: retry seçeneği kalktı, retry makeQueryClient içinde. Şema vermezsen sonuç unknown. Yanıt gelmeyen hatalarda status null, ayrım kind ile yapılır.
Paketler: clsx ve tailwind-merge yerine cn paketi var. motion kalktı. TanStack Start template'lerinde nuqs yerine validateSearch kullanılıyor.
MSW 3: onUnhandledRequest yerine onUnhandledFrame, import'lar msw/http üzerinden.
pnpm: package.json içindeki pnpm alanı kalktı, ayarlar pnpm-workspace.yaml ve allowBuilds ile yazılıyor.
Kalkan dosyalar: public/llms.txt, .changeset ve i18n'siz Next.js template'inde proxy.ts.

Ne değişti

Başlangıç sayfası: Landing kalktı. Yerine sonraki adımları ve kullandığın stack'i sürümleriyle gösteren kısa bir sayfa geldi. Marka logosu font indirmeden inline SVG olarak çiziliyor.
virastack add <modül>: users, checkout-address ve checkout-card modüllerini virastack.com/r registry'sinden dört template'e de kurar. Yalnızca feature kurar, sayfa oluşturmaz: CLI import satırını yazar, modülün sayfası framework'üne ve sayfa yoluna göre prompt ve manuel adımlar verir. init modül kurmaz; başlangıç sayfası hazır modüllere yönlendirir. i18n'de çeviriler src/messages içine birleştirilir; çakışma varsa hiçbir dosya değişmez.
checkout-address: Teslimat ve fatura adresi seçimi, popup'ta ekleme ve düzenleme. Form @virastack/address ve @virastack/mask kullanır.
checkout-card: Kayıtlı kart seçimi ve yeni kart formu. Kart numarası ve CVV network'e çıkmaz; POST yalnızca dummy token, marka, son dört hane, son kullanma tarihi ve adı taşır.
virastack remove <modül>: Modülün dosyalarını, boş kalan klasörlerini ve çevirilerini siler, paketleri bırakır. Değiştirdiğin dosyalar varsa silmeden önce sorar.
API katmanı: api.ts içinde api.get(path, { schema }) yanıtı doğrular ve tipi çıkarır. ApiError.kind hatayı http, network, timeout ve parse olarak ayırır. createApi({ baseUrl, getHeaders }) ile auth başlıkları yalnızca kendi API'ne gider. Varsayılan zaman aşımı 10 saniye.
React Compiler: Next.js ve TanStack Start template'lerinin ikisinde de açık. Next.js tarafında artık yalnızca production'da değil.
Araçlar: ESLint 10, MSW 3, Vitest 5 ve pnpm 12. tsc TypeScript 7 ile, typescript-eslint ve next build TypeScript 6 ile çalışır.
Prettier: Varsayılanlar semi: false ve trailingComma: "none". Dört template'te aynı .prettierrc var.
SEO: Başlangıç sayfasında canonical var, APP_URL yoksa production'da uyarı çıkar, kökteki sabit og:url kalktı. Next.js X-Powered-By başlığını göndermez.
Paket yöneticileri: npm, Yarn, bun ve pnpm destekleniyor. init, ci.yml ve husky hook'larını seçtiğin paket yöneticisine göre yazar, gereken ayar dosyasını ekler.
i18n: Varsayılan dil / adresinde, diğer dil /tr altında. Dili yalnızca URL belirler, otomatik yönlendirme yok; hreflang etiketleri geliyor.
shadcn: Dört template'e components.json eklendi, shadcn add kurulu projede hazır çalışır.
Layout shift: TanStack Start template'lerinde Inter için metriği eşlenmiş fallback ve preload var.

Neden

Landing: Kullanıcının ilk silmek zorunda kaldığı bir pazarlama sayfasıydı ve bir sonraki adımı göstermiyordu.
Modüller registry'de: Template yalın kalıyor, modül istenince ekleniyor ve kaldırılıyor. Yeni modül için CLI sürümü gerekmiyor.
Sayfa kurulmaması: Hangi sayfaya gireceğine sen karar veriyorsun; iki modül aynı sayfada çakışmıyor, /checkout gibi bir sayfayı kendin birleştiriyorsun.
API: Aynı Zod kalıbı tekrar ediyordu, auth yalnızca yorum satırındaydı, retry hem api.ts hem TanStack Query içinde olunca çağrı sayısı katlanıyordu.
Araçlar: ESLint 9 artık desteklenmiyor. 1.2.0 template'leri pnpm 11 ve 12'de kurulumda ERR_PNPM_IGNORED_BUILDS basıyordu. TypeScript 7.0'da API yok, bu yüzden Microsoft'un önerdiği alias ile iki sürüm birlikte çalışıyor; tsc ölçümümüzde Next.js için 2,6 sn'den 0,51 sn'ye, TanStack Start için 2,3 sn'den 0,37 sn'ye indi.
Node: Node 20 desteği bitti. jsdom gibi bağımlılıklar da daha yüksek sürüm istiyor; Yarn 1 kurulumu bu yüzden düşüyordu.
Paket yöneticileri: Yalnızca pnpm yazan CI, diğer yöneticilerde düşüyordu. shadcn/ui pnpm-workspace.yaml dosyasını görüp npm projesinde pnpm çalıştırıyordu, Yarn 4'te Plug'n'Play build ve lint'i bozuyordu.
Tek yapı: ViraStack AI kuralları barrel'sız yapıyı ve tek alias'ı anlatıyor; template bununla çelişmemeli. Tek yönlü import, feature silindiğinde paylaşılan kodun bozulmamasını sağlıyor.
SEO: Sayfadaki openGraph kök ayarı tamamen ezdiği için sayfa bazında url senin kararın. Template'teki llms.txt ise kullanıcının sitesinde ViraStack'i anlatıyordu.
i18n: Google dile göre otomatik yönlendirmemeyi öneriyor.
Layout shift: Inter, TanStack Start template'inde CLS 0,207'ye yol açıyordu; üç ölçümde de 0,000 oldu.
Sınırlar: Windows denenmedi. Üretilen ci.yml GitHub Actions'ta çalıştırılmadı. api.ts gerçek bir üretim API'si ve auth ile denenmedi. Modüller yalnızca dummy API ve dummy veriyle çalışır; gerçek API'yi bağlamak sana kalır.

Geçiş

Kırılan değişiklikler:

Node: Template'ler ^22.22.2 || ^24.15.0 || >=26.0.0 istiyor. Önceki taban >=20.9.0.
Alias: Yalnızca @/* var. @/ui, @/layout, @/hooks, @/schemas ve #/* kalktı.
Barrel: Uygulama kodunda index.ts barrel'ları kalktı, import'lar tanımlandığı dosyaya gider.
Tek yönlü import: Shared klasörler feature ve route, feature'lar route import ederse ESLint hata verir.
Mesajlar: i18n mesajları messages/ yerine src/messages/ altında. Paraglide ayarları baseLocale, locales ve {locale} kullanıyor.
api.ts: retry seçeneği kalktı, retry makeQueryClient içinde. Şema vermezsen sonuç unknown. Yanıt gelmeyen hatalarda status null, ayrım kind ile yapılır.
Paketler: clsx ve tailwind-merge yerine cn paketi var. motion kalktı. TanStack Start template'lerinde nuqs yerine validateSearch kullanılıyor.
MSW 3: onUnhandledRequest yerine onUnhandledFrame, import'lar msw/http üzerinden.
pnpm: package.json içindeki pnpm alanı kalktı, ayarlar pnpm-workspace.yaml ve allowBuilds ile yazılıyor.
Kalkan dosyalar: public/llms.txt, .changeset ve i18n'siz Next.js template'inde proxy.ts.