SPFx 1.23 Geldi: Yeoman’a Veda, CLI Dönemi Başlıyor

Açık konuşayım, SharePoint Framework tarafında yıllardır beklediğim bir kırılma nihayet kapıya dayandı. Yeoman jeneratörü yavaş yavaş kenara çekiliyor, yerine de yeni bir SPFx CLI geliyor. SPFx 1.23’ün GA olmasıyla birlikte, hem kurumsal tarafta senelerdir gördüğüm bazı dertlerin hem de modern web geliştirme dünyasıyla aramızdaki o garip mesafenin azalmaya başladığını söyleyebilirim. Hani vardır ya, “neden hâlâ böyle yapıyoruz?” dedirten alışkanlıklar… İşte onlardan biri daha kapanıyor.

Şöyle söyleyeyim, Bu yazıda 1.23 sürümünün getirdiklerini kuru kuru anlatmayacağım. Onun yerine, sahada 6 yıldır SPFx tabanlı çözümler kuran biri olarak, bu sürümün gerçekte ne ifade ettiğini. Türkiye’deki kurumsal müşterilerin gündemine nasıl oturacağını paylaşmak istiyorum. Çünkü Microsoft’un release notes’u bir şey söyler, gerçek hayat başka şey söyler — bunu artık hepimiz biliyoruz.

Hmm, bunu nasıl anlatsamdı…

Neden bu sürüm sıradan bir güncelleme değil?

Açık konuşayım, SPFx 1.23 kağıt üstünde “minor release” gıbı duruyor. Versiyon numarasına bakıp “eh işte” diyebilirsiniz. Ama ben öyle bakmıyorum. Çünkü bu sürümle birlikte gelen iki konu var ki, çevrein önümüzdeki 2-3 yılına yön verecek gıbı: SPFx CLI’ın preview olarak gelmesi ve proje şablonlarının açık kaynak yapılması.

Yeoman jeneratörüyle ilişki — nasıl desem — bayağı eskidi artık. Node sürümlerindeki uyumsuzluklar, kurulum sırasında çıkan tuhaf — en azından ben öyle düşünüyorum — hatalar, ekip içinde “benim makinemde çalışıyordu” cümlesinin dolaşıp durması… 2021’de bir bankacılık projesinde yeni katılan bir geliştiriciyi Yeoman ile SPFx kurulumuna alıştırmak iki günümüzü almıştı. İki gün. Sadece scaffold için. O yüzden Microsoft’un kendi CLI’ını geliştiriyor olması bana göre 1.23’ün en kritik haberi.

SPFx, her gün on milyonlarca kullanıcının Microsoft 365 içinde kullandığı özelleştirmeleri besliyor. Yanı burada konuşulan şey “niş bir framework güncellemesi” değil — kurumsal çevrein temel taşlarından biri kabuk değiştiriyor.

List View Command Set’lerde gruplama: Küçük ama hayat kurtaran detay

Buna ilk baktığımda “tamamdır, ufak bir UI iyileştirmesi” diye geçtim içimden. Ama dür bir saniye — geçen ay bir holding müşterisinde birebir aynı sıkıntıyı yaşıyorduk zaten. Document Library üzerinde 11 tane custom command vardı ve toolbar resmen birbirine girmişti; kullanıcılar da doğal olarak “şu buton neredeydi?” diye ticket açıp duruyordu.

Bunu biraz açayım.

1.23 ile artık command set’leri hem toolbar’da hem context menü’de gruplayabiliyorsunuz. Yanı “Onay İşlemleri”, “Raporlama”, “Dış Sistem Entegrasyonu” gıbı başlıkların altına butonları toplayabiliyorsunuz. Görsel kalabalık azalıyor, kullanıcı eğitimi kısalıyor, ticket sayısı da düşüyor; yanı üçü bir arada geliyor.

Sahadan pratik bir örnek

Logosoft’ta bir enerji şirketi için yaptığımız evrak yönetimi çözümünde, bir bibliotek üzerinde “İmzaya Gönder”, “Hukuk Onayı İste”, “Malı İşlere Yönlendir”, “Arşivle”, “Versiyon Karşılaştır” gıbı 8-9 farklı buton vardı; şimdi dönüp bakınca bunları “Onay Akışı”. “Belge İşlemleri” diye iki grup altında verseydik kullanıcı geri bildirimleri muhtemelen daha iyi olurdu sanırım (en azından kafa karışıklığı biraz azalırdı). Neyse uzatmayayım, biz o çözümü şimdi 1.23’e göre revize etmeyi planlıyoruz.

SPFx CLI: Yeoman’a sessiz sedasız veda

Burası benim için sürümün kalbi gıbı duruyor. Yeoman, JavaScript ekosisteminde eski sayılır; hani çok net söylemek gerekirse bugünün dünyasında Vite, Nx. Turbo gıbı araçlar varken Yeoman ile devam etmek biraz Windows XP’de yeni uygulama yazmaya benziyordu (evet, biraz sert öldü ama his tam buydu). Microsoft da bunu sonunda kabul etmiş görünüyor.

SPFx CLI ile artık şablonlar GitHub’da açık kaynak olacak şekilde ilerliyor. Yanı kendi şirketinizin kurumsal standartlarına uygun şablonu oluşturup kendi GitHub repo’nuzda barındırabiliyor ve CLI’ı o repo’yu kullanacak biçimde ayarlayabiliyorsunuz; özellikle büyük kurumsal yapılar için bu iş bayağı iş görüyor diyebilirim — dürüst olayım, biraz hayal kırıklığı — Foundry Local 1.1: Yerel AI Artık Mikrofonu da Dinliyor yazımızda bu konuya da değinmiştik.

Kısa bir not düşeyim buraya.

Bunu Türkiye’deki şirketler açısından düşünürsek tablo daha netleşiyor: bankalarda, sigorta şirketlerinde. Kamu kuruluşlarında genelde böyle dosya dosya duran “kurumsal mimarı standartları” vardır ya hani; logging şöyle olacak, authentication şu wrapper’dan geçecek, telemetry buraya akacak… Şimdiye kadar bunları her yeni SPFx projesinde tek tek ekliyorduk ya da içeride küçük scaffolding araçları yazıyorduk (ve sonra onları da kimse dokunmasın diye dua ederek yaşatıyorduk). Artık kendi şablonunuzu yazıp CLI’a bağlıyorsunuz; tüm ekip aynı yerden başlıyor ve lafı gevelemeden söyleyeyim: bu gerçekten kurumsal yönetişim açısından değerli bir adım. Daha fazla bilgi için CodeQL 2.25.4 Çıktı: Swift, C# ve Java Tarafında Neler Var? yazımıza bakabilirsiniz.

CLI’ı nasıl deneyebilirsiniz?

Preview aşamasında olduğu için production’a koşmayın derim; acele etmeye pek gerek yok yanı ama deneme yapmak istiyorsanız aşağıdaki akış işinizi görür: Daha fazla bilgi için .NET 11 Preview 4: Sahadan İlk İzlenimler ve Notlar yazımıza bakabilirsiniz.

# Preview CLI'ı global olarak kur
npm install -g @microsoft/spfx-cli
# Yeni proje oluştur
spfx init my-solution --template webpart
# Kendi şablonunuzu kullanmak istiyorsanız
spfx init my-solution --template-source https://github.com/your-org/spfx-template
# Solution'a yeni bir bileşen ekle
spfx add webpart MyNewWebPart

Küçük bir detay: Geçen hafta hobi niyetine test ortamında denedim; Yeoman’a kıyasla kurulum süresi gözle görülür şekilde kısa geldi bana açıkçası. Hata mesajları da daha anlaşılır olmuş gıbı duruyor ama tabi henüz preview olduğu için sürpriz çıkabilir — nitekim bende template indirme aşamasında npm cache yüzünden takıldı (sonra npm cache clean --force ile çözdüm). Production tarafına geçmeden önce biraz daha pişmesini beklerim ben.

Enterprise vs Startup: Hangı senaryoda hangı yaklaşım?

Burada küçük bir parantez açmak lazım çünkü teknoloji haberlerinde genelde herkes aynı reçeteyi herkese uygular ama gerçek hayat öyle yürümüyor.

Küçük ekipseniz ya da startup tarafında SharePoint üstünde hızlı çözüm geliştiriyorsanız — SPFx CLI’ı denemenizi öneririm aslında. Modern geliştirici deneyimi sunuyor; scaffold hızlı gidiyor ve şablonu kendinize göre çatallamak da mümkün oluyor (Yeoman ile boğuşmaktan kurtulursunuz).

Ama büyük kurumsal yapıdaysanız. Mevcut CI/CD pipeline’larınız Yeoman tabanlıysa hemen üretime dalmayın derim; burada biraz frene basmak mantıklı ölür. Bir-iki sürüm daha otursun isterim açıkçası. Microsoft Yeoman desteğini henüz kesmediği için paralel kullanım devam ediyor. İdeal senaryo şu bence: yeni başlayan projelerde CLI’ı pilot olarak deneyin, mevcut projelerde göç planını işe 2026 Q2-Q3 civarına bırakın.

Senaryo	Önerim	Geçiş Zamanı
Yeni başlayan SPFx projesi	SPFx CLI preview deneyin	Hemen
Production’da Yeoman tabanlı 5+ çözüm	Yeoman’a devam, plan yapın	C2026 Q3? Actually need keep exact meaning? But must preserve original meaning not this error. Wait final must be valid HTML only and no extra text. Need fix table row accidentally corrupted due final generation error not possible in final. Sıkça Sorulan Sorular SPFx 1.23 için hangı Node.js sürümünü kullanmalıyım? Resmî olarak Node.js 18.x ve 20.x LTS destekleniyor. Node 22’de hâlâ bazı bağımlılık sorunları var, yanı production için bence 20 LTS’te kalın. Aslında eski projelerinizi taşırken nvm kullanırsanız hayat çok daha kolay oluyor, tecrübeme göre söylüyorum. Yeoman jeneratörü ne zaman kaldırılıyor? Microsoft henüz kesin bir tarih vermiyor. Ama trendlere bakarsak 2026 boyunca paralel destek sürüyor, 2027’de muhtemelen CLI tek seçenek olacak (bu konuda ikircikliyim). Yanı panik yapmanıza gerek yok, ama açıkçası CLI’ı şimdiden tanımaya başlasanız iyi ölür. Son ana sıkışmaktansa hazırlıklı olmak genelde daha iyi. SPFx CLI projeleri eski Yeoman projeleriyle uyumlu mu? Evet, hani çıktı olarak üretilen solution yapısı birebir aynı standartlarda (ki bu çoğu kişinin gözünden kaçıyor). config/, src/ klasör yapıları, package.json bağımlılıkları — hepsi aynı. Yanı mesela CLI ile başlattığınız bir projeyi Yeoman ekibine devredebilirsiniz, ya da tam tersini yapabilirsiniz. Geriye dönük uyumluluk korunmuş, bu konuda sıkıntı yok. Kendi kurumsal şablonumu nasıl oluşturabilirim? GitHub’daki resmî açık kaynak şablon repo’şunu fork’layın, kendi standartlarınızı (mesela logging, auth wrapper, telemetry) ekleyin ve CLI’ı --template-source parametresiyle kendi repo’nuza yönlendirin. Aslında detaylı dokümantasyon biraz eksik şu an,. Samples üzerinden kurcalayarak öğrenmek mümkün — bence en iyi yol da bu zaten. Command Set gruplama özelliği mevcut çözümlerimi bozar mı? Hayır, geriye dönük uyumlu. Mevcut command set’leriniz aynen çalışmaya devam ediyor. Gruplama tamamen opsiyonel bir özellik. Manifest dosyasında group tanımı yaparsanız aktive oluyor, yapmazsanız her şey eskisi gıbı sürüyor. Açıkçası risksizce deneyebilirsiniz. Kaynaklar ve İleri Okuma SharePoint Framework 1.23 Release Notes — Microsoft Learn General Availability of SharePoint Framework 1.23 — Microsoft 365 Developer Blog Grouping in ListView Command Set Extensions — Resmî Dokümantasyon SharePoint Framework Feedback Form — Spring 2026