Skip to content

Commit 9d468a9

Browse files
timurlenqsclaude
andcommitted
docs: README.md'yi tamamen Türkçe'ye çevir ve görselleri ekle
📝 Değişiklikler: - ✅ README.md tamamen Türkçe'ye çevrildi - 🖼️ Template vitrini görseli eklendi (README/TEMPLATES.PNG) - 🖼️ AI Agent prompt görseli eklendi (README/PROMPT.PNG) - 📝 Template kategorileri Türkçe açıklandı - 📝 Teknik terimler Türkçe'ye uyarlandı - 📝 Kullanım senaryoları Türkçe'ye çevrildi - 📝 Komut açıklamaları Türkçe'ye çevrildi 🎯 Amaç: - Türkçe geliştiriciler için daha anlaşılır dokümantasyon - GitHub'da profesyonel görünüm - Resimlerle desteklenmiş açıklamalar Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
1 parent c5169d8 commit 9d468a9

File tree

3 files changed

+101
-97
lines changed

3 files changed

+101
-97
lines changed

README.md

Lines changed: 101 additions & 97 deletions
Original file line numberDiff line numberDiff line change
@@ -1,75 +1,77 @@
11
# Vibe Coding Starter
22

3-
Next.js 16, TypeScript ve üretim seviyesinde uygulamalar geliştirmek için ihtiyacınız olan tüm araçlarla hızlı geliştirme için modern bir full-stack başlangıç kiti.
3+
Next.js 16, TypeScript ve production-ready uygulamalar geliştirmek için ihtiyacınız olan tüm araçları içeren modern full-stack başlangıç kiti.
44

5-
## 🚀 Yeni Özellik - Template Sistemi v1.0
5+
## 🚀 Yenilik - Template Sistemi v1.0
66

77
### ✨ 33 Production-Ready Template
88

9-
**Her bir AI agent uyumlu ve dokümante edilmiş!**
9+
Her biri AI agent uyumlu ve detaylı dokümantasyona sahip!
1010

1111
#### 📦 Template Kategorileri:
1212

13-
1. **Core Auth Templates** (4 template)
14-
- Login Page - Email/password form + validation
15-
- Register Page - Password strength indicator
16-
- Middleware - Route protection
17-
- Register API - User registration endpoint
18-
19-
2. **Dashboard Layout Templates** (4 template)
20-
- DashboardNavbar - Sticky navbar + blur effect
21-
- DashboardSidebar - Navigation menüsü
22-
- UserMenu - Kullanıcı dropdown menü
23-
- MobileMenu - Responsive sheet menu
24-
25-
3. **Dashboard Page Templates** (5 template)
26-
- Dashboard Home - İstatistikler + quick actions
27-
- Profile Page - Profil yönetimi
28-
- Settings Page - Tabs ile ayarlar
29-
- Billing Page - Stripe entegrasyonlu faturalandırma
30-
- Admin Page - Kullanıcı yönetim paneli
31-
32-
4. **API Route Templates** (5 template)
33-
- User API - CRUD operations
34-
- Profile API - Profil güncelleme
35-
- Password API - Şifre değiştirme
36-
- Stripe Checkout API - Ödeme işlemi
37-
- Stripe Webhook API - Webhook handler
38-
39-
5. **Database Schema Templates** (1 template)
40-
- Schema Extensions - Subscription, Invoice, AuditLog modelleri
41-
42-
6. **Email Templates** (4 template)
43-
- Welcome Email - Hoş geldin mesajı
44-
- Reset Password Email - Şifre sıfırlama
45-
- Invoice Email - Fatura bildirimi
46-
- Subscription Email - Abonelik yenileme
47-
48-
7. **Utility & Hook Templates** (6 template)
49-
- Validation Schemas - Zod validation
50-
- Stripe Utility - Helper fonksiyonlar
51-
- Email Utility - Email gönderme
52-
- useAuth Hook - Auth state management
53-
- useUser Hook - Kullanıcı işlemleri
54-
- useForm Hook - Form handling
55-
56-
8. **UI Component Templates** (5 template)
57-
- StatCard - İstatistik kartı
58-
- DataTable - Veri tablosu
59-
- EmptyState - Boş durum gösterimi
60-
- LoadingSpinner - Yükleme animasyonu
61-
- ErrorAlert - Hata bildirimi
62-
63-
### 🎯 Template Showcase Sayfası
64-
65-
Tüm template'leri görüntüleyin ve keşfedin:
13+
**1. Core Auth Templates** (4 template)
14+
- Giriş Sayfası - E-posta/şifre formu + doğrulama
15+
- Kayıt Sayfası - Şifre güç göstergesi
16+
- Middleware - Route koruması
17+
- Kayıt API - Kullanıcı kayıt endpoint'i
18+
19+
**2. Dashboard Layout Templates** (4 template)
20+
- Dashboard Navbar - Yapışkan navbar + blur efekti
21+
- Dashboard Sidebar - Navigasyon menüsü
22+
- Kullanıcı Menüsü - Dropdown menü
23+
- Mobil Menü - Responsive sheet menü
24+
25+
**3. Dashboard Sayfa Template'leri** (5 template)
26+
- Dashboard Ana Sayfa - İstatistikler + hızlı işlemler
27+
- Profil Sayfası - Profil yönetimi
28+
- Ayarlar Sayfası - Sekmeli ayarlar
29+
- Faturalandırma Sayfası - Stripe entegrasyonlu
30+
- Yönetici Paneli - Kullanıcı yönetimi
31+
32+
**4. API Route Template'leri** (5 template)
33+
- Kullanıcı API - CRUD işlemleri
34+
- Profil API - Profil güncelleme
35+
- Şifre API - Şifre değiştirme
36+
- Stripe Ödeme API - Ödeme işlemi
37+
- Stripe Webhook API - Webhook işleyici
38+
39+
**5. Veritabanı Şema Template'leri** (1 template)
40+
- Şema Eklentileri - Subscription, Invoice, AuditLog modelleri
41+
42+
**6. E-posta Template'leri** (4 template)
43+
- Hoş Geldin E-postası - Karşılama mesajı
44+
- Şifre Sıfırlama E-postası - Şifre yenileme
45+
- Fatura E-postası - Fatura bildirimi
46+
- Abonelik E-postası - Abonelik yenileme
47+
48+
**7. Yardımcı Fonksiyon ve Hook Template'leri** (6 template)
49+
- Doğrulama Şemaları - Zod validation
50+
- Stripe Yardımcıları - Helper fonksiyonlar
51+
- E-posta Yardımcıları - E-posta gönderme
52+
- useAuth Hook - Kimlik doğrulama state yönetimi
53+
- useUser Hook - Kullanıcı işlemleri
54+
- useForm Hook - Form yönetimi
55+
56+
**8. UI Bileşen Template'leri** (5 template)
57+
- İstatistik Kartı - Veri görselleştirme
58+
- Veri Tablosu - Tablo gösterimi
59+
- Boş Durum - Empty state gösterimi
60+
- Yükleniyor Animasyonu - Loading spinner
61+
- Hata Bildirimi - Error alert
62+
63+
### 🎯 Template Vitrin Sayfası
64+
65+
Tüm template'leri görsel olarak inceleyin:
66+
67+
![Template Vitrini](README/TEMPLATES.PNG)
6668

6769
```bash
6870
npm run dev
69-
# Git: http://localhost:3000/templates
71+
# Ziyaret et: http://localhost:3000/templates
7072
```
7173

72-
**Showcase özellikleri:**
74+
**Vitrin özellikleri:**
7375
- 📊 8 kategoride 33 template
7476
- 🔍 Her template için detaylı açıklama
7577
- 🤖 Hazır AI agent prompt şablonları
@@ -78,11 +80,13 @@ npm run dev
7880

7981
### 🤖 AI Agent ile Kullanım
8082

81-
Her template için hazırlanmış prompt şablonu vardır. Bu şablonları kopyalayıp AI agent'larınıza (Claude Code, Cursor, GitHub Copilot) yapıştırın.
83+
Her template için hazırlanmış prompt şablonu bulunur. Bu şablonları kopyalayıp AI agent'larınıza (Claude Code, Cursor, GitHub Copilot) yapıştırın.
84+
85+
![AI Agent Prompt](README/PROMPT.PNG)
8286

8387
#### Adım Adım Kullanım:
8488

85-
**1. Template Showcase Sayfasını Açın:**
89+
**1. Template Vitrin Sayfasını Açın:**
8690
```
8791
http://localhost:3000/templates
8892
```
@@ -97,13 +101,13 @@ Kopyaladığınız prompt şablonunu AI agent prompt'unuza yapıştırın.
97101

98102
**Örnek Prompt:**
99103
```
100-
Dashboard login sayfası eklemek istiyorum.
104+
Dashboard giriş sayfası eklemek istiyorum.
101105
@templates/core-auth-templates/PROMPT.md
102-
Login page template'ini projeme entegre eder misin? Şunları da yap:
106+
Giriş sayfası template'ini projeme entegre eder misin? Şunları da yap:
103107
- src/app/login/page.tsx olarak kopyala
104-
- Gerekli shadcn/ui component'lerini kontrol et (button, input, label, form)
108+
- Gerekli shadcn/ui bileşenlerini kontrol et (button, input, label, form)
105109
- useToast hook'unun kullanıldığından emin ol
106-
- NextAuth configuration'ı kontrol et (@/lib/auth)
110+
- NextAuth yapılandırmasını kontrol et (@/lib/auth)
107111
```
108112

109113
**4. AI Agent Otomatik Yapar:**
@@ -117,8 +121,8 @@ Login page template'ini projeme entegre eder misin? Şunları da yap:
117121
- **Framework:** Next.js 16 (App Router, Server Components, Turbopack)
118122
- **Dil:** TypeScript
119123
- **Stil:** Tailwind CSS 4 + shadcn/ui
120-
- **Veritabanı:** PostgreSQL ile Prisma ORM
121-
- **Kimlik Doğrulama:** NextAuth.js ile Prisma Adapter
124+
- **Veritabanı:** PostgreSQL + Prisma ORM
125+
- **Kimlik Doğrulama:** NextAuth.js + Prisma Adapter
122126
- **Backend:** Supabase
123127
- **Ödemeler:** Stripe
124128
- **E-posta:** React Email + Resend
@@ -129,7 +133,7 @@ Login page template'ini projeme entegre eder misin? Şunları da yap:
129133

130134
## Başlarken
131135

132-
### Ön Gereksinimler
136+
### Gereksinimler
133137

134138
- Node.js 18+
135139
- PostgreSQL veritabanı (veya Supabase hesabı)
@@ -138,40 +142,40 @@ Login page template'ini projeme entegre eder misin? Şunları da yap:
138142

139143
### Kurulum
140144

141-
1. Depoyu klonlayın:
145+
**1. Depoyu klonlayın:**
142146

143147
```bash
144148
git clone https://github.com/eyaprak/vibe-coding-starter.git
145149
cd vibe-coding-starter
146150
```
147151

148-
2. Bağımlılıkları yükleyin:
152+
**2. Bağımlılıkları yükleyin:**
149153

150154
```bash
151155
npm install
152156
```
153157

154-
3. Ortam değişkenleri dosyasını kopyalayın:
158+
**3. Ortam değişkenleri dosyasını kopyalayın:**
155159

156160
```bash
157161
cp .env.example .env
158162
```
159163

160-
4. `.env` dosyasında ortam değişkenlerinizi yapılandırın:
164+
**4. `.env` dosyasını yapılandırın:**
161165
- Veritabanı URL'i (Supabase PostgreSQL)
162166
- Supabase kimlik bilgileri
163167
- NextAuth gizli anahtarı
164168
- Stripe anahtarları
165169
- Resend API anahtarı
166170
- reCAPTCHA anahtarları
167171

168-
5. Veritabanı şemasını gönderin:
172+
**5. Veritabanı şemasını gönderin:**
169173

170174
```bash
171175
npm run db:push
172176
```
173177

174-
6. Geliştirme sunucusunu başlatın:
178+
**6. Geliştirme sunucusunu başlatın:**
175179

176180
```bash
177181
npm run dev
@@ -181,22 +185,22 @@ Uygulamanızı görmek için [http://localhost:3000](http://localhost:3000) adre
181185

182186
## Template Sistemi Kullanımı
183187

184-
### 🎨 Template Showcase Sayfası
188+
### 🎨 Template Vitrin Sayfası
185189

186190
```bash
187191
npm run dev
188-
# Git: http://localhost:3000/templates
192+
# Ziyaret et: http://localhost:3000/templates
189193
```
190194

191195
### 📂 Manuel Template Kullanımı
192196

193197
```
194198
templates/
195199
├── PROMPT.md # Ana rehber (tüm sistem)
196-
├── core-auth-templates/ # Auth template'leri
200+
├── core-auth-templates/ # Kimlik doğrulama template'leri
197201
│ ├── PROMPT.md # Kategori rehberi
198-
│ ├── login-page.tsx # Login template
199-
│ ├── register-page.tsx # Register template
202+
│ ├── login-page.tsx # Giriş template'i
203+
│ ├── register-page.tsx # Kayıt template'i
200204
│ └── ...
201205
└── ...
202206
```
@@ -209,36 +213,36 @@ templates/
209213

210214
### 🤖 AI Agent ile Örnek Kullanım
211215

212-
**Senaryo 1: Login Sayfası**
216+
**Senaryo 1: Giriş Sayfası**
213217
```
214218
1. /templates sayfasına git
215-
2. Core AuthenticationLogin Page'i seç
219+
2. Kimlik DoğrulamaGiriş Sayfası'nı seç
216220
3. Prompt şablonunu kopyala:
217221
218-
Dashboard login sayfası eklemek istiyorum.
222+
Dashboard giriş sayfası eklemek istiyorum.
219223
@templates/core-auth-templates/PROMPT.md
220-
Login page template'ini projeme entegre eder misin?
224+
Giriş sayfası template'ini projeme entegre eder misin?
221225
222226
→ AI agent:
223227
- templates/core-auth-templates/login-page.tsx'i okur
224228
- src/app/login/page.tsx olarak kopyalar
225-
- Gerekli shadcn/ui component'lerini ekler
229+
- Gerekli shadcn/ui bileşenlerini ekler
226230
- Middleware'i kurar
227231
- Test eder
228232
```
229233

230-
**Senaryo 2: Dashboard Layout**
234+
**Senaryo 2: Dashboard Düzeni**
231235
```
232236
1. /templates sayfasına git
233-
2. Dashboard Layout → Dashboard Navbar'ı seç
237+
2. Dashboard Düzeni → Dashboard Navbar'ı seç
234238
3. Prompt şablonunu kopyala:
235239
236-
Dashboard navbar component'i eklemek istiyorum.
240+
Dashboard navbar bileşeni eklemek istiyorum.
237241
@templates/dashboard-layout-templates/PROMPT.md
238-
DashboardNavbar component'ini src/components/dashboard/navbar.tsx olarak ekler misin?
242+
DashboardNavbar bileşenini src/components/dashboard/navbar.tsx olarak ekler misin?
239243
240244
→ AI agent:
241-
- Dashboard layout component'lerini ekler
245+
- Dashboard layout bileşenlerini ekler
242246
- Layout dosyasını günceller
243247
- Responsive tasarımı kontrol eder
244248
```
@@ -248,13 +252,13 @@ DashboardNavbar component'ini src/components/dashboard/navbar.tsx olarak ekler m
248252
1. Mevcut profile-page.tsx'i kontrol et
249253
2. Aşağıdaki prompt'u kullan:
250254
251-
Profil sayfasına telefon numarası field'ı eklemek istiyorum.
255+
Profil sayfasına telefon numarası alanı eklemek istiyorum.
252256
@templates/dashboard-page-templates/PROMPT.md
253257
254258
→ AI agent:
255259
- Mevcut profile-page.tsx'i inceler
256-
- Form field'ını ekler
257-
- Validation schema'yı günceller
260+
- Form alanını ekler
261+
- Doğrulama şemasını günceller
258262
- API'yi günceller
259263
- Prisma modelini günceller
260264
```
@@ -268,7 +272,7 @@ Profil sayfasına telefon numarası field'ı eklemek istiyorum.
268272
│ ├── app/ # Next.js App Router
269273
│ │ ├── api/ # API rotaları
270274
│ │ ├── (dashboard)/ # Dashboard rota grubu
271-
│ │ ├── templates/ # 🆕 Template showcase sayfası
275+
│ │ ├── templates/ # 🆕 Template vitrin sayfası
272276
│ │ ├── layout.tsx # Ana layout
273277
│ │ └── page.tsx # Ana sayfa
274278
│ ├── components/
@@ -298,8 +302,8 @@ Profil sayfasına telefon numarası field'ı eklemek istiyorum.
298302
| Komut | Açıklama |
299303
| --------------------- | ------------------------------------------ |
300304
| `npm run dev` | Turbopack ile geliştirme sunucusunu başlat |
301-
| `npm run build` | Üretim için derle |
302-
| `npm run start` | Üretim sunucusunu başlat |
305+
| `npm run build` | Production için derle |
306+
| `npm run start` | Production sunucusunu başlat |
303307
| `npm run lint` | ESLint'i çalıştır |
304308
| `npm run db:push` | Prisma şemasını veritabanına gönder |
305309
| `npm run db:generate` | Prisma client'ı oluştur |
@@ -308,10 +312,10 @@ Profil sayfasına telefon numarası field'ı eklemek istiyorum.
308312

309313
### 🆕 Template Sistemi
310314

311-
- **33 Ready-to-Use Template** - Her biri production ready
315+
- **33 Kullanıma Hazır Template** - Her biri production ready
312316
- **AI Agent Uyumlu** - Claude Code, Cursor, Copilot ile çalışır
313317
- **Kategorize Edilmiş** - 8 ana kategori
314-
- **Dokümante Edilmiş** - Her template'te JSDoc comments
318+
- **Dokümante Edilmiş** - Her template'te JSDoc yorumları
315319
- **Prompt Şablonları** - Hazır AI agent prompt'ları
316320
- **Detaylı Açıklamalar** - Her template için özellik listesi
317321

@@ -370,7 +374,7 @@ npx prisma db push
370374

371375
### Diğer Platformlar
372376

373-
Üretim paketini derleyin:
377+
Production paketini derleyin:
374378

375379
```bash
376380
npm run build

README/PROMPT.PNG

40.1 KB
Loading

README/TEMPLATES.PNG

37.7 KB
Loading

0 commit comments

Comments
 (0)