Neden Next.js ile Umbraco 17'yi Birlikte Kullanıyoruz
Headless mimaride Umbraco 17 ile Next.js 16'nın nasıl birleştirildiği, Delivery API kullanımı ve blok tabanlı render yaklaşımı ele alınıyor.
Bu içerikte, .NET 10 üzerinde çalışan Umbraco 17'nin içerik backend'i, Next.js 16 ve React 19'un ise sunum katmanı olarak kullanıldığı headless bir mimari anlatılıyor. İki uygulama yalnızca HTTP üzerinden, Umbraco'nun yerleşik Delivery API'si aracılığıyla haberleşiyor; bu sayede CMS ve frontend bağımsız olarak geliştirilip yayınlanabiliyor. Editörler Block Grid editörüyle iç içe geçmiş bloklardan sayfalar oluşturuyor, Next.js tarafında ise bu bloklar tek bir catch-all route üzerinden içerik tipine göre ilgili React bileşenine yönlendirilerek sunucu tarafında render ediliyor.
Delivery API'nin kapsamadığı arama, filtreleme, form gönderimleri ve medya optimizasyonu gibi ihtiyaçlar için özel endpoint'ler ve Next.js'in görsel optimizasyon araçları devreye giriyor. Yazı, bu yaklaşımın getirdiği hız, SEO kontrolü ve ekiplerin birbirini beklemeden çalışabilmesi gibi avantajların yanında; güncel ekosistemlerde daha az örnek bulunması ve preview, sitemap, secrets yönetimi gibi işlerin manuel kurulması gerekmesi gibi dezavantajlarını da dürüstçe ortaya koyuyor. Mühendisler için bu, headless CMS mimarisinde pratik bir tasarım kararı örneği sunuyor.