SvelteKit 3 Yayınlandı: Yenilikler, Kırıcı Değişiklikler ve Geçiş Rehberi
SvelteKit 3, 1 Ekim 2026'da sv 1.0 ile birlikte yayınlandı. Yapılandırma vite.config.ts'e taşındı, $lib yerini #lib'e bıraktı, adaptörlerde önemli değişiklikler var. Yenilikler, kırıcı değişiklikler ve sv migrate ile geçiş adımları.
İçindekiler
- SvelteKit 3'te öne çıkan yenilikler
- Yapılandırma artık vite.config.ts içinde
- $lib yerine #lib
- Ortam değişkenleri, service worker ve hata yönetimi
- Remote functions henüz hazır değil
- Kırıcı değişiklikler
- Node adaptörü kullananlar dikkat
- Adaptörlerdeki yeni özellikler
- sv 1.0: Svelte'in resmi komut satırı aracı
- Mevcut projeyi SvelteKit 3'e taşıma
- Sık sorulan sorular
- Sonuç
Svelte ekibi 1 Ekim 2026'da SvelteKit 3'ü kararlı sürüm olarak yayınladı. Aynı gün projelerin oluşturulmasından taşınmasına kadar her işi üstlenen komut satırı aracı sv 1.0 da çıktı. Ağustos'ta yayınlanan sürüm adayının ardından gelen bu sürüm, yapılandırmayı sadeleştiriyor, ortam değişkenlerini ve hata yönetimini iyileştiriyor ve adaptörlerde önemli davranış değişiklikleri getiriyor.
Bu yazıda SvelteKit 3'teki yenilikleri, kırıcı değişiklikleri ve mevcut bir projeyi nasıl taşıyacağınızı özetliyoruz.
SvelteKit 3'te öne çıkan yenilikler
Yapılandırma artık vite.config.ts içinde
SvelteKit 3'ün en görünür değişikliği, yapılandırmanın svelte.config.js dosyasından vite.config.ts dosyasına taşınması. Böylece SvelteKit ayarları, Vite eklentileri ve derleme seçenekleri tek bir TypeScript dosyasında toplanıyor. Adaptörler de Vite eklentisi eklerken Svelte yapılandırmasını fonksiyon argümanı olarak alıyor.
$lib yerine #lib
Uzun süredir kullanılan $lib takma adı yerini #lib'e bırakıyor. Yeni takma ad, Node.js'in standart subpath imports (paket içi yol içe aktarma) özelliğini kullanıyor. Bu, takma adın yalnızca SvelteKit'e özgü bir sihir olmaktan çıkıp Node.js, TypeScript ve diğer araçların doğrudan anlayabildiği bir yapıya dönüşmesi demek. Kütüphane yayınlayanlar için svelte-package artık #lib tarzı takma adları göreli yollara çeviriyor.
svelte-package ayrıca sunucuya özel modüller .server. uzantılı dosyalardan ya da server klasörlerinden içe aktarılmadığında uyarı veriyor. Bu, sunucu kodunun yanlışlıkla istemci paketine sızmasını önlemeye yardımcı oluyor.
Ortam değişkenleri, service worker ve hata yönetimi
Svelte ekibi ortam değişkenlerinin daha güçlü ve kullanımının daha kolay hale geldiğini belirtiyor. Değişkenler artık instrumentation.server.js çalışmadan önce dolduruluyor; böylece izleme (instrumentation) kodu da ortam değişkenlerine erişebiliyor. Service worker yazmak daha az kalıp kod gerektiriyor ve hata yönetimi genel olarak iyileştirildi.
Remote functions henüz hazır değil
İstemci ile sunucu arasında tip güvenli iletişim sağlayan remote functions özelliği SvelteKit 3 ile kararlı hale gelmedi. Bu özellik, şu an experimental bayrağı gerektiren Async Svelte'e (bileşenlerde await ifadeleri) bağlı. Projelerinizi bu özellik üzerine kurmayı planlıyorsanız deneysel olduğunu göz önünde bulundurun.
Kırıcı değişiklikler
SvelteKit 3 "bir avuç" kırıcı değişiklik içeriyor. Resmi taşıma rehberinde listelenenlerin önemlileri şunlar:
| Alan | Değişiklik |
|---|---|
| Yapılandırma | svelte.config.js yerine vite.config.ts |
| Takma ad | $lib yerine #lib |
| Single-flight mutation | İstemcinin istediği bir yenileme işlenmezse sunucu hata veriyor. Bilerek atlamak için requested üzerinde ignore() ya da ignoreAll() çağrılmalı |
| Sorgu parametreleri | x-sveltekit- ile başlayan parametreler reddediliyor |
| Builder API | builder.generateManifest yerine builder.generateServerInstance ve builder.manifest. Server kurucusu ve SSRManifest tipi artık herkese açık değil |
| Cloudflare adaptörü | platform nesnesi kaldırıldı; bağlamalar (bindings) taklit edilen cloudflare:workers modülünden geliyor |
| Node adaptörü | Yalnızca derleme anında var olan dosyalar sunuluyor, Last-Modified yerine içerik özetli ETag kullanılıyor, yalnızca GET ve HEAD isteklerine yanıt veriliyor |
| Netlify adaptörü | Statik dosyalar netlify.toml yerine publish seçeneğine göre yazılıyor |
Node adaptörü kullananlar dikkat
adapter-node ile kendi sunucusunda çalışan projeler için en önemli değişiklik statik dosya sunumu. Adaptör artık sirv yerine derleme sırasında kaydedilen tabloları kullanıyor. Bu, çalışma anında static klasörüne sonradan eklenen dosyaların (örneğin kullanıcı yüklemeleri) artık sunulmayacağı anlamına geliyor. Bu tür dosyaları ayrı bir dizinden, Nginx gibi bir ters vekilden ya da nesne depolama servisinden sunmanız gerekir. Ters vekil yapılandırması için Nginx nedir? yazımıza bakabilirsiniz.
Adaptörlerdeki yeni özellikler
- Adaptörler,
vite devvevite previewsırasındagetRequestvesetResponsedavranışını değiştirebiliyor. Böylece geliştirme ortamı, gerçek dağıtım platformuna daha çok benziyor. adapter-netlify,splitveedgeseçeneklerini birlikte destekliyor.adapter-auto, Render'a sıfır yapılandırmayla dağıtım yapabiliyor.
sv 1.0: Svelte'in resmi komut satırı aracı
sv 1.0 ile yeni projeler doğrudan SvelteKit 3 ve #lib ile oluşturuluyor. Topluluk eklentileri (add-on) API'si resmileşti ve sv create artık addon şablonuyla yeni bir eklenti iskeleti de oluşturabiliyor. Görsel optimizasyonu için @sveltejs/enhanced-img resmi bir eklenti olarak sunuluyor:
npx sv add enhanced-imgMevcut projeyi SvelteKit 3'e taşıma
Svelte ekibi taşıma işinin büyük kısmını otomatik yapan bir komut sunuyor:
npx sv migrate sveltekit-3 --tasks all --confirmKomut, kod tabanının olabildiğince büyük kısmını taşıyor ve elle yapılması gereken işler için bir yapılacaklar listesi üretiyor. Önerilen adımlar:
- Ayrı bir dalda çalışın. Taşımadan önce temiz bir git durumu olduğundan emin olun; böylece komutun yaptığı değişiklikleri satır satır inceleyebilirsiniz. Git ile ilgili temel bilgiler için Git nedir? yazısına göz atabilirsiniz.
- Komutu çalıştırın ve üretilen yapılacaklar listesini okuyun.
- Adaptör değişikliklerini kontrol edin. Özellikle Node ve Cloudflare adaptörü kullanıyorsanız yukarıdaki tabloyu kontrol edin.
x-sveltekit-önekli sorgu parametresi kullanıp kullanmadığınızı arayın.- Testleri ve derlemeyi çalıştırın, ardından önizleme ortamında deneyin.
Yeni bir proje başlatmak içinse tek komut yeterli:
npx sv create my-new-appSık sorulan sorular
SvelteKit 3, Svelte 5 gerektiriyor mu?
Duyuru yazısı minimum sürüm gereksinimlerini listelemiyor. Node.js, Vite ve Svelte sürüm gereksinimleri için resmi taşıma rehberini (/docs/kit/migrating-to-sveltekit-3) kontrol edin.
$lib içeren eski kodlarım hemen bozulur mu?
sv migrate komutu bu içe aktarmaları #lib'e çevirir. Elle taşıyorsanız tüm $lib kullanımlarını aratıp değiştirmeniz gerekir.
Remote functions'ı üretimde kullanabilir miyim? Henüz önerilmiyor. Özellik, deneysel bayrak gerektiren Async Svelte'e bağlı.
Sonuç
SvelteKit 3, büyük bir yeniden yazım değil; yapılandırmayı Vite ile birleştiren, takma adları standartlara yaklaştıran ve adaptör davranışlarını netleştiren bir olgunlaşma sürümü. Otomatik taşıma aracı işin çoğunu yaptığı için küçük ve orta ölçekli projelerde geçiş birkaç saatte tamamlanabilir. Kendi sunucusunda Node adaptörüyle çalışan ve çalışma anında dosya sunan projelerin ise statik dosya değişikliğini önceden planlaması gerekiyor.
Benzer İçerikler
Next.js Kasım 2026 Güvenlik Güncellemesi: 7 Açık, 16.4.5 ve 15.5.29 Sürümleri
Next.js 3 Kasım 2026'da 16.4.5 ve 15.5.29 sürümleriyle yedi güvenlik açığını kapattı. Açıkların çoğu Cache Components ve use cache önbelleğinde kullanıcılar ve kiracılar arası veri sızıntısına yol açabiliyor. Etkilenen yapılar ve güncelleme adımları.
17 Kas 20263 kaynakWEB2 DKNginx Nedir? Web Sunucusu, Ters Vekil ve Yük Dengeleyici
Nginx, olay tabanlı asenkron mimarisiyle çok sayıda eşzamanlı bağlantıyı düşük kaynakla karşılayan açık kaynaklı bir web sunucusudur. Statik içerik sunmanın yanı sıra ters vekil (reverse proxy), yük dengeleyici ve önbellek olarak da kullanılır; server ve location blokları üzerinden bildirimsel olarak yapılandırılır.
27 Eki 20261 kaynakWEB3 DKGraphQL Nedir? API'ler İçin Sorgu Dili
GraphQL, istemcinin sunucudan tam olarak ihtiyaç duyduğu veriyi tek istekte almasını sağlayan bir API sorgu dili ve çalışma zamanıdır. Güçlü tiplenmiş şema, query/mutation/subscription işlemleri ve resolver mantığıyla REST'in aşırı ve yetersiz veri çekme sorunlarını çözer.
27 Eki 20262 kaynak