İçeriğe geç
BilgiKütüphanesi
Web Geliştirme

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ı.

İlk yayın: 4 dk okuma3 kaynak

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 dev ve vite preview sırasında getRequest ve setResponse davranışını değiştirebiliyor. Böylece geliştirme ortamı, gerçek dağıtım platformuna daha çok benziyor.
  • adapter-netlify, split ve edge seç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-img

Mevcut 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 --confirm

Komut, 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:

  1. 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.
  2. Komutu çalıştırın ve üretilen yapılacaklar listesini okuyun.
  3. Adaptör değişikliklerini kontrol edin. Özellikle Node ve Cloudflare adaptörü kullanıyorsanız yukarıdaki tabloyu kontrol edin.
  4. x-sveltekit- önekli sorgu parametresi kullanıp kullanmadığınızı arayın.
  5. 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-app

Sı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