<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Hicran Apaydın on Medium]]></title>
        <description><![CDATA[Stories by Hicran Apaydın on Medium]]></description>
        <link>https://medium.com/@hicran.apaydn?source=rss-7fc050bf9691------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*VY3zj5SsybBXWaDhHhliGQ.png</url>
            <title>Stories by Hicran Apaydın on Medium</title>
            <link>https://medium.com/@hicran.apaydn?source=rss-7fc050bf9691------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 07:24:37 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@hicran.apaydn/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Next.js 16 (Beta): Geliştiriciler İçin Neler Yeni?]]></title>
            <link>https://medium.com/@hicran.apaydn/next-js-16-beta-geli%C5%9Ftiriciler-i%CC%87%C3%A7in-neler-yeni-829aadb9b73b?source=rss-7fc050bf9691------2</link>
            <guid isPermaLink="false">https://medium.com/p/829aadb9b73b</guid>
            <dc:creator><![CDATA[Hicran Apaydın]]></dc:creator>
            <pubDate>Sun, 12 Oct 2025 10:47:07 GMT</pubDate>
            <atom:updated>2025-10-13T08:23:12.697Z</atom:updated>
            <content:encoded><![CDATA[<p>Next.js, 16. sürümünün Beta versiyonunu duyurdu.Ben de bu yazıda, bu sürümde neler değiştiğini kendi anladığım şekilde ve geliştirici gözüyle paylaşmak istedim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/500/1*fSbBfcTmuzD4ekPpwfzOfQ.gif" /></figure><p><strong>Turbopack: Yeni Default Bundler</strong></p><p>Turbopack’in artık hem geliştirme (development) hem de üretim (production) ortamları için varsayılan paketleyici olması, Next.js uygulamaları için kutudan çıktığı anda daha yüksek performans anlamına gelmektedir.</p><p>Performans Metrikleri: Bu geçişle birlikte gelen somut kazanımlar :</p><p>◦ Üretim derlemelerinde 2 ila 5 kat daha hızlı sonuçlar ve fast refresh özelliğinde 10 kata kadar daha hızlı performans.</p><p>En güzel kısmıysa şu — hiçbir ek yapılandırma<strong> </strong>(no config) yapmadan bu performans artışını elde edebiliyoruz. Yine de eski yapılandırmayı (Webpack) tercih edenler için de bir çıkış kapısı bırakılmış: komut satırına --webpack parametresini ekleyerek kolayca Webpack&#39;e geri dönebilirler.</p><p><strong>React Compiler: Otomatik Optimizasyon</strong></p><p>Bu derleyici, bileşenlerinizi analiz ederek gereksiz yeniden render işlemlerini önler ve performansı artırır. Eskiden performansı artırmak için useMemo veya useCallback hook’larını manuel ekliyorduk. Artık buna gerek kalmadan React Compiler,<strong> </strong>hangi bileşenin yeniden<strong> </strong>render edilip edilmeyeceğini kendi belirliyor.</p><p>React Compiler henüz varsayılan olarak etkin değildir. Ancak, next.config.js dosyasına eklenecek tek bir flag ile kolayca aktif hale getirilebilir.</p><pre>// next.config.js<br>experimental: { reactCompiler: true }</pre><p><strong>Yeni Caching API’ları</strong></p><p>Bu kısımda da dikkatimi çeken şey, Next.js’in veri tutarlılığı (data<strong> </strong>consistency) konusuna ne kadar odaklandığı oldu. Artık cache yönetimi çok daha esnek ve hedefli hale geliyor.</p><p>◦<strong>revalidateTag()</strong> Artık tüm sayfayı değil, sadece belirli bir “etiketlenmiş” bölümü yeniden doğrulayabiliyoruz. Yani bir veriyi güncellediğimizde sadece ilgili bileşen re-render ediliyor. Bu “stale-while-revalidate” mantığıyla çalışıyor; kullanıcı eski veriyi görmeye devam ederken, arka planda yeni veri çekiliyor.</p><p>◦<strong>updateTag()</strong>, Bu sadece Server Actions ile kullanılabiliyor. Farkı şu: güncellemeyi hemen gösteriyor. Kullanıcının anında değişikliği görmesi gereken durumlarda (örneğin profil bilgisi güncellemesi gibi) çok mantıklı.</p><p>◦<strong>refresh()</strong> Bu da yine sadece Server Actions için.<br> Ancak önbelleğe hiç dokunmuyor. Ben bunu özellikle bildirim veya unread count gibi “canlı” veriler için ideal buldum.</p><p><strong>Build Adapters &amp; Routing Geliştirmeleri</strong></p><p>Build Adapters API, Next.js’i platform bağımsız hale getiriyor.<br>Artık projeler Cloudflare, AWS, S3 gibi ortamlara kolayca deploy edilebiliyor.<br> Ayrıca:</p><ul><li><strong>Layout deduplication</strong> → Aynı layout’u paylaşan sayfalar artık her prefetch’te yeniden indirilmek yerine, bir kez indiriliyor.</li><li><strong>Incremental prefetching</strong> → Next.js artık tüm sayfaları değil, yalnızca önbellekte henüz bulunmayan kısımları önceden getirir.</li></ul><p>Sonuç: Daha az ağ trafiği, daha hızlı geçişler.</p><p><strong>Cache Components: Partial Prerendering (PPR) : </strong>Deneysel PPR bayrağı kaldırılmış ama aslında bu, özelliğin kaybolduğu anlamına gelmiyor.<br> Benim anladığım kadarıyla, Cache Components artık PPR’nin temel mantığını devralıyor. Yani sistem artık bileşen bazında karar veriyor:</p><ul><li>Hangileri statik olarak önbelleklenecek,</li><li>Hangileri dinamik kalacak.</li></ul><p>Bu Next.js’in “akıllı rendering” tarafında en önemli adımı.</p><blockquote><em>Next.js artık “build time + request time” verilerini tek bir asenkron</em><strong><em> </em></strong><em>zincirde çözmek istiyor.</em></blockquote><p><strong>Yükseltme Notları</strong></p><ul><li>Node.js 20.9+ , TypeScript ≥ 5 zorunlu</li><li>middleware.js → proxy.js olarak yeniden adlandırıldı</li><li>revalidateTag() artık cache profile parametresi istiyor</li></ul><p>Daha fazla teknik detay için <a href="https://nextjs.org/blog/next-16-beta">blog</a> yazısını inceleyebilirsiniz .</p><p>Keyifli Okumalar</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=829aadb9b73b" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Teknasyon MentorHub Sürecim]]></title>
            <link>https://medium.com/teknasyon-engineering/teknasyon-mentorhub-s%C3%BCrecim-be2d415888e5?source=rss-7fc050bf9691------2</link>
            <guid isPermaLink="false">https://medium.com/p/be2d415888e5</guid>
            <dc:creator><![CDATA[Hicran Apaydın]]></dc:creator>
            <pubDate>Thu, 11 Sep 2025 10:35:59 GMT</pubDate>
            <atom:updated>2025-09-11T10:46:08.828Z</atom:updated>
            <content:encoded><![CDATA[<h4><strong>MentorHub Nedir?</strong></h4><p>MentorHub, Teknasyon tarafından düzenlenen; yazılım alanına ilgi duyan üniversite 3. ve 4. sınıf öğrencileri ile yeni mezunlara yönelik 6 aylık online mentörlük programıdır. İki haftada bir gerçekleştirilen oturumlarla katılımcılar, kariyer yolculuklarında odaklı ve güçlü adımlar atma imkânı bulmaktadır.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*RpDVfNyr3UFwKwJh-Gy9dg.png" /></figure><h4><strong>MentorHub Sürecine Dahil Oluşum</strong></h4><p>Süreci ilk olarak sosyal platformlarda gördüm ve dikkatimi çekti. Başvuru adımlarının ardından yapılan görüşmeler sonucunda programa kabul edilerek bu yolculuğa başladım. Yazılım dünyasında ilerlerken deneyimli kişilerden birebir öğrenme fırsatı bulmanın, insanın gelişiminde büyük bir rol oynadığına inanıyorum. Bu yazıda, hem teknik açıdan öğrendiklerimi hem de bana kattığı kişisel deneyimleri paylaşmak istiyorum.</p><p>MentorHub sürecinde odak noktamız front-end teknolojileri, özellikle React ve Next.js oldu. Bu alanlarda deneyim sahibi olmama rağmen, süreci deneyimli bir mentörle yürütmek; best practice’ler, performans optimizasyonları, ölçeklenebilir proje yapıları ve kurumsal standartlar konusunda değerli iç görüler edinmemi sağladı. Böylece, günlük iş hayatında kullandığım teknolojileri daha verimli yöntemlerle uygulama ve kod kalitemi profesyonel düzeyde geliştirme fırsatı buldum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/480/1*lt49jmroZvH9nTs3VYuOsA.gif" /></figure><h4><strong>Teknik Odaklar</strong></h4><p>Süreç boyunca belirli konseptler üzerinde kritik noktaları ele alarak ilerledik. Çalışmalarımızın önemli bir kısmı code review odaklıydı; bu sayede hem kod kalitesi hem de ölçeklenebilirlik açısından tartışma fırsatımız oldu.</p><p>Ele aldığımız konular arasında Next.js’in SSR (Server-Side Rendering) yaklaşımı ve client–server components arasındaki farklar önemli bir yer tuttu. Bu sayede, sunucu tarafında render edilen içeriklerin performansını değerlendirirken; client tarafında kullanılan bileşenlerin etkileşim, state yönetimi ve kullanıcı deneyimine etkilerini tartıştık.</p><p>Ayrıca, <a href="https://github.com/hicrandn/zod-multi-step-form">React-Hook Form ve Zod </a>kullanarak dinamik ve güvenli formlar oluşturmayı deneyimledik. Bu sayede, form verilerini doğrulama ve kullanıcı etkileşimini yönetme süreçlerinde daha verimli ve sürdürülebilir çözümler geliştirme fırsatı bulduk.</p><p>Üzerinde durduğumuz konulardan biri de <a href="https://medium.com/@hicran.apaydn/next-js-ile-iron-session-server-actions-kullanarak-pratik-ve-g%C3%BCvenli-authentication-6fabdb0c1614">Next.js ile Iron Session ve Server Actions kullanarak güvenli authentication</a> kurguları oldu. Bu kapsamda, kimlik doğrulama sürecinin güvenlik, performans ve uygulama mimarisi boyutlarını profesyonel bir perspektifle ele alma fırsatı buldum.</p><p>Bir diğer konsept olarak, <a href="https://medium.com/@hicran.apaydn/next-js-de-nodemailer-ve-server-actions-kullanarak-basit-e-posta-g%C3%B6nderme-%EF%B8%8F-7b9e585d6cec">Gmail SMTP ve Nodemailer</a> entegrasyonu ile e-posta gönderim süreçlerini Server Actions üzerinden kurguladık.</p><p>Bunun yanı sıra, Next.js API Routes kullanarak veritabanı işlemleri, ORM entegrasyonu ve farklı veri tabanlarına bağlantılar üzerinde çalıştık. Bu yapı sayesinde yalnızca relation tabanlı sistemlere değil; NoSQL çözümleri ve üçüncü parti servislerle entegrasyonlara da odaklandık. Böylece hem güvenli hem de sürdürülebilir API katmanlarının nasıl tasarlanması gerektiğini deneyimleme fırsatı buldum.</p><p>Aynı zamanda <a href="https://medium.com/@hicran.apaydn/next-js-15-ile-caching-%EF%B8%8F-9f5659f014b1">Next.js’in caching</a> stratejileri ve next-intl ile lokalizasyon gibi süreçleri de inceledik; bunları günlük iş hayatımda kullandığım projelere entegre ederken, yaptığımız görüşmelerde aldığım feedbackler ve farklı bakış açılarıyla deneyimimi profesyonelleştirme fırsatı bulmuş oldum.</p><p>Süreç boyunca yalnızca teknik uygulamalara odaklanmakla kalmadık; teknoloji ekosisteminde doğru kütüphane ve araç seçimlerini de değerlendirdik. Örneğin, Husky ile Git hook’ları üzerinden kod standartlarını koruduk, ESLint ve Prettier ile kod kalitesini sağladık ve Shadcn gibi UI kütüphanelerini projelerimize entegre ettik.</p><p>Bunun yanı sıra, düzenli olarak takip ettiğimiz dijital içerikler aracılığıyla güncel teknolojik trendleri analiz etme fırsatı buldum ve bu analizleri profesyonel projelerimde ve kişisel gelişimimde somut çıktılara dönüştürmeye çalıştım.</p><h4><strong>Süreci Görünür Kılın</strong></h4><p>Bu tür bir programa katılmayı düşünenlere , deneyimimden birkaç ipucu paylaşmak istiyorum:</p><p>İlk olarak hedeflerinizi netleştirin. Mentörlükten ne öğrenmek istediğinizi baştan belirlemek, sürecin verimliliğini artırıyor. Sonra aktif olun; sadece dinlemek yetmez. Sorular sorun, tartışmalara katılın ve merak ettiğiniz noktaları gündeme getirin.</p><p>Öğrendiklerinizi pratiğe dökmek de çok önemli. Küçük projeler, notlar ve deneyimler öğrendiklerinizi kalıcı hâle getirir. Ve unutmayın, <strong>soft skill’ler</strong> teknik bilgiler kadar değerli; iletişim, zaman yönetimi ve iş birliği sürecin kilit taşlarıdır.</p><p>Son olarak, kazandığınız bakış açısını geleceğe taşıyın. Mentörlükten edindiğiniz deneyimler, uzun vadede kariyeriniz için yol gösterici olacak. Onları nasıl kullanacağınıza şimdiden karar verin.</p><p><em>“Learning never exhausts the mind, it only ignites it.”</em> — Leonardo da Vinci</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*scplD7rAZa8N4pG4l505JQ.jpeg" /></figure><p>Bu programın içerisindeyken, yalnızca bir katılımcı olmak yerine, deneyimli bir rehberle birebir ilerliyormuş gibi hissettim. Bu süreç, özgüvenimin artmasını ve profesyonel anlamda ciddi bir gelişim sağlamamı mümkün kıldı. Bu değerli deneyim için mentörüm Ömer Faruk Küçük’e, destekleri için Semih Kışlar’a ve Teknasyon ekibine içtenlikle teşekkür ederim.</p><p>Siz de MentorHub sürecine dahil olmak ve yazılım kariyerinizde güçlü adımlar atmak için <a href="https://mentorhub.teknasyon.com/">MentorHub’a buradan</a> başvurabilirsiniz. Daha detaylı bilgi ve deneyimlerim hakkında<a href="http://hicrandn.dev/"> benimle </a>de iletişime geçebilirsiniz.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=be2d415888e5" width="1" height="1" alt=""><hr><p><a href="https://medium.com/teknasyon-engineering/teknasyon-mentorhub-s%C3%BCrecim-be2d415888e5">Teknasyon MentorHub Sürecim</a> was originally published in <a href="https://medium.com/teknasyon-engineering">Teknasyon Engineering</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Next.js 15 ile Caching ️]]></title>
            <link>https://medium.com/@hicran.apaydn/next-js-15-ile-caching-%EF%B8%8F-9f5659f014b1?source=rss-7fc050bf9691------2</link>
            <guid isPermaLink="false">https://medium.com/p/9f5659f014b1</guid>
            <dc:creator><![CDATA[Hicran Apaydın]]></dc:creator>
            <pubDate>Tue, 24 Jun 2025 13:44:17 GMT</pubDate>
            <atom:updated>2025-06-24T13:44:17.955Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mZVXgH8oyq8wW20t5hDdwg.png" /><figcaption><a href="https://nextjs.org/docs/app/guides/caching#routerprefetch">Caching Diagram</a></figcaption></figure><p><strong>Cache Nedir? Neden Önemlidir?</strong></p><p>Cache (önbellek), sık kullanılan verilerin ya da içeriklerin geçici olarak saklanmasıdır. Sunucunun aynı veriyi tekrar tekrar üretmesini engellemek, uygulamanın yanıt süresini azaltmak ve kullanıcıya daha hızlı ve tutarlı bir deneyim sunmak gibi amaçları vardır.</p><p>Yazıyı hazırlarken<a href="https://nextjs.org/docs/app/guides/caching"> Next.js’in resmi dökümantasyonuna</a> sık sık başvurdum.<br> Karmaşık görünen kavramları daha anlaşılır hale getirebilmek için olabildiğince örneklerle ilerlemeye çalıştım. Şimdi birlikte bu konulara biraz daha yakından bakalım.</p><blockquote>Bir baristayı düşünün<strong>.</strong> Her sabah aynı müşteri geliyor ve “latte, orta boy, az şekerli” diyor. Barista, her seferinde “hangi boy, kaç şeker?” diye sormak yerine artık bu siparişi <strong>hatırlıyor</strong> ve müşteri gelir gelmez içeceği hazırlıyor.</blockquote><p>Bu hafıza, cache’tir. Aynı giriş → saklanmış, hızlı bir yanıt.<br>Eğer müşteri siparişini değiştirirse (örneğin vanilyalı isterse), cache güncellenir.</p><h4><strong>Next.js’te Caching</strong></h4><p>Next.js 15, App Router mimarisiyle birlikte, içeriklerin otomatik olarak önbelleğe alınmasını sağlayan gelişmiş bir caching sistemi sunar. Amaç; minimum veri tekrarı, düşük sunucu maliyeti ve yüksek performanstır.</p><p><strong>Page-Level Caching (Sayfa Düzeyinde Önbellekleme)</strong></p><p>page.tsx, layout.tsx gibi App Router bileşenleri, varsayılan olarak statik şekilde render edilir ve CDN üzerinden cache’lenir.</p><p>Bu davranış dynamic ve revalidate ayarlarıyla özelleştirilebilir:</p><pre>export const dynamic = &#39;force-static&#39;; // Varsayılan<br>export const revalidate = 300; // Incremental Static Regeneration (ISR) benzeri<br>export const dynamic = &#39;force-dynamic&#39;; // Her istekte yeniden render edilir</pre><p><strong>Data-Level Caching with </strong><strong>fetch() (Veri Düzeyinde Önbellekleme)</strong></p><p>Next.js ’te fetch() fonksiyonu <strong>cache-aware</strong> çalışır. Varsayılan olarak force-cache davranışı sergiler. İstenirse farklı cache stratejileri uygulanabilir:</p><p>Varsayılan (force-cache):</p><pre>await fetch(&#39;https://api.example.com/products&#39;);</pre><ul><li>İlk istek sunucuya gider, içerik cache’e alınır. Sonraki isteklerde cache’ten döner</li></ul><p>revalidate:</p><pre>await fetch(&#39;https://api.example.com/products&#39;, {<br>  next: { revalidate: 60 },<br>});</pre><ul><li>Veri ilk istekle birlikte cache edilir. 60 saniye sonra arka planda yenilenir. “Stale-while-revalidate” stratejisine uygundur</li></ul><p>no-store :</p><pre>await fetch(&#39;https://api.example.com/user/me&#39;, {<br>  cache: &#39;no-store&#39;, //SSR ile eşdeğer davranır<br>});</pre><ul><li>Her istek doğrudan sunucuya gider. Cache tamamen devre dışıdır</li></ul><p><strong>Fonksiyon Düzeyinde Önbellekleme (Function-level Caching)</strong></p><p>cache() fonksiyonu ve use cache :</p><p>Next.js, React 19 ile birlikte gelen cache() fonksiyonunu kullanarak fonksiyon düzeyinde caching imkanı sunar. Bu yöntemle, IO ağırlıklı fonksiyonlar önbelleğe alınabilir.</p><p>Aynı parametrelerle çağrılan async fonksiyonlar, tekrar çalıştırılmak yerine cache’ten sonuç döner.</p><pre>import { cache } from &#39;react&#39;;<br><br>const getProduct = cache(async (id: string) =&gt; {<br>  const res = await fetch(`https://api.example.com/products/${id}`);<br>  return res.json();<br>});</pre><ul><li>getProduct(&quot;123&quot;) ilk çağrıldığında fetch yapılır. Aynı parametreyle tekrar çağrıldığında cache’ten gelir. Bu işlem yalnızca server-side çalışır (React Server Component)</li></ul><p>Dikkat Edilmesi Gerekenler</p><ul><li>cache() sadece Server Component’lerde veya Server Action’larda kullanılabilir.</li><li>Parametrelerin değişmemesi gerekir — aksi takdirde yeniden çalışır.</li><li>Memory-based çalışır; dağıtık ortamda shared cache değildir.</li></ul><p><strong>Route Handlers ile Caching:</strong></p><p>Next.js App Router’da, route handler’lar (app/api/**/route.ts) varsayılan olarak cache: &#39;no-store&#39; davranışıyla çalışır , <strong>önbelleğe alınmaz</strong>. Bu, her gelen isteğin, işleyicinin kodunu tekrar çalıştırması anlamına gelir.</p><p><strong>Örnek:</strong> /api/time gibi zamanı döndüren bir endpoint tanımladığınızda, her sayfa yenilemede yeni bir zaman değeri döner. Çünkü bu endpoint’te önbelleğe alma devrede değildir ve bu genellikle istenen davranıştır.</p><pre>//api/time/route.ts<br>export async function GET() {<br>  return Response.json({<br>    time: new Date().toISOString(),<br>  });<br>}</pre><p>Next.js, sadece <strong>GET istekleri</strong> için önbelleğe alma imkanı sunar. POST, PUT, DELETE gibi metotlar hiçbir zaman önbelleğe alınmaz. GET metodu kullanılsa bile, aşağıdaki durumlar varsa <strong>önbelleğe alma devre dışı</strong> olur:</p><pre>// Örnek olarak request.headers, cookies gibi yapılar<br>const token = request.headers.get(&quot;Authorization&quot;);</pre><ul><li>request/headers, request/cookies, next/headers veya next/cookies gibi yardımcı fonksiyonlar route handler’ı otomatik olarak “dynamic” olarak işaretler, bu da her istekte yeniden render anlamına gelir. Bu nedenle önbellek stratejisi oluştururken verinin dinamikliği dikkatle değerlendirilmelidir.</li></ul><p>export const dynamic = &#39;force-static&#39;</p><p>Eğer yönlendirici işleyicideki veriler nadiren değişiyorsa (örneğin kategori listesi gibi), bu durumda tam önbelleğe alma tercih edilebilir.</p><pre>export const dynamic = &#39;force-static&#39;;<br><br>export async function GET() {<br>  return Response.json({<br>    time: new Date().toISOString(),<br>  });<br>}</pre><ul><li>Bu yapılandırma sayesinde, yönlendirici işleyici ilk çalıştırıldığında çıkan sonuç önbelleğe alınır.</li><li>Sonraki tüm istekler, önbellekten hızlıca döner.</li><li>Bu, özellikle veritabanı sorgularını azaltmak ve performansı artırmak için oldukça etkilidir.</li></ul><p>export const revalidate = &lt;saniye&gt;:</p><pre>export const revalidate = 60; //Incremental Static Regeneration (ISR) benzeri çalışır.<br>export async function GET() {<br>  const data = await fetchData();<br>  return Response.json(data);<br>}</pre><p>💡 <strong>Not:</strong> Geliştirme ortamında (npm run dev) önbelleğe alma aktif değildir. Gerçek etkisini görmek için üretim ortamında (npm run build &amp;&amp; npm run start) test edilmelidir.</p><p>🚧<strong> DynamicIO ile Otomatik Cache Davranışı</strong></p><p>Next.js 15, bir bileşen veya route içeriği herhangi bir async işlem (ör. fetch(), db sorgusu, readFile()) içeriyorsa, bu içeriği otomatik olarak<strong> dinamik</strong> olarak değerlendirir. Bunu dynamicIO: true ile de etkinleştirebiliriz.</p><pre>//next.config.ts<br>import type { NextConfig } from &#39;next&#39;<br> <br>const nextConfig: NextConfig = {<br>  experimental: {<br>    dynamicIO: true, <br>  },<br>}<br> <br>export default nextConfig</pre><p>Varsayılan olarak verilerin çalışma zamanında çekilmesini sağlarken, uygulamanızın belirli bölümlerini sayfa, fonksiyon veya component düzeyinde <a href="https://nextjs.org/docs/app/api-reference/directives/use-cache">use cache</a> ile önbelleğe alarak cache davranışını özelleştirebilirsiniz.</p><pre>import type { NextConfig } from &#39;next&#39;<br> <br>const nextConfig: NextConfig = {<br>  experimental: {<br>    useCache: true,<br>  },<br>}<br> <br>export default nextConfig<br><br>//Alternatif olarak dynamicIO: true/false ile davranışı kontrol edebiliriz.</pre><p>Aslında &#39;use client&#39; ve &#39;use server&#39; direktifleri bileşenin nerede çalışacağını tanımlıyorsa, &#39;use cache&#39; de yalnızca bir string literal veya JavaScript direktifi kullanarak verinin <strong>cache’den mi yoksa run time’dan mı</strong> alınacağını belirlemeni sağlar.</p><p>&#39;use cache&#39; bir fonksiyona, component’a veya hatta tüm bir dosyaya uygulanabilir.</p><pre>// File level<br>&#39;use cache&#39;<br> <br>export default async function Page() {<br>  // ...<br>}<br> <br>// Component level<br>export async function MyComponent() {<br>  &#39;use cache&#39;<br>  return &lt;&gt;&lt;/&gt;<br>}<br> <br>// Function level<br>export async function getData() {<br>  &#39;use cache&#39;<br>  const data = await fetch(&#39;/api/data&#39;)<br>  return data<br>}</pre><p>Nasıl Çalışır?</p><ul><li>Cache Key (Önbellek Anahtarı) : Next.js App Router’da, Server Components ve Server Actions gibi önbelleklenebilir fonksiyonların cache anahtarı şu bileşenlerden oluşur:</li></ul><pre>Cache Key = Build ID + Function Signature + Serializable Arguments</pre><p>Deterministik Önbellekleme :</p><p>Eğer aynı serileştirilebilir parametrelerle bir fetch(), server action veya async component tekrar çağrılırsa:</p><p><strong>Fonksiyon tekrar çalışmaz</strong>, Next.js mevcut cache’ten yanıt döner (SSG veya ISR gibi davranır).</p><p>Serileştirilemeyen Argümanlar (Non-Serializable):</p><p>JSX (&lt;Component /&gt;), children, functions, class instances gibi serileştirilemeyen argümanlar, cache key&#39;e dahil edilmez.</p><ul><li>Ancak bu tür veriler <strong>interleaving (iç içe geçirme)</strong> sayesinde render sırasında yine de fonksiyon içinde kullanılabilir.</li></ul><pre>export default async function Layout({ children }: { children: React.ReactNode }) {<br>  const data = await fetch(&quot;https://api.example.com&quot;, {<br>    cache: &quot;force-cache&quot;<br>  });<br><br>  return (<br>    &lt;div&gt;<br>      &lt;Sidebar /&gt;<br>      {children} {/* children önbellek anahtarına dahil edilmez ama içeride render edilir */}<br>    &lt;/div&gt;<br>  );<br>}</pre><blockquote>Next.js’in canary sürümünde tanıtılan cacheLife ve cacheTag, geliştiricilere Next.js uygulamalarındaki önbellekleme stratejileri üzerinde önemli kontrol sağlar. cacheLife ile önceden tanımlanmış veya özel profiller aracılığıyla önbellek ömrünü hassas bir şekilde ayarlayabilirken, cacheTag belirli önbellek girişlerinin isteğe bağlı olarak geçersiz kılınmasını kolaylaştırarak verilerin her zaman güncel kalmasını sağlar. Bu özellikler, yüksek performanslı ve verimli Next.js uygulamaları oluşturmak için hayati öneme sahiptir.</blockquote><p>cacheLife:</p><p>cacheLife fonksiyonu, bir component veya async fonksiyonun önbellekte ne<strong> </strong>kadar süreyle saklanacağını, ne zaman yeniden doğrulanacağını ve ne zaman tamamen geçersiz olacağını tanımlar.</p><pre>import type { NextConfig } from &#39;next&#39;<br> <br>const nextConfig: NextConfig = {<br>  experimental: {<br>    dynamicIO: true,<br>    cacheLife: {<br>      blog: {<br>        stale: 3600, // 1 hour<br>        revalidate: 900, // 15 minutes<br>        expire: 86400, // 1 day<br>      },<br>    },<br>  },<br>}<br> <br>export default nextConfig</pre><p>Her profil bir <strong>stale</strong> (tarayıcıda eski verinin gösterilme süresi), <strong>revalidate</strong> (arka planda güncelleme sıklığı) ve <strong>expire</strong> (tamamen geçersizleşme süresi) tanımlar.</p><p>Daha sonra, cacheLife fonksiyonunu ilgili fonksiyon veya component içinde içe aktarabilir ve çağırabilirsiniz:</p><pre>import { unstable_cacheLife as cacheLife } from &#39;next/cache&#39;<br> <br>export async function getCachedData() {<br>  &#39;use cache&#39;<br>  cacheLife(&#39;blog&#39;)<br>  const data = await fetch(&#39;/api/data&#39;)<br>  return data<br>}</pre><p>cacheTag :</p><p>Önbelleğe alınmış bir component/fonksiyon etiketlemenizi sağlar. Böylece belirli etiketlerle işaretlenmiş veriler, isteğe bağlı olarak yeniden doğrulanabilir veya temizlenebilir.</p><pre>import type { NextConfig } from &#39;next&#39;<br> <br>const nextConfig: NextConfig = {<br>  experimental: {<br>    dynamicIO: true, //burda enable edebiliyoruz<br>  },<br>}<br> <br>export default nextConfig</pre><p>Next.js App Router’da cacheTags fonksiyonu, bir veri kaynağına ait cache’i ilişkilendirmek için kullanılır ve parametre olarak tek bir string ya da string[] alır.</p><pre>//app/data.ts<br>&#39;use cache&#39;<br>import { unstable_cacheTag as cacheTag } from &#39;next/cache&#39;<br><br>await fetch(&quot;https://api.example.com/data&quot;, {<br>  next: {<br>    tags: [&#39;products&#39;, &#39;homepage&#39;]<br>  }<br>});</pre><p>Sonrasında şu şekilde cache’i manuel olarak invalid edebilirsin:</p><pre>&#39;use server&#39;<br>import { revalidateTag } from &#39;next/cache&#39;<br><br>export async function submit() {<br>  await doSomething()<br>  revalidateTag(&#39;products&#39;) // Bu, products tag’li cache’leri siler ve yeniden fetch etmeye zorlar (ISR gibi çalışır).<br>}</pre><p>Sonuç Olarak:</p><p>Next.js 15 ile gelen yeni önbellekleme mimarisi, büyük ölçekli projelerden bireysel uygulamalara kadar tüm kullanım senaryoları için güçlü bir temel sunmaktadır. Deneysel olmasına rağmen use cache, cacheLife ve cacheTag gibi direktifler, geliştirici deneyimini ve uygulama performansını doğrudan artırır. Bu yaklaşım, React Server Component mimarisiyle uyumlu şekilde ilerleyerek geleceğin web mimarisine sağlam bir zemin hazırlar.</p><p>Umarım bu rehber sizin için faydalı olmuştur. Eğer sorularınız olursa yorumlarda buluşalım!<br>Keyifli kodlamalar! ☕💻</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9f5659f014b1" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Next.js ‘de Nodemailer ve Server Actions kullanarak Basit E-Posta Gönderme ✉️]]></title>
            <link>https://medium.com/@hicran.apaydn/next-js-de-nodemailer-ve-server-actions-kullanarak-basit-e-posta-g%C3%B6nderme-%EF%B8%8F-7b9e585d6cec?source=rss-7fc050bf9691------2</link>
            <guid isPermaLink="false">https://medium.com/p/7b9e585d6cec</guid>
            <dc:creator><![CDATA[Hicran Apaydın]]></dc:creator>
            <pubDate>Sat, 07 Jun 2025 16:43:44 GMT</pubDate>
            <atom:updated>2025-06-07T16:43:44.005Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fhyOIJnU_yd3kDJJIH93gA.png" /></figure><p>Next.js ile projeler geliştirirken bir noktada e-posta gönderme ihtiyacı neredeyse kaçınılmaz oluyor: ister bir iletişim formu, ister şifre sıfırlama, ister bir kullanıcıya bildirim gönderme.. Araştırmalarım sırasında birçok farklı servis karşıma çıktı: Resend, EmailJS, Mailgun, SendGrid… Derken, <a href="https://nodemailer.com/"><strong>Nodemailer</strong></a> Node.js kütüphanesi dikkatimi çekti. Kurulumu<strong> </strong>basit, ücretsiz, kendin kontrol edebiliyorsun ve Gmail gibi SMTP servisleriyle direkt çalışabiliyor olması benim için onu avantajlı kıldı.Bu yüzden deneyimlemek istedim.</p><p>Hemen küçük bir<a href="https://github.com/hicrandn/nextjs-nodemailer"> demo</a> oluşturarak Nodemailer’ı test ettim.Bu yazıda, hem kendi deneyimlerimi paylaşmak hem de sizin de kolayca uygulayabilmeniz için adım adım nasıl e-posta gönderimi yapılacağını göstermek istiyorum.</p><p>🛠️ <strong>İlk Olarak Ne Yaptım?</strong></p><p>İşe Gmail hesabımı yapılandırarak başladım. Çünkü Nodemailer’ın Gmail üzerinden e-posta gönderebilmesi için bazı izinlere ihtiyacı var.</p><p>Ben zaten 2 adımlı doğrulama kullandığım için (Eğer kullanmıyorsanız E posta güvenlik ayarlarından bunu aktifleştirmeniz gerekecek), Gmail hesabımda <strong>Uygulama Şifresi (app password) </strong>oluşturdum. Uygulama olarak “Mail”, cihaz olarak “Diğer” seçip bir isim verdikten sonra (örneğin: Nodemailer) Gmail sana 16 karakterlik bir şifre veriyor. Bu şifreyi .env dosyamızda kullanacağız. Bunu bir yere not almayı unutmayın.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/676/1*HQwObV0LWSmxBzBmKOB4ug.png" /></figure><p>🔒<strong>Nodemailer’ı Kurdum ve Ortam Değişkenlerini Ayarladım</strong></p><p>Gmail tarafındaki ayarları hallettikten sonra artık projeye dönebiliriz.İlk olarak Nodemailer’ı projemize ekliyoruz:</p><pre>npm install nodemailer</pre><p>Daha sonrasında projenin kök dizininde bir .env.local dosyası oluşturuyoruz ve aşağıdaki gibi dolduruyoruz:</p><pre>EMAIL_HOST=smtp.gmail.com<br>EMAIL_PORT=587<br>EMAIL_USER=seningmailadresi@gmail.com<br>EMAIL_PASS=uygulama_sifresi_buraya //biraz önce oluşturduğumuz uygulama şifresi <br>EMAIL_FROM_NAME=SeninAdın veya ProjeAdı //</pre><p>📄<strong>Server Action ile Mail Gönder</strong></p><p>Biz server action özelliği kullanarak formdan gelen verileri alıp Nodemailer ile e-posta göndereceğiz.</p><pre>&#39;use server&#39;; <br><br>import nodemailer from &#39;nodemailer&#39;;<br><br>export async function sendEmail(formData: FormData) {<br>  const name = formData.get(&#39;name&#39;);<br>  const email = formData.get(&#39;email&#39;);<br>  const message = formData.get(&#39;message&#39;);<br><br>  // Mail gönderici (transporter) tanımı<br>  const transporter = nodemailer.createTransport({<br>    cost: process.env.EMAIL_HOST,<br>    port: Number(process.env.EMAIL_PORT),<br>    auth: {<br>      user: process.env.GMAIL_USERNAME,<br>      pass: process.env.GMAIL_PASSWORD,<br>    },<br>  });<br><br>  try {<br>    await transporter.sendMail({<br>      from: `&quot;${process.env.EMAIL_FROM_NAME}&quot; &lt;${process.env.EMAIL_USER}&gt;`,<br>      to: process.env.EMAIL_USER,<br>      subject: `📬 New Contact Form Message - ${name}`,<br>      text: `<br>You have a new message:<br><br>👤 Sender: ${name}<br>📧 Email: ${email}<br><br>📝 Message:<br>${message}<br>    `,<br>     <br>    });<br><br>    return { success: true, message: &#39;Email sent successfully!&#39; };<br>  } catch (error) {<br>    console.error(&#39;Error sending email:&#39;, error);<br>    return { success: false, message: &#39;Failed to send email. :(&#39; };<br>  }<br>}</pre><p>🔸 <strong>Not: </strong>Bu işlem API Route kullanılarak da yapılabilirdi. Ama Server Actions sayesinde form verilerini doğrudan <strong>sunucu tarafında</strong> işleyebiliyorum, bu da fazladan bir api/send endpoint&#39;i yazma ihtiyacını ortadan kaldırıyor. Kod daha modüler, sade, basit ve doğrudan formla ilişkili hale geliyor.</p><p>📄 <strong>Formu oluşturup sunucu tarafı fonksiyonunu tetikleyecek şekilde frontend kısmını tamamladım:</strong></p><p>Kendi <a href="https://github.com/hicrandn/nextjs-nodemailer">demo </a>çalışmamda Shadcn+react hook form+zod kullanarak formumu oluşturdum ancak burda basit kullanım açısından şöyle örneklemek istedim:</p><pre>// app/contact/page.tsx <br>import { sendEmail } from &quot;../actions/sendEmail&quot;;<br><br>export default function ContactForm() {<br>  // Server Action&#39;ı formun action özelliğiyle bağladık<br>  async function handleSubmit(formData: FormData) {<br>    const result = await sendEmail(formData);<br>    alert(result.message);<br>  }<br><br>  return (<br>    &lt;form action={handleSubmit}&gt;<br>      &lt;input type=&quot;text&quot; name=&quot;name&quot; placeholder=&quot;Your Name&quot; required /&gt;<br>      &lt;input type=&quot;email&quot; name=&quot;email&quot; placeholder=&quot;Your Email&quot; required /&gt;<br>      &lt;textarea name=&quot;message&quot; placeholder=&quot;Your Message&quot; required /&gt;<br>      &lt;button type=&quot;submit&quot;&gt;Send Email&lt;/button&gt;<br>    &lt;/form&gt;<br>  );<br>}</pre><p>🧩<strong>Test Et</strong></p><p>Artık formumuzu oluşturduk ve server action ile Nodemailer’ı entegre ettik. Şimdi sıra bunu test etmekte.</p><p>Formu doldurup gönder tuşuna bastığımızda, Nodemailer arka planda Gmail SMTP üzerinden e-postamızı başarıyla gönderdi! Konsolda herhangi bir hata görünmedi ve alıcı adresine mesajımız ulaştı.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*YKcy3lVEUCM2_-JTBYpSSA.gif" /></figure><p>📦 Aldığımız e posta da bu şekildedir:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*idUOV2k-zBEKjYbVRxisLA.png" /></figure><p>Bu basit test, Next.js ’in server actions özelliği ne nodemailer nasıl hızlıca e-posta gönderme servisi kurulabileceğini gösterdi.</p><h3>🎯 Sonuç</h3><p>Bu yazıda, Next.js ’in modern mimarisiyle Nodemailer kullanarak nasıl pratik bir e-posta gönderme sistemi kurabileceğimizi adım adım gördük. server actions sayesinde daha sade ve okunabilir bir backend mantığı kurabiliyoruz.</p><p>Bu yaklaşımın en güzel yanı, tamamen ücretsiz olması. Yani ekstra bir alan adı satın almaya veya ücretli e-posta servislerine kaydolmaya gerek yok. Gmail gibi yaygın servislerle hızlıca entegre olup projenize hemen başlayabilirsiniz.</p><p>Ayrıca kurulum süreci oldukça basit olduğu için özellikle yeni başlayanlar için ideal. Daha karmaşık altyapılara geçmeden önce temel mantığı öğrenmek için birebir.</p><p>Daha büyük projelerde veya profesyonel ortamda farklı çözümler tercih edilse de, bu yöntem küçük uygulamalar, ve hızlı prototipleme için fazlasıyla yeterli olacaktır.</p><p>Umarım bu rehber sizin için faydalı olmuştur. Eğer soruların olursa yorumlarda buluşalım!<br>Keyifli kodlamalar! ☕💻</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7b9e585d6cec" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Next.js ile iron-session & Server Actions Kullanarak Pratik ve Güvenli Authentication]]></title>
            <link>https://medium.com/@hicran.apaydn/next-js-ile-iron-session-server-actions-kullanarak-pratik-ve-g%C3%BCvenli-authentication-6fabdb0c1614?source=rss-7fc050bf9691------2</link>
            <guid isPermaLink="false">https://medium.com/p/6fabdb0c1614</guid>
            <dc:creator><![CDATA[Hicran Apaydın]]></dc:creator>
            <pubDate>Wed, 14 May 2025 13:02:04 GMT</pubDate>
            <atom:updated>2025-05-14T13:22:10.918Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8Zc7_zF8S6YblLSI__P-5Q.png" /><figcaption>Editing by Brayns AI</figcaption></figure><p>Kullanıcı oturumlarını yönetmek, modern web uygulamalarında hâlâ temel bir ihtiyaç. Özellikle stateless ve cookie tabanlı bir çözüm arıyorsanız, iron-session bu noktada sade, güvenli ve pratik bir seçenek sunar. Üstelik server-side rendering (SSR) ile de uyumlu çalışır. Bunun için ufak bir <a href="https://github.com/hicrandn/nextjs-authentication-iron-session">demo</a> çalışması yaptım.</p><p>Geleneksel authentication kütüphaneleri (örneğin next-auth), OAuth gibi 3rd-party servislerle hızlı entegrasyon sağlar; ancak karmaşık yapılandırmaları, soyutlamaları ve sınırlı özelleştirme olanakları ile projeye esneklik katmak zor olabilir.Ayrıca auth.js gibi alternatiflerin belgeleri karmaşık olabilir ve yeni Next.js özellikleriyle (örneğin Server Actions) tam uyumlu çalışmayabilir.</p><p>Diğer yandan, Clerk gibi servis tabanlı çözümler; kullanıcı yönetimi, MFA, sosyal giriş gibi özellikleri kutudan çıktığı gibi sunsa da, hem ücretli bir yapıdadır hem de uygulamanızı onların altyapısına bağımlı hale getirir.</p><h4>💭 Neden iron-session?</h4><p>Eğer daha fazla kontrol, sade bir yapı ve hiçbir dış bağımlılık istemiyorsanız, iron-session cookie tabanlı, stateless ve TypeScript dostu yapısıyla öne çıkar.</p><ul><li><strong>Cookie tabanlıdır</strong>, yani client’a JWT gibi token göndermek yerine, server-side session yönetimi sunar.</li><li><strong>Stateless yapıdadır</strong>, session bilgisi sadece cookie’de şifreli şekilde saklanır.</li><li>TypeScript ile güçlü şekilde entegre olabilir</li></ul><p>Öncelikle kütüphaneyi nasıl kurmalıyız:</p><pre>npm install iron-session</pre><p>iron-session ile kullanıcı oturumlarını yönetmek için ortak bir yapılandırma dosyasına ihtiyacımız var. Bu yapı, session verisinin cookie’ye nasıl yazılacağını ve şifrelemenin nasıl yapılacağını belirler.</p><p>lib/session.ts dosyasını oluşturalım:</p><pre>import { cookies } from &quot;next/headers&quot;<br>import { getIronSession, IronSession } from &quot;iron-session&quot;<br>import type { SessionOptions } from &quot;iron-session&quot;<br><br>export type User = {<br>  id?: number<br>  username?: string<br>  token?: string<br>}<br><br>export const sessionOptions: SessionOptions = {<br>  cookieName: &quot;myapp_session&quot;,<br>  password: process.env.SESSION_SECRET as string,<br>  cookieOptions: {<br>    secure: process.env.NODE_ENV === &quot;production&quot;,<br>    httpOnly: true,<br>    sameSite: &quot;lax&quot;,<br>  },<br>}<br><br>export async function getSession(): Promise&lt;IronSession&lt;User&gt;&gt; {<br>  const cookieStore = await cookies()<br>  return await getIronSession&lt;User&gt;(cookieStore, sessionOptions)<br>}</pre><p>iron-session ile çalışırken oturum bilgilerini şifrelemek için güçlü bir gizli anahtara (secret key) ihtiyacımız var. Bu gizli bilgi .env.local dosyasında saklanmalı.<strong>En az 32 karakter</strong> uzunluğunda olmalıdır.</p><pre>//.env.local //password<br>SESSION_SECRET=zkYEXAMPLEs3cretKey49281mkcxVXnalf0zq</pre><h4>Server Action ile Login: Gerçek API Üzerinden Oturum Yönetimi</h4><p>Kullanıcının username ve password bilgileri formdan alınır ve Server Action üzerinden DummyJSON API&#39;ye gönderilir. Başarılı giriş yapılırsa kullanıcıya ait veriler session içine kaydedilir:</p><p>✅ Teknik Notlar:</p><ul><li>API başarılı dönerse, session içine kullanıcıya ait bilgiler (token, firstName, image,..) şifrelenmiş cookie ile yazılıyor.</li><li>Bu veri sadece <strong>sunucu tarafında okunabilir</strong>, client erişemez. Böylece güvenli bir yapı elde edilir.</li></ul><pre>//login.action.ts<br>&quot;use server&quot;<br><br>import { getSession } from &quot;@/lib/session&quot;<br>import { loginSchema } from &quot;@/lib/validation&quot;<br>import { z } from &quot;zod&quot;<br><br>export const loginAction = async (formData: z.infer&lt;typeof loginSchema&gt;) =&gt; {<br>    console.log(&quot;login action&quot;)<br> const res = await fetch(&quot;https://dummyjson.com/auth/login&quot;, {<br>      method: &quot;POST&quot;,<br>      headers: { &quot;Content-Type&quot;: &quot;application/json&quot; },<br>      body: JSON.stringify(formData),<br>    })<br><br>      if (!res.ok) {<br>      const errorData = await res.json()<br>      console.error(&quot;Login error from DummyJSON:&quot;, errorData)<br>      return {<br>        success: false,<br>    }<br><br>    const data = await res.json()<br>    const session = await getSession()<br>    session.token = data.accessToken<br>    await session.save()<br>    return {<br>      success: true,<br>    }<br><br>}</pre><p>📄 Bu server action&#39;ı tetikleyecek bir login form: Loginden sonra protected(/dashboard) bir rotaya yönlendirir</p><pre>&quot;use client&quot;;<br><br>const LoginPage = () =&gt; {<br><br>  const onSubmit = async (values: z.infer&lt;typeof loginSchema&gt;) =&gt; {<br>    setError(&quot;&quot;);<br>    try {<br>      const response = await loginAction(values);<br>      if (response.succes) {<br>        router.push(&quot;/dashboard&quot;);<br>      }<br>    } catch (err) {<br>      setError(&quot;Something went wrong&quot;);<br>    }<br>  };<br><br>  return (<br>          &lt;form<br>            onSubmit={form.handleSubmit(onSubmit)}<br>            className=&quot;w-full space-y-6&quot;<br>          &gt;<br>            &lt;input name=&quot;JohnDoe&quot; /&gt;<br>            &lt;input name=&quot;JohnDoe&quot; /&gt;<br>          &lt;/form&gt;<br>  );<br>};<br><br>export default LoginPage;</pre><p>Kullanıcı giriş yaptıktan sonra, /dashboard sayfasına yönlendirilir. Bu sayfa sadece geçerli oturuma sahip kullanıcılar tarafından erişilebilir. iron-session ile oturumu kontrol ederek yetkisiz erişimi engellemek oldukça kolay.</p><pre><br>const Dashboardpage = async () =&gt; {<br>  const session = await getSession();<br> // Eğer token yoksa kullanıcı login sayfasına yönlendirilir<br>  if (!session?.token) {<br>    redirect(&quot;/login&quot;);<br>  }<br>  return (<br>    &lt;h1&gt;Merhaba, {session.firstName}&lt;/h1&gt;<br>        &lt;Button onClick={logoutAction} type=&quot;submit&quot;&gt;<br>          Logout<br>        &lt;/Button&gt;<br>  <br>  );<br>};<br><br>export default Dashboardpage;</pre><h4>🍪 Oturum Verileri Nerede Saklanıyor?</h4><p>iron-session, oturum bilgilerini <strong>JWT gibi client-side olarak değil</strong>, <strong>şifreli bir cookie</strong> içinde tarayıcıya yazar. Yani tüm session verileri tarayıcıda Application &gt; Cookies sekmesinden görüntülenebilir.</p><p>Ancak önemli bir fark var:</p><ul><li>Cookie içinde <strong>ham veri</strong> değil, iron-session tarafından <strong>şifrelenmiş (encrypted)</strong> bir string saklanır. Bu sayede dışarıdan okunamaz veya değiştirilemez.</li><li>Tarayıcıdaki bu veriyi doğrudan okuyamazsınız — sadece server, belirttiğiniz password yardımıyla bu veriyi çözebilir.</li><li>Bu sayede client üzerinde veri tutuyor gibi görünse de, aslında tüm kontrol ve güvenlik server tarafındadır.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*V-KfRoVldALJ80Hiu-tMYg.png" /></figure><h4>🔐 Oturumu Sonlandırma (logoutAction)</h4><p>Kullanıcı oturumunu sonlandırmak için basit ama etkili bir server action fonksiyonu oluşturduk.</p><ul><li>Eğer bazı oturum bilgilerini korumak ama yalnızca token’ı sıfırlamak istiyorsanız, session.token = undefined gibi işlemler kullanılır.</li><li>Ancak <strong>tam bir logout işlemi</strong> için destroy() her zaman daha güvenli ve temiz bir çözümdür.</li></ul><pre>&quot;use server&quot;;<br><br>import { getSession } from &quot;@/lib/session&quot;;<br><br>export const logoutAction = async () =&gt; {<br>  const session = await getSession();<br>  //session.token = undefined<br>  session.destroy();<br>  await session.save();<br>  return null;<br>};</pre><h4>🔐 Access Token ve Refresh Token Yönetimi</h4><p>Ufak değinmek istediğim bir nokta var: Access Token ve Refresh Token. Access Token, kullanıcıyı doğrulamak için kullanılır ve kısa ömürlüdür. Refresh Token ise, accessToken süresi dolduğunda yeni bir token almak için kullanılır. Iron-session, bu token’ları şifreli bir şekilde tarayıcıda saklayarak güvenliği artırır ve sunucu tarafında yönetilmesini sağlar. Böylece, veri sızıntıları ve token çalınma riski azalır, sürekli giriş yapmaya gerek kalmaz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ZYxbC4hknxO7DtVxzWL2Mw.png" /></figure><h4>Sonuç:</h4><p>İron-session ile güvenli ve basit bir şekilde kullanıcı oturumlarını yönetmek oldukça kolay. Bu yöntem, güvenliği artırırken uygulamanızın verimli bir şekilde çalışmasını sağlar. Kimlik doğrulama ve yetkilendirme süreçlerini optimize etmek için iron-session gibi çözümler, hızlı ve etkili bir yaklaşım sunar. Detaylarını <a href="https://github.com/hicrandn/nextjs-authentication-iron-session">github repomda </a>inceleyebilirsiniz.</p><p>Keyifli Kodlamalar 👨‍💻 🎉</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6fabdb0c1614" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Tailwind V4 CSS-First Konfigürasyon]]></title>
            <link>https://medium.com/@hicran.apaydn/tailwind-v4-css-first-konfig%C3%BCrasyon-5b838f4d5613?source=rss-7fc050bf9691------2</link>
            <guid isPermaLink="false">https://medium.com/p/5b838f4d5613</guid>
            <dc:creator><![CDATA[Hicran Apaydın]]></dc:creator>
            <pubDate>Sun, 27 Apr 2025 15:25:18 GMT</pubDate>
            <atom:updated>2025-04-27T15:25:18.084Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cgqcWogTbPOs21TcsP1xNQ.png" /></figure><h4>Tailwind config dosyası nerde ?</h4><p>Tailwind CSS, sürüm 4.0 ile birlikte büyük bir yenilik yaptı ve konfigürasyon dosyasını kaldırarak, tüm tema ve stil yapılandırmalarını doğrudan CSS üzerinden yapma imkânı sundu. Bu değişiklik, geliştiricilere daha esnek ve modern bir yapı sunuyor.</p><p>Tailwind 3.x sürümünde projeye özel renkler, fontlar veya spacing değerleri tanımlamak için mutlaka bir tailwind.config dosyası oluşturuyorduk:</p><pre>// tailwind.config<br><br>module.exports = {<br>  theme: {<br>    extend: {<br>      colors: {<br>        brand: {<br>          100: &#39;#EA6365&#39;,<br>          DEFAULT: &#39;#FA7275&#39;<br>        }<br>      }<br>    }<br>  }<br>}</pre><p>Fakat artık tailwind.config dosyasına gerek kalmadı onun yerine css dosyası kullanarak tanımlamaları yapabiliyoruz.</p><p>Bu yöntemle doğrudan Tailwind’e tema genişletmesi yapmıyorsun. Bunun yerine CSS değişkenlerini kullanıyorsun ve Tailwind sınıfları içinde bu değişkenleri kullanıyorsun.</p><pre>/* css dosyası */<br>@import &quot;tailwindcss&quot;;<br><br>@theme inline {<br> --color-background: var(--background);<br> --color-foreground: var(--foreground);<br>..<br> --color-border: var(--border);<br> --color-primary: #FF0099;<br> --color-secondary: #a1a1a1;<br>..<br>--padding-smallxx: 0.5rem;<br>--padding-large: 1.5rem;<br>}<br><br><br>:root {<br>  --radius: 0.625rem;<br>  --background: oklch(1 0 0);<br>  --foreground: oklch(0.145 0 0);<br>..<br> --border: oklch(0.922 0 0);<br><br>}</pre><pre>//html içinde bu şekilde kullanılabilir.<br>&lt;h2 className=&quot;bg-amber-50 font-extrablack text-secondary p-smallxx &quot;&gt;Nasılsınız ? &lt;/h2&gt;</pre><p>🎨 Mesela .bg-background, .text-foreground, .border-border gibi Tailwind utility class&#39;larını, @layer base&#39;te yazdığımız @apply ile birleştirebiliyoruz:</p><pre>@layer base {<br>  * {<br>    @apply border-border outline-ring/50;<br>  }<br>  body {<br>    @apply bg-background text-foreground;<br>  }<br>}</pre><p>Bu da demek oluyor ki:</p><ul><li>border-border → border-color: var(--border);</li><li>bg-background → background-color: var(--background);</li><li>text-foreground → color: var(--foreground);</li></ul><p>Yani Tailwind class’ları artık arkada CSS değişkenlerini referans alıyor.</p><p>Baktığımız zaman aslında config Tailwind tema ile sınırlıydı yeni yöntemle ise CSS değişkeni olduğu için çok daha esnek, modlar arasında kolay geçiş yapılabiliyor (örnek: .dark)</p><pre>/* Global CSS değişkenlerini tanımlıyoruz */<br>:root {<br>  --color-primary: #3490dc;      /* Mavi Renk */<br>  --color-secondary: #ffed4a;    /* Sarı Renk */<br>  --color-background: #f8fafc;   /* Arka Plan Rengi */<br>  --color-foreground: #2d3748;   /* Yazı Rengi */<br>}<br><br>/* Dark Modda renkleri değiştirecek değişkenler */<br>.dark {<br>  --color-primary: #1d4ed8;      /* Koyu Mavi */<br>  --color-secondary: #fbbf24;    /* Koyu Sarı */<br>  --color-background: #2d3748;   /* Koyu Arka Plan */<br>  --color-foreground: #f7fafc;   /* Beyaz Yazı Rengi */<br>}</pre><p>Bu sayede, kullanıcıların sistem tercihlerine göre otomatik tema geçişleri yapılabilir.</p><p>Ayrıca, CSS özellikleriyle entegrasyon konusunda da yenilikler bulunuyor:​</p><ul><li>@property ile özel CSS özelliklerinin kaydedilmesi</li><li>color-mix() ile renk karıştırma desteği</li></ul><pre>/* CSS değişkenlerini tanımlıyoruz */<br><br>@layer utilities {<br>  .bg-mixed {<br>    background-color: color-mix(in srgb, #f00 50%, #00f 50%);<br>  }<br>}<br><br><br>//html kulllanımı<br>  &lt;div className=&quot;bg-mixed&quot;&gt;<br>        &lt;h1 className=&quot;text-white text-3xl &quot;&gt;Home&lt;/h1&gt;<br>     &lt;/div&gt;<br></pre><ul><li>@starting-style ile animasyon başlangıç stilleri</li><li>not-* varyantı ile belirli durumları dışlama​</li></ul><pre>&lt;div class=&quot;not-dark:bg-green-500 bg-mixed p-10&quot;&gt;<br>      &lt;h1 class=&quot;text-white text-3xl&quot;&gt;Home&lt;/h1&gt;<br>    &lt;/div&gt;<br><br>//arka plan rengini green-500 yapacak, ancak sadece dark modda değilse</pre><h3>🚀 Sonuç</h3><p>Tailwind CSS v4.0, geliştiricilere daha esnek, hızlı ve modern bir yapı sunuyor. Konfigürasyon dosyasının kaldırılması ve CSS-first yaklaşımı, stil yönetimini daha sezgisel ve yönetilebilir hale getiriyor. Eğer siz de bu yenilikleri keşfetmek istiyorsanız, <a href="https://tailwindcss.com/blog/tailwindcss-v4">Tailwind CSS v4.0 dokümantasyonuna</a> göz atabilirsiniz.</p><p>Keyifli Kodlamalar 👨‍💻 🎉</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=5b838f4d5613" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Next.js ile Middleware Kullanımı]]></title>
            <link>https://medium.com/@hicran.apaydn/next-js-ile-middleware-kullan%C4%B1m%C4%B1-169991ccc225?source=rss-7fc050bf9691------2</link>
            <guid isPermaLink="false">https://medium.com/p/169991ccc225</guid>
            <dc:creator><![CDATA[Hicran Apaydın]]></dc:creator>
            <pubDate>Fri, 25 Apr 2025 11:23:25 GMT</pubDate>
            <atom:updated>2025-04-25T11:23:25.801Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IzAIwlkNzoHzmCTsLGDc8w.png" /></figure><h4>Middleware Nedir? Ne Zaman Kullanılır?</h4><blockquote>Kafanda şu an şöyle bir sahne olabilir:<br> “Bir request, tarayıcıdan çıkıp server’a doğru yola çıkmış. Yolda, elinde dijital bir düdük olan middleware abimiz durduruyor: ‘Dur bakalım, sen nereye gidiyorsun? Kimlik var mı? Header’ın sağlam mı?’”</blockquote><p>Aslında tam olarak bu!</p><p>Next.js’te <strong>Middleware</strong>, bir isteğin tamamlanmasından <strong>önce</strong> çalışan küçük ama güçlü bir kod bloğudur. Gelen isteğe göre bazı değişiklikler yapabilir:</p><ul><li>Kullanıcıyı başka bir sayfaya yönlendirebilir (redirect),</li><li>Farklı bir sayfaya yönlendirilmiş gibi davranabilir (rewrite),</li><li>Header’lara özel bilgiler ekleyebilir veya silebilir,</li><li>Hatta direkt olarak yanıt dönebilir (response).</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/890/1*rn5XeNUetCOqf4Dl31eUQQ.png" /></figure><p>En güzel yanı şu: Middleware, sayfa cache’lerinden <strong>önce</strong> ve route eşleşmeleri yapılmadan <strong>hemen önce</strong> çalışır. Yani bir sayfa ne kadar önbelleğe alınmış olursa olsun, middleware onu görür. Bu sayede gerçekten hızlı ve hafif işlemler yapılabilir.</p><p><strong>Kullanım Senaryoları</strong></p><p>👣<strong> Hızlı Yönlendirmeler</strong>: Kullanıcıdan gelen isteğin küçük bir kısmını okuyup hemen başka bir sayfaya göndermek (örneğin, dil bazlı yönlendirme).</p><p>🧪 <strong>A/B Testleri:</strong> Kullanıcıyı farklı deneyimlere yönlendirmek.</p><p>📦 <strong>Header Manipülasyonu:</strong> Bütün sayfalara özel header eklemek (örneğin X-Robots-Tag gibi).</p><p>🍪 <strong>Cookie Manipülasyonu: </strong>Kullanıcı siteyi karanlık modda kullanıyorsa, bu tercihini saklamak.</p><h4>İlk Middleware’inizi Yazın:</h4><pre>/my-next-app<br>├── app/<br>├── public/   <br>├── middleware.ts  <br>..</pre><p>Next.js, sadece <strong>tek bir </strong>middleware.ts<strong> (</strong>veya<strong> </strong>.js<strong>)</strong> dosyasını destekler. Her projede yalnızca bir middleware.ts dosyası desteklense de, middleware’inizi modüler yapabilirsiniz. İşlevleri ayrı .ts veya .js dosyalarına ayırıp middleware.ts içinde birleştirerek merkezi ve sade bir yapı elde edilir. Bu yöntem, çakışmaları önler, yapıyı sadeleştirir ve performansı artırır.</p><pre>// middleware.ts<br>import { authMiddleware } from &quot;./middlewares/auth&quot;;<br>import { experimentRedirect } from &quot;./middlewares/abTesting&quot;;<br><br>export function middleware(request: NextRequest) {<br>  if (request.nextUrl.pathname.startsWith(&#39;/admin&#39;)) {<br>    return authMiddleware(request);<br>  }<br><br>  return experimentRedirect(request);<br>}</pre><p><strong>Middleware’in Çalışma Sırası</strong></p><p>Middleware, Next.js uygulamasında sırayla çalıştırılır, bu middleware yazarken dönüp bakmamız gereken bir sıralamadır.</p><ol><li>next.config.js içindeki headers</li><li>next.config.js içindeki redirects</li><li>.. devamını bu linkten incele: <a href="https://nextjs.org/docs/app/building-your-application/routing/middleware#matching-paths">matching paths</a></li></ol><p>Bu yapı sayesinde middleware’lerin yalnızca ihtiyaç duyulan yollar üzerinde çalışması sağlanır, performans kayıpları ve karmaşa engellenir.</p><h4>Matcher ile Yol Belirleme</h4><p>matcher özelliği ile Middleware&#39;in hangi rotalarda çalışacağını belirleyebilirsiniz. Tek bir yol ya da birden fazla yolu dizi şeklinde tanımlayabilirsiniz:</p><pre>import { NextResponse } from &#39;next/server&#39;<br>import type { NextRequest } from &#39;next/server&#39;<br> <br>export function middleware(request: NextRequest) {<br>  return NextResponse.redirect(new URL(&#39;/home&#39;, request.url))<br>}<br> <br>export const config = {<br>  matcher: [&#39;/about/:path*&#39;, &#39;/dashboard/:path*&#39;],<br>}</pre><p>Daha gelişmiş eşleşmeler için RegEx desteklenmektedir. Örneğin bazı yolları hariç tutmak için “negative lookahead” kullanabilirsiniz:</p><pre>export const config = {<br>  matcher: [<br>    &#39;/((?!api|_next/static|_next/image|favicon.ico|sitemap.xml|robots.txt).*)&#39;,<br>  ],<br>}</pre><p><strong>has ve </strong><strong>missing ile filtreleme:</strong></p><p>Amaç: Middleware’in sadece gerekli durumlarda devreye girmesini sağlamak.</p><pre>matcher: [<br>  {<br>    source: &#39;/((?!api|_next|favicon.ico|sitemap.xml|robots.txt).*)&#39;,<br>    // Bu header&#39;lar yoksa çalış<br>    missing: [<br>      { type: &#39;header&#39;, key: &#39;next-router-prefetch&#39; },<br>      { type: &#39;header&#39;, key: &#39;purpose&#39;, value: &#39;prefetch&#39; },<br>    ],<br>  },<br>  {<br>    source: &#39;/((?!api|_next|favicon.ico|sitemap.xml|robots.txt).*)&#39;,<br>    // Bu header&#39;lar varsa çalış<br>    has: [<br>      { type: &#39;header&#39;, key: &#39;next-router-prefetch&#39; },<br>      { type: &#39;header&#39;, key: &#39;purpose&#39;, value: &#39;prefetch&#39; },<br>    ],<br>  },<br>  {<br>    source: &#39;/((?!api|_next|favicon.ico|sitemap.xml|robots.txt).*)&#39;,<br>    // Belirli bir header varsa ama bir diğeri eksikse çalış<br>    has: [{ type: &#39;header&#39;, key: &#39;x-present&#39; }],<br>    missing: [{ type: &#39;header&#39;, key: &#39;x-missing&#39;, value: &#39;prefetch&#39; }],<br>  },<br>]</pre><p><strong>Conditional Rewrite:</strong></p><p>Amaç: Gelen isteklere göre yönlendirme yapmaktır. İsteklerin URL’si belirli bir desene göre kontrol edilir ve eşleşen yollar yeni bir URL’ye yönlendirilir./admin ile başlayan bir URL geldiğinde, kullanıcıyı /internal/admin-panel sayfasına yönlendiriyoruz.</p><pre>export function middleware(request: NextRequest) {<br>  if (request.nextUrl.pathname.startsWith(&#39;/admin&#39;)) {<br>    return NextResponse.rewrite(new URL(&#39;/internal/admin-panel&#39;, request.url))<br>  }</pre><p><strong>Cookie Management (Çerezlerle Kullanım):</strong></p><p>Çerez işlemlericookies.get/set/deleteKullanıcı oturumu, tema seçimi gibi durumlarda kullanılır. Aşağıdaki kod bloğu kullanıcıların oturum açıp açmadığını kontrol eder ve buna göre yönlendirme yapar. Eğer auth_token çerezi yoksa, kullanıcıyı /login sayfasına yönlendirir. Ayrıca, kullanıcının en son ziyaret ettiği sayfa (last_visited) çerezi olarak saklanır.</p><pre>export function middleware(request: NextRequest) {<br>  const authToken = request.cookies.get(&#39;auth_token&#39;)<br><br>  if (!authToken) return NextResponse.redirect(&#39;/login&#39;)<br><br>  const response = NextResponse.next()<br>  response.cookies.set(&#39;last_visited&#39;, request.nextUrl.pathname)<br>  return response<br>}<br>...<br><br>const token = <br>request.cookies.get(&#39;auth_token&#39;)//Belirtilen key adındaki çerezi okur<br>response.cookies.set(&#39;auth_token&#39;, &#39;123abc&#39;) //Bir çerez oluşturur veya var olan bir çerezi günceller.<br>request.cookies.delete(&#39;auth_token&#39;)//Belirtilen key adındaki çerezi siler.</pre><p><strong>Setting Request/Response Headers (İstek manipülasyonu):</strong></p><p>API’yi kullanarak istek ve yanıt başlıklarını ayarlayabiliriz:</p><pre><br>export function middleware(request: NextRequest) {<br>  // Gelen isteğin başlıklarını al ve üzerinde değişiklik yap<br>  const requestHeaders = new Headers(request.headers)<br><br>  // Yeni bir başlık ekle: İstemciden gelen istek türünü belirtmek için<br>  requestHeaders.set(&#39;x-client-type&#39;, &#39;internal-service&#39;)<br><br>  // Yeni başlıklarla bir yanıt oluştur ve isteği ilet<br>  const response = NextResponse.next({<br>    request: {<br>      headers: requestHeaders, // Yeni başlıkları ilet<br>    },<br>  })<br><br>  // Yanıt başlıklarına yeni bir başlık ekle: Middleware&#39;ın çalıştığını belirtmek için<br>  response.headers.set(&#39;x-middleware-trace&#39;, &#39;enabled&#39;)<br><br>  return response<br>}</pre><p><strong>Middleware’den özel yanıtlar:</strong></p><p>Bu yöntemle, istekle ilgili hata durumlarını kolayca yönetebilir ve kullanıcıyı yönlendirebiliriz.</p><pre>import type { NextRequest } from &#39;next/server&#39;<br>import { isAuthenticated } from &#39;@lib/auth&#39;<br><br>export const config = {<br>  matcher: &#39;/api/:function*&#39;,<br>}<br><br>export function middleware(request: NextRequest) {<br>  if (!isAuthenticated(request)) {<br>    // Kimlik doğrulama başarısızsa, 401 ile hata mesajı içeren JSON yanıtı döndür<br>    return Response.json(<br>      { success: false, message: &#39;authentication failed&#39; },<br>      { status: 401 }<br>    )<br>  }<br><br>  return NextResponse.next()<br>}</pre><p>⚙️ <strong>Kısa Notlar</strong></p><ul><li><strong>CORS Yönetimi</strong>: Middleware kullanarak <strong>Cross-Origin Resource Sharing</strong> (CORS) başlıklarını ayarlayabilirsiniz. Bu, dış kaynaklardan gelen istekleri kontrol etmek için kullanılır. Özellikle, <strong>preflight</strong> (OPTIONS) istekleri ve <strong>basit istekler</strong> için CORS başlıklarını yönetebilirsiniz. CORS başlıkları, güvenli ve kontrollü API erişimi sağlamak için kritik öneme sahiptir.</li><li><strong>waitUntil ve </strong><strong>NextFetchEvent</strong>: <strong>waitUntil()</strong> metodu, asenkron işlemleri bekleterek Middleware’ın arka planda çalışmasına olanak tanır..</li><li><strong>Advanced Middleware Flags</strong>:</li></ul><pre>//next.config.js<br>module.exports = { <br>skipTrailingSlashRedirect: true,} //skipTrailingSlashRedirect: Eğik çizgi yönlendirmelerini devre dışı bırakır.<br><br>module.exports = {<br>  skipMiddlewareUrlNormalize: true,}//skipMiddlewareUrlNormalize: URL normalleştirmesini devre dışı bırakır, orijinal URL&#39;yi kullanır.<br></pre><pre>if (<br>  !pathname.endsWith(&#39;/&#39;) &amp;&amp;<br>  !pathname.match(/((?!\.well-known(?:\/.*)?)(?:[^/]+\/)*[^/]+\.\w+)/)<br>) {<br>  return NextResponse.redirect(<br>    new URL(`${req.nextUrl.pathname}/`, req.nextUrl)<br>  )<br>} //bir URL&#39;nin sonunda eğik çizgi eklenmesini kontrol eden kod</pre><ul><li><strong>Unit Testing (Deneysel)</strong>: Next.js v15.1 ile middleware için unit testing t yapılabilir, yalnızca belirli yollar için çalışıp çalışmadığını test edebilirsiniz.</li><li><strong>Edge vs. Node.js Runtime</strong>: <strong>Edge</strong> runtime daha hızlıdır, ancak <strong>Node.js runtime</strong> daha fazla esneklik sunar (deneysel).</li></ul><h3>🚀 Sonuç</h3><p>Next.js’ de<a href="https://nextjs.org/docs/app/building-your-application/routing/middleware"> Middleware</a>, istekleri işleyerek yönlendirme, kimlik doğrulama, header ve cookie yönetimi gibi görevleri merkezi bir noktada gerçekleştirir. Middleware’i etkili bir şekilde nasıl kullanacağınızı anlamak, projenizin içine ve dışına giden veri akışını önemli ölçüde iyileştirebilir.Bu sayede, geliştiriciler için güçlü ve esnek bir araç haline gelir.</p><p>Ben bu süreçte öğrenirken keyif aldım, umarım size bu bilgileri aktarmamın faydasını görürsünüz.</p><p>Keyifli Kodlamalar 👨‍💻 🎉</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=169991ccc225" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[React Hook Form + Zod: Modern Form Validasyonu]]></title>
            <link>https://medium.com/@hicran.apaydn/react-hook-form-zod-modern-form-validasyonu-b25b3feaa787?source=rss-7fc050bf9691------2</link>
            <guid isPermaLink="false">https://medium.com/p/b25b3feaa787</guid>
            <dc:creator><![CDATA[Hicran Apaydın]]></dc:creator>
            <pubDate>Sun, 13 Apr 2025 12:21:38 GMT</pubDate>
            <atom:updated>2025-04-13T12:21:38.910Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ITtABMjkXh0P2ldAMbv1Ug.png" /></figure><p>Formlar, web sitelerinizde ve uygulamalarınızda kullanıcı verilerini toplamanıza olanak tanır. <strong>Form doğrulama</strong>, kullanıcıdan alınan verilerin eksiksiz, doğru ve beklenen formata uygun olmasını sağlar. Hatalı veya eksik verilerin sistemde yer almasını engelleyerek veri tutarlılığı ve güvenlik açısından kritik bir rol oynar.</p><p>Ayrıca, kullanıcıya anlık geri bildirim sunarak daha iyi bir kullanıcı deneyimi oluşturur. Bu yazıda, React Hook Form ve Zod kullanarak nasıl güçlü ve tip güvenli form doğrulama mekanizmaları kurabileceğimizi inceleyeceğiz.</p><h3>🔹 Zod Nedir ve Neden Tercih Edilir?</h3><p>Zod, <strong>TypeScript-first</strong> bir şema doğrulama kütüphanesidir. Hem <strong>compile-time</strong> hem de <strong>runtime</strong> doğrulama sunar ve tanımlanan şemalardan doğrudan TypeScript türleri üretir. Bu sayede tekrar eden tip tanımlarını ortadan kaldırır.</p><p>Minimalist ve zincirlenebilir API yapısıyla okunabilirliği yüksek, büyük ölçekli projelerde kullanıma uygundur. TypeScript gerektirmeden JavaScript projelerinde de çalışabilir.</p><p>React projelerinde, Zod genellikle react-hook-form ile birlikte kullanılır. zodResolver sayesinde tanımlanan şemalar doğrudan form doğrulaması için entegre edilebilir ve form doğruluğu güvenli bir şekilde sağlanır.</p><p><a href="https://zod.dev/?id=schema-methods"><strong>Zod şemaları:</strong></a> Şemalar, bir veri nesnesinin sahip olması gereken yapı ve kuralları tanımlar. Zod’daki tüm doğrulama işlemleri bu şemalar üzerinden gerçekleştirilir. Örneğin, formSchema kullanılarak geçerli bir kullanıcı verisinin hangi alanlara sahip olması gerektiği ve bu alanların özellikleri net bir şekilde belirlenebilir.</p><pre>//&quot;validation&quot;;<br>import * as z from &#39;zod&#39;;<br><br>const stringSchema = z.string(); // Validates a string<br>const numberSchema = z.number(); // Validates a number<br>const booleanSchema = z.boolean(); // Validates a boolean<br>const dateSchema= z.date();// Validates a date<br>...</pre><p><em>Zod Kullanımı: </em><em>z.instanceof, </em><em>refine, </em><em>min, </em><em>max, ve </em><em>optional</em></p><pre>import * as z from &#39;zod&#39;;<br><br>export const formSchema = z.object({<br>  fullName: z.string().min(3, &quot;Full name must be at least 3 characters long.&quot;),<br>  email: z.string().email(&quot;Please enter a valid email address.&quot;),<br>  phoneNumber: z.string().min(10, &quot;Phone number must be at least 10 digits long.&quot;).max(15, &quot;Phone number can be at most 15 digits long.&quot;),<br>  startDate: z.date().optional()({ &quot;Start date is optional&quot; }),<br>  resume: z.instanceof(File).refine(file =&gt; file.type === &quot;application/pdf&quot;, &quot;Only PDF files are allowed.&quot;),<br>  acceptTerms: z.boolean().refine(val =&gt; val === true, &quot;You must accept the terms and conditions.&quot;),<br>});</pre><p>z.instanceof() Belirli bir türün örneği olup olmadığını doğrular, genellikle nesnelerin türünü kontrol etmek için kullanılır.</p><p>z.refine() Özelleştirilmiş doğrulama kuralları ekler. Varsayılan doğrulama yetersizse, özel koşullar tanımlanabilir ve hata mesajları sağlanabilir.</p><p>z.min() ve z.max() Sayılar ve dizeler için minimum ve maksimum sınır belirler. z.min() değerin bir alt sınırdan küçük olmamasını, z.max() ise üst sınırı aşmamasını sağlar.</p><p>z.optional()Bir alanın isteğe bağlı olduğunu belirtir, kullanıcı bu alanı doldurmazsa hata verilmez.</p><p>Zod, her doğrulama kuralı için özelleştirilmiş <strong>hata mesajları</strong> sağlar, bu da kullanıcıya hatalı girişlerde açık geri bildirim sunar.</p><h3>🔁 Zod &amp; React Hook Form Entegrasyonu</h3><p><a href="https://react-hook-form.com/">React-Hook-Form</a>, form durumunu yönetmek için hafif ve performans odaklı bir çözümdür. Zod ise güçlü doğrulama kuralları tanımlamak için kullanılır. Bu iki araç birlikte kullanıldığında, hem form yönetimi hem de doğrulama süreci oldukça verimli hâle gelir.<br> @hookform/resolvers paketi üzerinden gelen zodResolver, Zod şemasını React Hook Form ile entegre etmemizi sağlar. Böylece form gönderiminde otomatik doğrulama yapılır ve kullanıcıya anında geri bildirim verilir.</p><pre>import { useForm } from &quot;react-hook-form&quot;;<br>import { zodResolver } from &quot;@hookform/resolvers/zod&quot;;<br>import { formSchema } from &quot;@/lib/validation&quot;;<br>import { z } from &quot;zod&quot;;<br><br>type PersonalInfoFormData = z.infer&lt;typeof formSchema&gt;;</pre><p><a href="https://zod.dev/?id=type-inference"><strong>TypeScript tür çıkarımı:</strong></a><strong> </strong>type PersonalInfoFormData = z.infer&lt;typeof formSchema&gt; satırı, Zod şemasından doğrudan bir TypeScript tipi türetir. Böylece şema ile uyumlu ve tekrar eden tanımlamalara gerek kalmadan güçlü bir tip kontrolü elde edilir.</p><pre>interface PersonalInfoProps {<br>  onStepSubmit: (data: PersonalInfoFormData) =&gt; void;<br>  onBack: () =&gt; void;<br>}<br><br>export default function PersonalInfoPage({ onStepSubmit }: PersonalInfoProps) {<br>  const form = useForm&lt;PersonalInfoFormData&gt;({<br>    resolver: zodResolver(formSchema),<br>    defaultValues: {<br>      fullName: &quot;&quot;,<br>      email: &quot;&quot;,<br>      phoneNumber: &quot;&quot;,<br>      // Add other fields as needed<br>      <br>    },<br>  });</pre><p>useForm&lt;PersonalInfoFormData&gt; ifadesi, formun TypeScript tip güvenliğini sağlamak için Zod şemasından türetilmiş olan PersonalInfoFormData tipini kullanır. Bu sayede form verileri üzerinde hem derleme zamanında hem de çalışma zamanında kontrol sağlanmış olur.</p><p>resolver: zodResolver(formSchema) ile Zod şeması, React Hook Form’a entegre edilir. Bu yapı, form alanlarına girilen verilerin Zod kurallarına göre otomatik olarak doğrulanmasını sağlar.</p><p>defaultValues ise form alanlarının başlangıçta hangi değerlerle yükleneceğini belirler. Bu, hem varsayılan değerleri yönetmek hem de controlled input yapısını desteklemek için önemlidir.</p><h4>🧠 Form Elemanı Oluşturun:</h4><pre><br>&lt;Form {...form}&gt;<br>      &lt;form onSubmit={form.handleSubmit(onSubmit)} className=&quot;space-y-8&quot;&gt;<br>        &lt;FormField<br>          control={form.control}<br>          name=&quot;fullName&quot;<br>          render={({ field }) =&gt; (<br>            &lt;FormItem&gt;<br>              &lt;FormLabel&gt;Full Name&lt;/FormLabel&gt;<br>              &lt;FormControl&gt;<br>                &lt;Input placeholder=&quot;Full Name&quot; {...field} /&gt;<br>              &lt;/FormControl&gt;<br>              &lt;FormMessage /&gt;<br>            &lt;/FormItem&gt;<br>          )}<br>        /&gt;<br>....<br></pre><p>Her bir form alanı, React Hook Form’un useForm hook&#39;u ve FormField bileşenleriyle kontrol edilir. Form elemanları, Zod şemasıyla doğrulama kuralları belirlenerek, form gönderildiğinde kullanıcıya geri bildirim sağlanır. Zod doğrulaması sayesinde, her bir form elemanı için beklenen veri tipleri, minimum ve maksimum uzunluklar, zorunlu alanlar gibi kısıtlamalar sağlanır.</p><p>Bu yapı, form verilerinin doğru bir şekilde yönetilmesini, kullanıcıya açık geri bildirimler sunulmasını sağlar ve React Hook Form ile Zod’un sunduğu tip güvenliğini kullanarak daha güvenli ve verimli bir form doğrulama deneyimi oluşturur.</p><h4>🚀 Sonuç</h4><p><strong>Zod</strong> ve <strong>React Hook Form</strong> kombinasyonu, form doğrulama ve yönetimi için güçlü ve kullanıcı dostu bir çözüm sunar. Bu yazıda, Zod’un sunduğu şema doğrulama özelliklerini, React Hook Form ile nasıl entegre edilebileceğini ve veri doğrulama sürecini daha verimli hale getirecek çeşitli yöntemleri ele aldık.</p><p>Eğer bu konuları daha detaylı bir şekilde keşfetmek isterseniz, Zod ve React Hook Form kullanarak geliştirdiğim <a href="https://github.com/hicrandn/multi-step-form"><strong>Multi-Step Form Projemi</strong></a> inceleyebilirsiniz.</p><p>Bu kombinasyon, projelerinizde veri doğrulama sürecini basitleştirirken, aynı zamanda kullanıcı deneyimini geliştirir. Umarım bu yazı, sizlere Zod ve React Hook Form’u kullanma konusunda yardımcı olmuştur!</p><p>Keyifli Kodlamalar 👨‍💻 🎉</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b25b3feaa787" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Next.js 15 ile Server Components ve Client Components]]></title>
            <link>https://medium.com/@hicran.apaydn/next-js-15-ile-server-components-ve-client-components-9f8c456214f1?source=rss-7fc050bf9691------2</link>
            <guid isPermaLink="false">https://medium.com/p/9f8c456214f1</guid>
            <dc:creator><![CDATA[Hicran Apaydın]]></dc:creator>
            <pubDate>Tue, 08 Apr 2025 13:40:07 GMT</pubDate>
            <atom:updated>2025-04-08T14:10:45.750Z</atom:updated>
            <content:encoded><![CDATA[<p>Next.js 15 ile birlikte <strong>Server Components</strong> ve <strong>Client Components</strong> kullanımı daha da yaygınlaştı.Sunucu-istemci mimarisini daha iyi anlayabilmek için, web dünyasındaki iki temel kavram hakkında bilgi sahibi olmak önemlidir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jqrxl7__iIv0qn6CYyLVgA.png" /><figcaption>[Server and client Components](<a href="https://nextjs.org/learn/react-foundations/server-and-client-components">https://nextjs.org/docs/advanced-features/server-components</a>)</figcaption></figure><p>👨‍💻Client Components, kullanıcının cihazındaki tarayıcıda çalışan bileşenlerdir. Tarayıcı, sunucudan uygulama kodunu talep eder ve aldığı yanıtı etkileşimli bir kullanıcı arayüzüne dönüştürür. Bu bileşenler, JavaScript kullanarak çalışır ve genellikle kullanıcı etkileşimi gerektiren, dinamik veri işleyen durumlar için tercih edilir.</p><p>⚙️Server Components, verilerin işlendiği ve render işlemlerinin gerçekleştirildiği sunucu taraflı bileşenlerdir. Sunucu, veri merkezinde yer alan ve istemciden gelen istekleri karşılayan bir bilgisayardır; uygulama kodunu barındırır, gerekli hesaplamaları yapar ve istemciye sadece işlenmiş HTML çıktısını gönderir. Bu yapı, istemci tarafındaki yükü azaltarak sayfa yükleme hızını artırır ve daha verimli bir kullanıcı deneyimi sağlar.</p><h4>Yeni Default: Server Components</h4><p>Next.js 15 ile birlikte Server Components, varsayılan bileşen tipi haline gelmiştir. Yani bir bileşen oluşturduğunuzda, ekstra bir yapılandırmaya ihtiyaç duymadan React tarafından otomatik olarak Server Component olarak değerlendirilir. Bu yaklaşım, uygulamanızın performansını artırmayı amaçlar ve tüm bileşenlerin varsayılan olarak sunucuda çalışmasını sağlar.</p><p>İlk etapta Server Component olarak yazmak, gereksiz client-side yükü ve JavaScript’i engelleyecektir. Eğer bileşen etkileşim gerektirmiyorsa, sadece veriyi sunucuda işlemek mantıklı olacaktır. Bu sayfa yükleme süresini ciddi anlamda hızlanır.</p><h4>👆Client Component’lere Ne Zaman İhtiyacımız Olur?</h4><p>Kullanıcı etkileşimlerini yönetmek, animasyonlar, formlar, local state gibi client-side logic gerektiren durumlarda devreye girerler.</p><p>Eğer bir bileşen</p><ul><li>useState, useEffect, useRef gibi hook’lara ihtiyaç duyuyorsa,</li><li>Kullanıcı etkileşimleri (click, input, hover) ile çalışıyorsa,</li><li>Tarayıcı API’lerini (window, localStorage, document) kullanıyorsa,</li><li>Form kontrolleri, tema değişimi, modal yönetimi gibi işlemler yapıyorsan o bileşeni <strong>Client Component</strong> olarak işaretlememiz gerekir. Bu da çok basit bir şekilde, bileşenin en üstüne &#39;use client&#39; direktifini yazarak yapılır:</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/918/1*VCVClnt1wFYHktjMmsmiQQ.png" /></figure><p>Tarayıcıdaki hataya baktığınızda, Next.js size bir Server Component içinde useState kullanmaya çalıştığınız konusunda uyarı veriyor. Bu hatayı düzeltmek için, etkileşimli olan butonun bir Client Component içerisine taşıyabilirsiniz. Dosyanın en üstüne React &#39;use client&#39; yönergesini eklersek React’a bileşenin istemci tarafında çalıştırılması gerektiğini bildirmiş oluruz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/914/1*LhA5mhjKNBh1YOkt5EF5Mw.png" /></figure><p>Bu şekilde hata çözülmüş olur. Ayrıca tüm etkileşimler tarayıcıda gerçekleşir ve sayfa yenilemesi gerekmez.</p><h4>⚙️<strong>Server Component’lere Ne Zaman İhtiyacımız Olur?</strong></h4><p>Aşağıdaki durumlar söz konusuysa, bileşeni <strong>Server Component</strong> olarak bırakmak (zaten varsayılan olarak böyle gelir) genellikle tercih edilir:</p><ul><li><strong>Asenkron veri çekme</strong> (API çağrıları, veritabanı sorguları): Sunucu tarafında veriye erişim sağlayan işlemler için Server Component kullanımı gereklidir.</li><li><strong>Çevresel değişken (process.env)</strong> kullanma: Çevresel değişkenlere yalnızca sunucu tarafında erişilebilir, bu nedenle bu tür işlemler için Server Component kullanmak daha güvenli olur.</li><li><strong>Sadece statik HTML render etme</strong>: Dinamik veri ya da interaktif öğeler içermeyen sayfalar için sadece HTML render’ı gerekiyorsa, Server Component kullanmak sayfa yükleme hızını artırır.</li><li><strong>UI etkileşimi gerekmiyorsa</strong>: Kullanıcı etkileşimi gerektirmeyen ve yalnızca veriyi görüntüleyen sayfalar için sunucu tarafında işleme yapılması, daha hızlı ve verimli sonuçlar sağlar.</li></ul><p>Bu yaklaşım, <strong>daha az JavaScript</strong>, <strong>daha hızlı sayfa yükleme</strong>, <strong>daha güvenli kod</strong> ve <strong>daha iyi SEO</strong> sağlar.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fG81v0Lf6AybFBzyUZzSCw.png" /></figure><p>Bu bileşen unucudan veri çekiyor async fonksiyon kullanıyor.Kullanıcıyla doğrudan etkileşimi yok yani server component adayı.</p><h4>🚫 Sunucuya özel işlemleri Server Component’te tut</h4><blockquote>Veritabanı bağlantısı, authentication, ortam değişkenleri gibi işlemleri client component’e sokmamaya dikkat etmeliyiz. Güvenlik riski doğurur.</blockquote><p>Client-side rendering (CSR) yaparken tüm veriler, kullanıcı tarayıcısında JavaScript olarak işlenir. Bu, kötü niyetli kişilerin sayfanın kaynak kodunu inceleyerek veya geliştirici araçlarını kullanarak kritik verilere erişmesine neden olabilir. Ancak, Server Components ile veriler sadece <strong>sunucuda işlenir</strong>, tarayıcıya gönderilmez.</p><p>Client-side rendering’da veriyi doğru bir şekilde maskelemek, şifrelemek zor olabilir. Ancak Server Components ile sadece gerekli veriler istemciye gönderilir, hassas veriler <strong>gizli kalır</strong>.</p><h4>🔑 Etkileşim ve Sunucu İle İletişim</h4><p>Next.js’te Server ve Client Components kullanırken, etkileşimler Server Actions ile sunucu tarafında da işlenebilir. Bu, istemciye daha az JavaScript gönderir, sayfa yükleme süresini kısaltır ve güvenliği artırır. Veriler sunucuda işlenir, API endpoint’lerine gerek kalmaz. JavaScript devre dışı olsa bile formlar çalışır ve erişilebilirlik sağlanır. Sayfa yenilemesi olmadan sonuçlar gösterilebilir ve Optimistic UI güncellemeleri yapılabilir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lyBkTLhO3x9QgA23Me0duQ.png" /></figure><h4>✨ Sonuç</h4><p>Next.js 15, Server ve Client Components kullanarak daha hızlı ve güvenli web uygulamaları geliştirmeyi mümkün kılar. Server Components, yalnızca gerekli verileri tarayıcıya göndererek performansı optimize ederken, güvenlik avantajları da sağlar. Hangi bileşenin sunucu, hangisinin istemci tarafında çalışacağına dikkat etmek, uygulamanın yönetilebilirliğini ve güvenliğini artırır.</p><p>Hızlı ve keyifli kodlamalar! 🎉</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9f8c456214f1" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>