Script’ler
İşe göre doğru script — yerel geliştirme, kalite kapıları ve CI.
Her şablon aynı kalite script’leriyle gelir. Framework’e özel olanlar aşağıda. Tercihen pnpm; npm, yarn ve bun aynı şekilde çalışır.
Günlük
| Komut | Ne zaman kullan |
|---|---|
pnpm dev | Yerel geliştirme sunucusunu başlatır (Next.js Turbopack; TanStack Start Vite, port 3000). |
pnpm build | Üretim build’i. Deploy öncesi veya build’i yerelde doğrulamak için. |
pnpm start | Üretim build’ini sunar (Next.js) veya Vite build’ini önizler (TanStack Start). |
Kalite
| Komut | Ne zaman kullan |
|---|---|
pnpm lint | Önbellekli ESLint. Kod yazarken erken yakalamak için. |
pnpm lint:fix | ESLint sorunlarını otomatik düzeltir, ardından Prettier yazar. |
pnpm lint:ci | CI için katı lint: sıfır uyarı + Prettier check. GitHub Actions ile aynı kapı. |
pnpm format | Tüm repoyu Prettier ile formatlar. |
pnpm format:check | Dosya yazmadan format kontrolü (CI dostu). |
pnpm typecheck | tsc --noEmit ile TypeScript kontrolü. Tip değiştirdiyseniz push öncesi çalıştırın. |
pnpm knip | Kullanılmayan dosya, export ve bağımlılıkları bulur. Şablonu sade tutar. |
Husky commit’te lint-staged, push’ta ilgili kontrolleri çalıştırır. CI yerelde kırılmadıkça tam suite’i elle koşmanız nadiren gerekir.
Framework’e özel
Bu script’ler yalnızca ilgili şablonda vardır:
| Komut | Şablon | Ne zaman kullan |
|---|---|---|
pnpm analyze | nextjs | Bundle analyzer build’i. Client bundle boyutunu önemsediğinizde kullanın. |
pnpm generate-routes | tanstack | Route ekleyip yeniden adlandırdıktan sonra TanStack Router route tree’yi yeniden üretir. |
pnpm preview | tanstack | Üretim Vite build’ini önizler (pnpm start ile aynı fikir). |
pnpm clean | tanstack | Vite / TanStack build cache’lerini temizler (dist, .tanstack, .output). |
CI
Şablondaki GitHub Actions şu sırayı çalıştırır:
typecheck → lint:ci → knip → buildCI kırılırsa aynı sırayı yerelde tekrarlayın: pnpm typecheck && pnpm lint:ci && pnpm knip && pnpm build.