# React State Yönetim Mimarisi

> Hangi kütüphane sorusundan önce state'in doğasını tanımlamayı merkeze alan üst düzey React state mimarisi yaklaşımı.

Source: https://omergulcicek.com/blog/react-state-yonetim-mimarisi

State yönetimi tartışmaları genellikle "Hangi kütüphaneyi kullanmalıyım?" sorusuyla başlar. Oysa asıl soru şudur: **Yönettiğim state'in doğası ne?** Bu soruya net bir yanıt vermeden seçilen araçlar, mimariyi geliştirmek yerine sadece karmaşıklığı artırır. Üst düzey bir state stratejisi oluşturmak için önce state'in türünü tanımlamak, ardından React'ın yerleşik çözümlerini değerlendirmek, abonelik (subscription) mekanizmalarını anlamak ve araçları en son aşamada birer optimizasyon katmanı olarak konumlandırmak gerekir.

## 1. Temel Yapı: State'in Doğası

Mimari kararların temelini şu sınıflandırma oluşturur:[^jsdev]

- **UI state:** Yalnızca arayüz etkileşimlerini yöneten stateler (modal açma/kapama, dropdown, form alanları, akordiyon). Kapsamı genellikle tek bir bileşen veya dar bir alt ağaçla sınırlıdır.
- **Server Cache:** Aslında sunucuda yer alan ancak istemcide hızlı erişim için tutulan verilerdir. Kullanıcı profili, veri listeleri veya API yanıtları bu kapsama girer. Bu, UI state değil, bir **cache**'tir;[^kent] veri geçersiz kılma (invalidation), yeniden çekme (refetch) ve "stale-while-revalidate" gibi problemler state kütüphanelerinin değil, cache katmanının uzmanlık alanıdır.
- **İş Akışı / Domain State:** Kritik iş süreçleri (taslak → gönderildi → tamamlandı), çok adımlı akışlar ve zaman içinde izlenmesi/hata ayıklanması (debug) gereken state geçişleridir.
- **Yüksek Frekanslı Etkileşimler:** Sürüklenebilir arayüzler, gerçek zamanlı grafikler veya çok sayıda widget içeren paneller. Burada asıl mesele sadece verinin nerede durduğu değil, "kimin hangi veriye abone olduğu ve render sıklığı"dır.

![React Prop](https://omergulcicek.com/blog/2026/02-01/passing-props.webp)

Bu dört kategoriyi netleştirmeden "global store" kullanmaya veya "her şeyi Context'e taşımaya" karar vermek aceleci bir yaklaşımdır. Önce state türünü belirleyin; araç seçimi bu karardan sonra kendiliğinden şekillenecektir.

## 2. Varsayılan Yaklaşım: React ve Colocation

React, özünde bir state yönetim aracıdır.[^kent] Bileşen ağacınızı `<App />`'dan `<input />`'a kadar hiyerarşik bir yapıda kurguluyorsanız, state'i de bu yapıya uygun şekilde **yerel (local)** tutmak ve **colocation** (bir arada konumlandırma) prensibine sadık kalmak temel stratejiniz olmalıdır.[^kent]

- **Öncelik yerel state'tedir:** Modal state'i, form değerleri veya bir bileşenin geçici verileri tek bir noktada kalmalıdır; paylaşım ihtiyacı olmayan verileri global store'a taşımak gereksiz karmaşıklığa (over-engineering) yol açar.
- **Paylaşım gerekiyorsa:** React dokümanlarındaki **Lifting State Up** (state'i yukarı taşıma) yöntemi genellikle yeterlidir. State'i, veriyi hem okuyacak hem de güncelleyecek bileşenlerin ortak üst bileşenine konumlandırın.[^react-lifting]
- **Prop drilling yönetimi:** Prop geçişleri sizi rahatsız etmeye başladığında ilk savunma hattınız **bileşen kompozisyonu (component composition)** olmalıdır. State'e ihtiyaç duyan bileşenleri, state sahibi bileşene `children` veya slot olarak geçerek ara bileşenleri bu yükten kurtarabilirsiniz.[^react-context] Bu yetmezse **Context** devreye girer. Context'in temel amacı "tüm uygulama state'ini" yönetmek değil, prop drilling'i çözmektir. Context'e çok erken başvurmak, basit prop geçişlerinden daha maliyetli olabilir.[^react-context] **Sık değişen, çok sayıda abonesi olan ve sadece belirli bir parçası kullanılan state'ler Context için uygun adaylar değildir.**
- **Server cache state değildir:** Sunucudaki veriyi "global state" gibi yönetmek mimari hatalara yol açar. Cache invalidation (geçersiz kılma), refetch (yeniden çekme) ve optimistic update (iyimser güncelleme) gibi ihtiyaçlar için **TanStack Query** kullanmak, state kütüphane seçiminden daha doğru bir adımdır. Kent C. Dodds de bu tür veri için React Query'yi, bugünkü adıyla TanStack Query'yi öneriyor.[^kent]

![React Context](https://omergulcicek.com/blog/2026/02-01/context.webp)

Özetle: **Önce React'ın yerleşik imkanlarını kullanın.** `useState`, `useReducer`, `Lifting State Up`, kompozisyon ve `Context` ile birçok uygulama rahatça yönetilebilir. Global bir store, ancak "state türü" ve "abonelik/performans ihtiyaçları" bu varsayılan sınırları zorladığında gündeme gelmelidir.

## 3. Kırılma Noktası: Abonelik ve Render Performansı

Yerel state ve Context ile mimariyi doğru kurgulasanız bile, bazen arayüz yavaşlayabilir veya gereksiz render sayıları artabilir. Bu aşamada sorun genellikle mimariden ziyade **abonelik (subscription) yönetimidir.**

Sık karşılaşılan iki temel belirti şunlardır:

1.  **Veri değişiyor ancak arayüz güncellenmiyor:** Bu state genellikle veri akışındaki bir kopukluğa veya React’ın değişikliği fark edemediği bir abonelik hatasına işaret eder.
2.  **İlgili veri değişmediği halde arayüz yeniden render ediliyor:** Bunun nedeni, bileşenlerin çok geniş bir state bloğuna (örneğin tüm Context objesine) abone olması veya her render döngüsünde yeni bir referans üreten bir değere bağlı kalmasıdır. Sonuç; gereksiz re-render'lar ve performans kaybıdır.[^jsdev]

Bu yüzden "Global state nerede durmalı?" sorusunun yanına, **"Kim, hangi veriye abone? Değişmeyen bir veri, referans hatası yüzünden mi render tetikliyor?"** sorusu eklenmelidir. Context içerisinde tek bir büyük obje kullanıyorsanız, o objenin herhangi bir alanı değiştiğinde Context’i tüketen **tüm** bileşenler yeniden render olur.[^react-usecontext]

Çözüm; **selector tabanlı abonelik** kullanmak veya state'i mantıksal parçalara bölerek ayrı Provider'lar oluşturmaktır.[^kent] Kısacası, granülerlik ve abonelik tasarımı, kütüphane seçiminden çok daha kritik bir karardır. Aynı mantık hata ayıklama (debug) süreçleri için de geçerlidir: Değişikliklerin nasıl izleneceği ve büyük ekiplerde öngörülebilir güncelleme desenleri, doğrudan seçtiğiniz abonelik ve aksiyon modeliyle şekillenir.

## 4. Araçlar: Optimizasyon Katmanı

Araç seçimi, bu felsefenin bir uzantısıdır: Önce state türünü belirleyin, React’ın yerleşik çözümlerini değerlendirin ve abonelik ihtiyaçlarını analiz edin. Ancak bu aşamalardan sonra "hangi kütüphane?" sorusuna yanıt arayın. Aşağıdaki tablo, state **türüne** ve **ihtiyaçlarınıza** göre bir yol haritası sunar; unutmayın ki tek bir "en iyi" seçenek yoktur.[^jsdev]

Küçük ve orta ölçekli projelerde en verimli kombinasyon genellikle şudur: **Yerel state + Context (ambient) + TanStack Query (server cache) + Zustand (global UI)**. Bu yapı, "önce React'ı tüket" felsefesine sadık kalırken performans ve ölçeklenebilirlik ihtiyaçlarını da karşılar. Zustand ile paylaşılan UI state'lerini yönetirken store kapsamını nasıl daraltacağınızı [Zustand ve React Context](https://omergulcicek.com/blog/zustand-ve-react-context) yazısında detaylandırdım.

## Sonuç: Stratejik Yaklaşım ve Pratik Uygulama

React'ta state yönetimi, sadece popüler bir kütüphaneyi seçmek değil; verinin doğasını anlayıp onu doğru katmanda konumlandırma sürecidir. Modern projelerde en yüksek verimi sağlayan standart yaklaşım; sunucu verilerini **TanStack Query** ile, global UI state'lerini ise **Zustand** ile yönetmektir. Bu ikili, React'ın yerleşik yetenekleriyle (useState, Context, composition) birleştiğinde hem esnek hem de yüksek performanslı bir mimari sunar.

Sürdürülebilir bir yapı için şu hiyerarşiyi takip etmek kritik önem taşır:
1. **State'in Doğasını Belirleyin:** Verinin türünü (UI, sunucu, iş akışı) netleştirin.
2. **React'ı Varsayılan Kabul Edin:** useState, Lifting State Up ve bileşen kompozisyonunu sonuna kadar kullanın.
3. **Abonelik Maliyetini Yönetin:** Sadece ilgili verinin render tetiklediğinden emin olun; gerekirse selector yapısına geçin.
4. **Doğru Aracı Seçin:**
* **Veri API'den geliyorsa:** [TanStack Query](https://tanstack.com/query/latest).
* **Global ve nadir değişen ayarlar** (tema, dil, auth) ise: [Context API](https://react.dev/learn/passing-data-deeply-with-context).
* **Sık değişen veya paylaşılan UI state'leri** ise: [Zustand](https://zustand.docs.pmnd.rs/).
* **Bileşene özel, geçici state'ler** (form, modal) ise: [useState](https://react.dev/reference/react/useState) / [useReducer](https://react.dev/reference/react/useReducer).

Bu stratejik sıralamayı takip ettiğinizde, projeniz ne kadar büyürse büyüsün kontrol edilebilir ve performanslı bir mimariyi koruyabilirsiniz.

## ViraStack Start

Bu makalede bahsettiğim **"doğru state, doğru araç"** felsefesini ve modern Next.js mimarisini temel alan, kendi geliştirdiğim boilerplate projesine göz atabilirsiniz:

**[ViraStack Start](https://github.com/virastack/start)**: Next.js ve TanStack Start projeleri için standartları belirlenmiş, ölçeklenebilir ve nizamlı bir başlangıç kiti.

State yönetiminden dosya yapısına kadar, en iyi pratiklerin (best practices) kodlanmış halini incelemek ve projelerinizde kullanmak isterseniz GitHub üzerinden yıldızlayarak destek olabilirsiniz ⭐.

[^jsdev]: [JavaScript Development Space: Choosing the Right State Strategy in React](https://jsdev.space/react-state-management/)
[^kent]: [Kent C. Dodds: Application State Management with React](https://kentcdodds.com/blog/application-state-management-with-react)
[^react-lifting]: [React: Sharing State Between Components](https://react.dev/learn/sharing-state-between-components)
[^react-context]: [React: Passing Data Deeply with Context](https://react.dev/learn/passing-data-deeply-with-context)
[^react-usecontext]: [React: useContext](https://react.dev/reference/react/useContext)
