Frontend Dosya Yapısı Nasıl Olmalı?

Temiz, sürdürülebilir ve ölçeklenebilir yapı HTML · CSS · Proje Düzeni

Frontend projelerinde dosya yapısı, kodun okunabilirliği ve sürdürülebilirliği açısından kritik bir öneme sahiptir. Küçük projelerde bile doğru yapı kurmak, ileride oluşabilecek karmaşayı ciddi ölçüde azaltır.

1️⃣ Neden Dosya Yapısı Önemlidir?

Rastgele oluşturulmuş dosyalar, proje büyüdükçe kontrol edilemez hale gelir. İyi bir dosya yapısı:

  • Kodu daha okunur yapar
  • Bakımı kolaylaştırır
  • Yeni geliştiricilerin projeyi hızlı anlamasını sağlar
  • Hata ayıklamayı hızlandırır

2️⃣ Basit Bir Frontend Proje Yapısı

Küçük ve orta ölçekli statik projeler için önerilen temel yapı:

/
├── index.html
├── iletisim.html
├── projelerim/
│   └── index.html
├── blog/
│   ├── index.html
│   └── blog-yazisi.html
├── assets/
│   ├── css/
│   │   └── main.css
│   └── images/
│       └── arkaplan.jpg

3️⃣ CSS Dosyalarının Ayrılması

Küçük projelerde tek bir main.css yeterlidir. Proje büyüdükçe CSS dosyalarını ayırmak mantıklıdır:

css/
├── main.css
├── components.css
├── pages.css

Bu sayede her dosya kendi sorumluluğunu taşır.

4️⃣ Görsellerin Yönetimi

Görselleri mutlaka ayrı bir klasörde tut. Dosya isimleri anlamlı ve küçük harfli olmalı:

images/
├── arkaplan.jpg
├── profil.jpg
├── project-weatherwear.png

5️⃣ HTML Sayfaları Nasıl Düzenlenmeli?

HTML dosyalarında:

  • Tek bir sorumluluk olmalı
  • Inline CSS kullanılmamalı
  • Tekrarlanan yapı sınıflarla çözülmeli

6️⃣ En Sık Yapılan Hatalar

  • Tüm CSS’i tek dosyada kontrolsüz büyütmek
  • Görselleri root dizine atmak
  • Sayfa isimlerinde büyük/küçük harf karmaşası
  • Relative path’leri yanlış kullanmak

7️⃣ Sonuç

Frontend projelerinde dosya yapısı, yazılım kalitesini doğrudan etkiler. Basit ama düzenli bir yapı kurmak, hem geliştirici deneyimini hem de projenin uzun ömürlü olmasını sağlar.