🚀 Türkiye'nin En Modern CV Oluşturucu Platformu

Basit fikirlerle güçlü deneyimler ✨

Hayalinizdeki işe adım atmak için profesyonel bir CV'ye ihtiyacınız var. Karmaşık tasarım programları ya da pahalı hizmetler yerine, dakikalar içinde etkileyici CV'nizi oluşturun!

🎯 Hemen Deneyin • 📋 Özellikler • 🛠️ Kurulum • 🤝 Katkıda Bulun

📸 Önizleme

Modern, kullanıcı dostu arayüz ile dakikalar içinde profesyonel CV oluşturun

🎨 Desteklenen Şablonlar

Minimal Template - Temiz ve sade CV tasarımı

🎯 Minimal Template
Temiz ve sade tasarım

Modern Template - Renkli sidebar CV düzeni

🚀 Modern Template
Renkli sidebar düzeni

Professional Template - Kurumsal CV görünümü

💼 Professional Template
Kurumsal görünüm

📱 Responsive Tasarım

CV Builder Responsive Design - Mobil ve masaüstü uyumlu

Tüm cihazlarda mükemmel görünüm - iPhone'dan 4K monitöre kadar!

✨ Özellikler

🎨 Modern Tasarım

3 farklı profesyonel şablon
Temiz ve sade görünüm
Renkli ve dinamik seçenekler
Kurumsal ve resmi stil

📱 Mobil Uyumlu

iPhone SE'den 4K monitöre responsive
Touch-friendly arayüz
Tüm cihazlarda mükemmel görünüm
Dark mode desteği

⚡ Hızlı & Kolay

Dakikalar içinde CV oluşturun
Gerçek zamanlı önizleme
Otomatik kaydetme (localStorage)
Tek tıkla PDF indirme

🔒 Güvenli & Özel

Veriler sadece tarayıcınızda
Hiçbir sunucuya gönderilmez
Kayıt gerektirmez
Tamamen ücretsiz

🌍 Türkçe Optimizasyonu

Türk iş piyasası için optimize
Ehliyet kategorileri (A, B, C...)
Doğum yeri ve tarih alanları
Medeni durum ve cinsiyet

📄 A4 PDF Çıktısı

Yazdırmaya hazır format
Yüksek kalite çıktı
Standart CV boyutları
Otomatik sayfa düzeni

🛠️ Teknoloji Stack'i

Core Technologies

React 19 - Modern kullanıcı arayüzü
Tailwind CSS 3.4 - Utility-first CSS framework
Lucide React - Modern icon library
html2pdf.js - Client-side PDF generation
GitHub Pages - Ücretsiz hosting

Build Tools

Create React App - Zero-config build setup
PostCSS - CSS processing
Autoprefixer - CSS vendor prefixes
gh-pages - Automated deployment

🚀 Hızlı Başlangıç

📋 Ön Gereksinimler

Node.js (v16 veya üzeri)
npm veya yarn
Git

⚡ Kurulum

# 1. Projeyi klonlayın
git clone https://github.com/Wupani/cv-app.git
cd cv-app

# 2. Bağımlılıkları yükleyin
npm install

# 3. Geliştirme sunucusunu başlatın
npm start

# 4. Tarayıcınızda açın
# http://localhost:3000

🏗️ Production Build

# Production build oluştur
npm run build

# Build'i test et
npx serve -s build

🌐 GitHub Pages'e Deploy

# package.json'da homepage'i güncelleyin
"homepage": "https://yourusername.github.io/cv-app"

# Deploy edin
npm run deploy

📁 Proje Yapısı

📦 cv-app
├── 📂 public/
│   ├── 🌟 favicon.svg          # Custom favicon
│   ├── 📄 index.html           # Main HTML template
│   └── 📋 manifest.json        # PWA manifest
├── 📂 src/
│   ├── 📂 components/
│   │   ├── 🏠 LandingPage.jsx     # Ana sayfa + tanıtım
│   │   ├── 📝 CVForm.jsx          # CV form bileşeni
│   │   ├── 👁️ CVPreview.jsx       # Gerçek zamanlı önizleme
│   │   ├── 🎨 TemplateSelector.jsx # Şablon seçici
│   │   ├── 🌈 ColorSelector.jsx   # Renk seçici
│   │   ├── 🔤 FontSelector.jsx    # Font seçici
│   │   └── 📥 DownloadButton.jsx  # PDF indirme
│   ├── 📂 templates/
│   │   ├── 🎯 MinimalTemplate.jsx  # Minimal CV şablonu
│   │   ├── 🚀 ModernTemplate.jsx   # Modern CV şablonu
│   │   └── 💼 ProfessionalTemplate.jsx # Kurumsal şablon
│   ├── 📂 utils/
│   │   └── 📄 pdfExporter.js      # PDF export utility
│   ├── ⚙️ App.js                  # Ana uygulama
│   ├── 🎨 index.css              # Global styles
│   └── 🚀 index.js               # Entry point
├── 📄 package.json
├── 📋 README.md
└── ⚙️ tailwind.config.js

🎯 Kullanım Kılavuzu

1️⃣ Ana Sayfa

Güzel tanıtım sayfası ile karşılanırsınız
6 özellik kartı ile uygulamanın gücünü görün
3 şablon önizlemesi ile seçim yapın
"CV Oluşturmaya Başla" butonuna tıklayın

2️⃣ Şablon & Renk Seçimi

Minimal: Temiz ve sade tasarım
Modern: Renkli sidebar düzeni
Professional: Kurumsal görünüm
9 farklı renk seçeneği
8 farklı font seçeneği

3️⃣ CV Bilgilerini Girme

📝 Kişisel Bilgiler

Ad Soyad (zorunlu)
E-posta ve telefon
Adres bilgisi
Web sitesi ve LinkedIn
Profil fotoğrafı
Doğum tarihi ve yeri
Ehliyet kategorileri
Medeni durum ve cinsiyet

📋 Özet Bölümü

600 karakter limiti
Gerçek zamanlı karakter sayacı
Yazma ipuçları ve örnekler
"Çok kısa" / "İdeal" / "Çok uzun" geri bildirimi

💼 İş Deneyimi

Pozisyon adı
Şirket adı ve lokasyon
Başlangıç ve bitiş tarihleri
"Halen çalışıyorum" seçeneği
800 karakter detaylı açıklama

🎓 Eğitim

Okul/Üniversite adı
Bölüm ve derece
Başlangıç ve bitiş tarihleri
Not ortalaması (opsiyonel)

🔧 Yetenekler & Diller

Teknik yetenekler (tags)
Yabancı dil seviyeleri
Hobi ve ilgi alanları
Sertifikalar ve kurslar

4️⃣ PDF İndirme

Tek tıkla yüksek kalite PDF
A4 boyutunda optimize
Yazdırmaya hazır format
Dosya adı: "Ad_Soyad_CV.pdf"

🔧 Geliştirici Rehberi

🎨 Yeni Şablon Ekleme

src/templates/ klasörüne yeni dosya oluşturun:

// YeniTemplate.jsx
import React from 'react';

const YeniTemplate = ({ cvData, selectedColor, selectedFont }) => {
  // Şablon JSX'i
  return (
    <div className="bg-white p-4">
      {/* Şablon içeriği */}
    </div>
  );
};

export default YeniTemplate;

TemplateSelector.jsx'e şablonu ekleyin:

const templates = [
  // ... mevcut şablonlar
  { id: 'yeni', name: 'Yeni Şablon', description: 'Açıklama' }
];

CVPreview.jsx'de render edin:

case 'yeni':
  return <YeniTemplate cvData={cvData} selectedColor={selectedColor} selectedFont={selectedFont} />;

🌈 Yeni Renk Teması

ColorSelector.jsx dosyasında yeni renk ekleyin:

const colors = [
  // ... mevcut renkler
  { id: 'purple', name: 'Mor', class: 'bg-purple-500' }
];

📱 Responsive Breakpoints

/* Tailwind breakpoints */
sm: 640px   /* Küçük tabletler */
md: 768px   /* Tabletler */
lg: 1024px  /* Küçük laptoplar */
xl: 1280px  /* Masaüstü */
2xl: 1536px /* Büyük ekranlar */

🧪 Test Etme

# Tüm testleri çalıştır
npm test

# Test coverage raporu
npm test -- --coverage

# E2E testler (gelecekte)
npm run test:e2e

📊 Performans

Lighthouse Score: 95+ (Performance, SEO, Accessibility)
Bundle Size: ~260KB (gzipped)
Load Time: <2 saniye (3G bağlantıda)
Core Web Vitals: Tüm metrikler yeşil

🌟 Yol Haritası

🔄 Yakın Zamanda

📧 Email ile CV gönderme
🌐 Çoklu dil desteği (EN, DE, FR)
💾 Cloud backup (isteğe bağlı)
📊 CV analiz ve önerileri

🚀 Gelecek Planlar

🤖 AI destekli içerik önerileri
🎨 Custom şablon editörü
📈 CV takip sistemi
💼 İş ilanları entegrasyonu

🤝 Katkıda Bulunma

Bu projeye katkıda bulunmak istiyorsanız:

🐛 Bug Report

Issue oluşturun ve şunları belirtin:

Hata açıklaması
Tekrar etme adımları
Beklenen davranış
Ekran görüntüleri

✨ Feature Request

Feature isteği oluşturun:

Özellik açıklaması
Kullanım senaryosu
Mockup'lar (varsa)

🔧 Development

Fork yapın
Feature branch oluşturun (git checkout -b feature/amazing-feature)
Commit yapın (git commit -m 'Add: amazing feature')
Push edin (git push origin feature/amazing-feature)
Pull Request açın

📋 Code Style

# ESLint kuralları
npm run lint

# Prettier formatting
npm run format

# Pre-commit hooks aktif
npm run prepare

📄 Lisans

Bu proje MIT Lisansı altında lisanslanmıştır.

MIT License - Özgürce kullanın, değiştirin ve dağıtın! 🎉

🙏 Teşekkürler

💖 Açık Kaynak Projeler

React - Kullanıcı arayüzü kütüphanesi
Tailwind CSS - CSS framework
Lucide - Modern icon library
html2pdf.js - PDF generation

🌟 İlham Kaynakları

👥 Katkıda Bulunanlar