create-better-react

Better React mikro-SaaS şablonu için CLI aracı.

Kurulum

npx create-better-react my-app

Kullanım

İnteraktif mod (varsayılan)

npx create-better-react my-app

Adımlar:

1. Proje adı
2. Özellik seçimi — Users örneği (varsayılan açık), Supabase, Testing
3. Supabase bilgileri (isteğe bağlı, atlanabilir)
4. Paket yöneticisi
5. Git deposu (varsayılan: açık)

Varsayılanlarla kurulum

npx create-better-react my-app -y

• Dashboard odaklı şablon (tanıtım sayfaları dahil değil)
• Users API örneği açık
• Tek dil: İngilizce
• Supabase, Testing kapalı
• Git deposu açık

npx create-better-react my-app -y --no-users     # Users örneğini atla
npx create-better-react my-app -y --no-supabase    # Supabase kapalı (varsayılan zaten kapalı)

Seçenekler

| Seçenek | Açıklama | | ---------------- | ----------------------------------- | | -y, --yes | Varsayılanlarla kur, soru sorma | | --no-supabase | Supabase entegrasyonunu atla (-y) | | --no-testing | Test altyapısını atla (-y) | | --no-users | Users API örneğini atla (-y) | | --pm <manager> | pnpm (varsayılan), npm, yarn, bun | | --no-git | Git deposu başlatma | | --local <path> | Yerel şablon yolu (geliştirme) |

Marka yönetimi

Kurulum sonrası tüm marka/SEO ayarlarını tek dosyadan düzenleyin:

src/config/brand.ts

CLI her zaman kaldırır

• Landing, changelog, tech stack, components showcase
• Demo SVG logolar ve react-markdown
• Turkish locale (tr.json) and language switcher
• Seçilmeyen entegrasyonların docs/ dosyaları

Scaffold sonrası yapı

RootLayout (dashboard)
├── index → minimal HomePage
├── users → (opsiyonel) liste + detay
└── * → NotFoundPage

Geliştirme

cd cli
pnpm install
pnpm build
node dist/index.js my-app --local /path/to/better-react --yes

npm otomatik yayın (yalnızca better-react repo)

main branch'e cli/** değişikliği push edildiğinde GitHub Actions create-better-react paketini npm'e yayımlar.

Tek seferlik kurulum:

1. npm hesabında Automation tipinde access token oluşturun
2. GitHub repo → Settings → Secrets and variables → Actions → NPM_TOKEN secret'ı ekleyin
3. CLI değişikliği merge etmeden önce cli/package.json içinde sürümü artırın

Aynı sürüm npm'de zaten varsa workflow yayını atlar (hata vermez).

Oluşturulan projelerde .github/ klasörü scaffold sırasında kaldırılır; bu workflow yalnızca şablon reposunda kalır.

Lisans

MIT