Modern web geliştirme dünyasında hız, performans ve geliştirici deneyimi her zamankinden daha önemli hale geldi. Peki, karmaşık araç zincirleri ve yavaş derleme süreleri olmadan, Type-Safe bir şekilde hızlı web uygulamaları geliştirmek mümkün mü? İşte bu noktada, Deno’nun üzerinde yükselen ve “Ada Mimarisi” ile dikkat çeken Fresh Framework, taze bir nefes gibi karşımıza çıkıyor. Bu rehberde, Fresh’in temel taşlarını keşfederken, ilk projemizi nasıl hayata geçireceğimizi ve modern web geliştirmenin sunduğu avantajları nasıl yakalayabileceğimizi adım adım inceleyeceğiz.
Günümüz web geliştirme ekosistemi, sürekli yeni araçlar ve paradigmalarla evriliyor. JavaScript tabanlı tek sayfa uygulamalar (SPA’lar) her ne kadar geliştiriciye büyük esneklik sunsa da, başlangıç yükleme süreleri ve SEO sorunları gibi zorlukları da beraberinde getirebiliyor. Kullanıcılar, ilk sayfanın hızlı yüklenmesini beklerken, geliştiriciler ise karmaşık yapılandırmalarla boğuşmak zorunda kalabiliyorlar. Özellikle büyük projelerde, geliştirme ortamının kurulması, bağımlılıkların yönetimi ve derleme süreçleri ciddi zaman kaybına yol açabiliyor. Bu durum, hem geliştiricinin verimliliğini düşürüyor hem de projenin piyasaya sürülme süresini uzatabiliyor.
Fresh Framework, bu sorunlara modern ve yenilikçi bir bakış açısıyla yaklaşıyor. Deno runtime’ının sağladığı güçlü temel üzerine inşa edilen Fresh, varsayılan olarak sunucu tarafında işleme (Server-Side Rendering – SSR) ve yalnızca gerektiğinde istemci tarafı etkileşimi sağlayan “Ada Mimarisi” (Island Architecture) felsefesini benimsiyor. Bu yaklaşım, kullanıcıya ultra hızlı bir başlangıç deneyimi sunarken, geliştiricilere de tanıdık Preact/JSX sözdizimiyle Type-Safe bir geliştirme ortamı sağlıyor. Fresh’in sıfır yapılandırma gerektirmesi, yerleşik TypeScript desteği ve Vite gibi hızlı geliştirme araçlarını kullanmaması, projelere başlama ve ilerleme süreçlerini inanılmaz derecede hızlandırıyor. Fresh, yalnızca Deno ekosistemine özgü bir yenilik olmakla kalmıyor, aynı zamanda tüm web geliştirme camiasına, daha verimli, daha hızlı ve daha güvenli uygulamaların nasıl inşa edilebileceği konusunda önemli bir örnek teşkil ediyor. Geliştirici deneyimini merkeze alan bu yaklaşım, karmaşıklıktan uzak, sade ama güçlü bir alternatif arayan herkes için Fresh’i cazip bir seçenek haline getiriyor. Kısacası, Fresh, modern web uygulamalarını daha az eforla, daha hızlı ve daha performanslı bir şekilde geliştirmek isteyen herkesin kesinlikle göz atması gereken bir teknolojidir.
Fresh ve Deno’nun Temelleri Nelerdir? Bu İkili Neden Güçlü Bir Kombinasyon Sunuyor?
Fresh Framework’ü anlamadan önce, onun üzerinde yükseldiği temeli, yani Deno’yu iyi kavramak kritik öneme sahiptir. Deno, Node.js’in yaratıcısı Ryan Dahl tarafından geliştirilen, JavaScript, TypeScript ve WebAssembly için güvenli bir runtime ortamıdır. Deno’nun en belirgin özelliklerinden bazıları, varsayılan olarak güvenliği ön planda tutması (dosya sistemi, ağ veya ortam değişkenlerine erişim için açık izin gerektirmesi), TypeScript’i kutudan çıkar çıkmaz desteklemesi ve merkezi bir paket yöneticisine (npm gibi) ihtiyaç duymadan URL tabanlı modül ithalatı yapmasıdır. Bu özellikler, geliştiricilere daha güvenli, daha basit ve daha öngörülebilir bir geliştirme ortamı sunar. Deno’nun yerleşik test runner’ı, formatlayıcısı ve lint aracı gibi özellikler, ayrı araçlar kurma gereksinimini ortadan kaldırarak geliştirme sürecini daha akıcı hale getirir. Tüm bu özellikler, Deno’yu modern web uygulamaları geliştirmek için ideal bir platform yapar.
Peki, Fresh bu resme nasıl dahil oluyor? Fresh, Deno için geliştirilmiş, hızlı, esnek ve “sıfır konfigürasyon” felsefesiyle tasarlanmış bir meta-framework’tür. Temelde Preact ve JSX’i kullanarak kullanıcı arayüzleri oluşturmanıza olanak tanır. Ancak Fresh’i diğer modern framework’lerden ayıran en önemli özelliği, varsayılan olarak sunucu tarafında işleme (SSR) yapması ve “Ada Mimarisi” (Island Architecture) denilen bir yaklaşımla, sadece etkileşimli bileşenlerin (adalıklar) istemci tarafında çalışmasını sağlamasıdır. Bu sayede, tarayıcıya gönderilen JavaScript miktarı minimuma iner, bu da çok daha hızlı sayfa yüklemelerine ve daha iyi bir kullanıcı deneyimine yol açar. Geleneksel SPA’ların aksine, Fresh varsayılan olarak “sıfır JavaScript” göndererek performans avantajı sağlar, sadece interaktif kısımlar için gerekli olan JavaScript’i gönderir ve bunları ayrı “adalar” olarak izole eder. Bu, özellikle mobil cihazlarda veya yavaş internet bağlantılarında kullanıcılar için fark yaratır.
Bu ikilinin gücü, Deno’nun güvenlik, Type-Safe geliştirme ve basitlik anlayışı ile Fresh’in performansa odaklanan, minimal JavaScript felsefesinin birleşmesinden gelir. Deno’nun TypeScript’i doğal olarak desteklemesi, Fresh ile geliştirilen uygulamaların baştan sona tip güvenli olmasını sağlar, bu da büyük projelerde hata ayıklama süresini azaltır ve kod kalitesini artırır. Ayrıca, Deno’nun yerleşik araçları Fresh geliştirme deneyimini daha da zenginleştirir. Örneğin, Deno Deploy gibi servisler sayesinde Fresh uygulamalarını hızlı ve sorunsuz bir şekilde buluta dağıtabilirsiniz. Sonuç olarak, Fresh ve Deno kombinasyonu, hem geliştirici verimliliğini artıran hem de son kullanıcıya üstün bir performans deneyimi sunan, gerçekten modern bir web geliştirme yığını oluşturur.
Fresh Projesi Nasıl Başlatılır ve İlk Uygulama Nasıl Geliştirilir?
Fresh ile bir projeye başlamak, Deno’nun sunduğu basitlik sayesinde oldukça hızlı ve sorunsuzdur. İlk adım olarak, bilgisayarınızda Deno’nun kurulu olduğundan emin olmalısınız. Eğer kurulu değilse, resmi Deno web sitesindeki yönergeleri takip ederek kolayca kurabilirsiniz. Deno’nun kurulumu tamamlandıktan sonra, Fresh projemizi oluşturmaya ve ilk uygulamamızı geliştirmeye hazırız. Kurulumdan sonra, terminalinizi açın ve aşağıdaki komutu çalıştırarak yeni bir Fresh projesi başlatın:
deno run -A https://deno.land/x/fresh@1.6.0/init.ts my-fresh-app
Bu komut, my-fresh-app adında yeni bir dizin oluşturacak ve Fresh için gerekli tüm dosya yapısını otomatik olarak kuracaktır. Burada -A (veya --allow-all) bayrağı, Deno'ya gerekli tüm izinleri vermesini söyler; bu, özellikle yeni bir proje oluştururken veya üçüncü taraf kod çalıştırırken yaygın bir pratik olsa da, üretim ortamında spesifik izinler vermek daha güvenlidir. Komut çalıştıktan sonra, terminalinizde oluşturulan proje yapısını göreceksiniz. Bu yapı, routes/, islands/, static/ gibi dizinleri ve deno.json, main.ts gibi önemli dosyaları içerir. routes/ dizini, uygulamanızın URL yollarını ve bunlara karşılık gelen sayfaları tanımlar. islands/ dizini, etkileşimli bileşenlerinizi içerir. static/ ise, resimler, CSS dosyaları gibi statik varlıklarınızı barındırır.
Şimdi, oluşturduğumuz my-fresh-app dizinine geçelim:
cd my-fresh-app
Projenizi çalıştırmak için aşağıdaki komutu kullanın:
deno task start
Bu komut, Fresh uygulamanızı http://localhost:8000 adresinde çalıştıran bir geliştirme sunucusu başlatır. Tarayıcınızda bu adrese giderek Fresh'in varsayılan karşılama sayfasını görebilirsiniz. Fresh ile basit bir "Merhaba Dünya" uygulaması oluşturmak için routes/index.tsx dosyasını düzenleyebilirsiniz. Bu dosya, ana sayfanızı temsil eder. İçeriğini aşağıdaki gibi güncelleyelim:
// routes/index.tsx
import { Handlers } from "$fresh/server.ts";
export const handler: Handlers = {
GET() {
return new Response(
Merhaba Fresh Dünyası!
Fresh ile Merhaba Dünya!
Bu, ilk Fresh uygulamanız.
, {
headers: {
"content-type": "text/html",
},
});
},
};
Bu örnekte, routes/index.tsx dosyası, sunucu tarafından işlenecek basit bir HTML sayfası döndürüyor. Handlers tipini kullanarak HTTP GET isteğini nasıl yanıtlayacağımızı belirtiyoruz. Fresh, herhangi bir derleme adımına ihtiyaç duymadan değişikliklerinizi otomatik olarak algılar ve geliştirme sunucusunu yeniden başlatır. Tarayıcınızı yenilediğinizde, "Fresh ile Merhaba Dünya!" başlığını görmelisiniz. Bu basit adım, Fresh ile ilk uygulamanızı başarıyla çalıştırmanızı sağlar ve size framework'ün temel çalışma mantığı hakkında bir fikir verir. Bu noktadan itibaren, dinamik rotalar, API uç noktaları ve etkileşimli bileşenler oluşturarak uygulamanızı genişletmeye başlayabilirsiniz.
deno.land/x/ üzerinden dışa aktarılan modüller versiyonlanmıştır (örneğin @1.6.0). Bu, bağımlılıklarınızın sabit kalmasını sağlar. Ancak, en son kararlı sürümü kullandığınızdan emin olmak için ara sıra bu versiyon numaralarını kontrol etmek iyi bir alışkanlıktır.
Fresh'in Benzersiz "Island Architecture" Yaklaşımı Ne Anlama Geliyor?
Fresh Framework'ü modern web geliştirme sahnesinde öne çıkaran en çarpıcı özelliklerden biri, "Ada Mimarisi" (Island Architecture) olarak adlandırılan benzersiz yaklaşımıdır. Geleneksel tek sayfa uygulamaları (SPA'lar) veya istemci tarafı işleme (Client-Side Rendering - CSR) yapan framework'ler genellikle başlangıçta büyük bir JavaScript paketi gönderir ve sayfanın etkileşimli hale gelmesi için tüm bu JavaScript'in tarayıcıda yüklenmesini, ayrıştırılmasını ve yürütülmesini (hydration) bekler. Bu süreç, özellikle yavaş internet bağlantılarında veya düşük güçlü cihazlarda sayfa yükleme sürelerini uzatarak kötü bir kullanıcı deneyimine yol açabilir. Fresh, bu soruna farklı bir çözüm getiriyor.
Ada Mimarisi, varsayılan olarak tüm HTML'in sunucu tarafında (SSR) oluşturulup istemciye gönderilmesine dayanır. Bu, tarayıcının hızlıca bir sayfa görmesini sağlar ve SEO dostudur. Ancak, sayfa üzerinde dinamik veya etkileşimli bileşenler (örneğin bir sayaç, bir form doğrulama, bir karusel) olduğunda, Fresh sadece bu belirli bileşenler için gerekli olan JavaScript'i istemciye gönderir ve bunları bağımsız "adalar" (islands) olarak izole eder. Her ada, kendi JavaScript'i, bağımlılıkları ve yaşam döngüsüyle tamamen bağımsız bir şekilde çalışır. Bu, sayfanın geri kalanının tamamen statik kalırken, yalnızca etkileşimli kısımların "canlanması" anlamına gelir. Bu mimarinin temel avantajları şunlardır:
- Daha Hızlı İlk Yükleme Süreleri: Tarayıcıya gönderilen JavaScript miktarı önemli ölçüde azaldığı için, sayfa çok daha hızlı render edilir ve interaktif hale gelir.
- Daha İyi SEO: Tüm içeriğin sunucu tarafında işlenmesi, arama motorlarının içeriği daha kolay indekslemesini sağlar.
- Daha Az İstemci Tarafı Yükü: Yalnızca gerekli olan JavaScript yüklenir ve çalıştırılır, bu da cihazın işlem gücünü ve pil ömrünü korur.
- Geliştirilmiş Performans: "Hydration" maliyeti sadece adaların boyutuyla sınırlıdır, tüm sayfanın yeniden "canlandırılmasına" gerek kalmaz.
Fresh'te bir "ada" oluşturmak oldukça basittir. Etkileşimli olmasını istediğiniz herhangi bir Preact bileşenini islands/ dizinine yerleştirmeniz yeterlidir. Fresh, bu dizindeki bileşenleri otomatik olarak algılar ve bunları istemci tarafında çalışacak şekilde optimize eder. İşte basit bir sayaç adası örneği:
// islands/Counter.tsx
import { useState } from "preact/hooks";
import { FunctionalComponent } from "preact";
const Counter: FunctionalComponent = () => {
const [count, setCount] = useState(0);
return (
Sayım: {count}
);
};
export default Counter;
Daha sonra bu adayı herhangi bir rotada (örneğin routes/index.tsx) kullanabilirsiniz:
// routes/index.tsx
import Counter from "../islands/Counter.tsx";
export default function Home() {
return (
Fresh Ada Mimarisi
Fresh ile Ada Mimarisi Deneyimi
Aşağıdaki sayaç, sadece kendi JavaScript'iyle çalışan bir 'ada'dır.
);
}
Bu örnekte, Counter bileşeni islands/ dizinine yerleştirildiği için, Fresh otomatik olarak bu bileşenin JavaScript'ini istemciye gönderecek ve onu etkileşimli hale getirecektir. Sayfanın geri kalan HTML'i ise sunucuda işlenmiş ve tamamen statik kalacaktır. Bu ayrım, web uygulamalarınızın performansını ve verimliliğini devrim niteliğinde iyileştirebilir.
Fresh ile Dinamik Rotalar ve API Uç Noktaları Nasıl Oluşturulur?
Fresh Framework, Deno'nun gücünü kullanarak dinamik web uygulamaları ve API'ler oluşturmayı basitleştirir. Bu süreçte, dosya tabanlı rota sistemi ve entegre API uç noktaları oluşturma yeteneği, geliştiricilere büyük kolaylık sağlar. Fresh'in rota sistemi, Next.js veya Nuxt.js gibi diğer framework'lere aşina olanlar için oldukça tanıdık gelecektir; routes/ dizinindeki dosya ve klasör yapısı, uygulamanızın URL'lerini doğrudan yansıtır.
Dinamik Rotalar Oluşturma:
Uygulamanızda sıkça karşımıza çıkan bir senaryo, kullanıcı veya ürün ID'si gibi değişkenlere göre içerik sunmaktır. Fresh'te dinamik rotalar, dosya adlarını köşeli parantez içinde tanımlayarak oluşturulur. Örneğin, bir kullanıcının profil sayfasını '/users/:id' şeklinde bir URL ile sunmak istiyorsanız, routes/users/[id].tsx adında bir dosya oluşturursunuz. Bu dosyanın içeriği, id parametresini alarak ilgili kullanıcı bilgilerini gösterebilir:
// routes/users/[id].tsx
import { PageProps } from "$fresh/server.ts";
interface User {
id: string;
name: string;
email: string;
}
// Basit bir veri kaynağı olarak kullanıcı listesi
const users: User[] = [
{ id: "1", name: "Alice", email: "alice@example.com" },
{ id: "2", name: "Bob", email: "bob@example.com" },
];
export default function UserPage({ params }: PageProps) {
const user = users.find((u) => u.id === params.id);
if (!user) {
return Kullanıcı bulunamadı.;
}
return (
Kullanıcı Profili: {user.name}
Kullanıcı Profili
ID: {user.id}
Ad: {user.name}
E-posta: {user.email}
Tüm Kullanıcılar
);
}
Bu örnekte, PageProps arayüzü sayesinde rota parametrelerine (params) kolayca erişebiliriz. params.id ile URL'deki dinamik ID değerini alıyor ve bu değere göre kullanıcı bilgilerini getiriyoruz. Eğer http://localhost:8000/users/1 adresine giderseniz, Alice'in profilini göreceksiniz.
API Uç Noktaları Oluşturma:
Fresh, hem sunucu tarafı sayfalarını hem de RESTful API uç noktalarını aynı routes/ dizini altında yönetmenize olanak tanır. API rotaları genellikle routes/api/ dizini altında tanımlanır ve HTTP metotlarına (GET, POST, PUT, DELETE vb.) göre istekleri işler. İşte basit bir kullanıcı listesi döndüren API uç noktası örneği:
// routes/api/users.ts
import { Handlers } from "$fresh/server.ts";
interface User {
id: string;
name: string;
email: string;
}
// Basit bir veri kaynağı olarak kullanıcı listesi
const users: User[] = [
{ id: "1", name: "Alice", email: "alice@example.com" },
{ id: "2", name: "Bob", email: "bob@example.com" },
{ id: "3", name: "Charlie", email: "charlie@example.com" },
];
export const handler: Handlers = {
GET(_req, _ctx) {
// Tüm kullanıcıları JSON formatında döndür
return new Response(JSON.stringify(users), {
headers: { "Content-Type": "application/json" },
});
},
POST: async (req, _ctx) => {
// Yeni bir kullanıcı oluşturma
try {
const newUser: User = await req.json();
if (!newUser.id || !newUser.name || !newUser.email) {
return new Response("Eksik kullanıcı bilgisi", { status: 400 });
}
users.push(newUser); // Gerçek bir uygulamada veritabanına kaydedilir
return new Response(JSON.stringify(newUser), {
status: 201,
headers: { "Content-Type": "application/json" },
});
} catch (error) {
return new Response(error.message, { status: 400 });
}
},
};
Bu routes/api/users.ts dosyası, http://localhost:8000/api/users adresine yapılan GET isteklerini tüm kullanıcıları JSON olarak döndürerek yanıtlar. Aynı zamanda, bir POST isteğiyle yeni kullanıcı eklemeyi de destekler. Handlers arayüzü, farklı HTTP metotlarını yönetmek için esnek bir yol sunar. _req ve _ctx parametreleri, istekle ilgili bilgilere ve bağlam nesnesine erişim sağlar.
Fresh'in bu dosya tabanlı rota sistemi, hem statik/dinamik sayfaları hem de API uç noktalarını tek bir yapı içinde tutarlı ve düzenli bir şekilde yönetmenizi sağlar. Bu yaklaşım, geliştirme sürecini basitleştirir ve büyük projelerde bile kod tabanının kolayca anlaşılabilir kalmasına yardımcı olur. Dolayısıyla, Fresh, hem ön yüz hem de arka yüz geliştirme ihtiyaçlarınızı karşılayabilecek güçlü ve entegre bir çözüm sunar.
Gerçek Dünya Senaryosu: Basit Bir Ürün Listeleme Uygulaması Geliştirelim
Fresh'in gücünü ve Ada Mimarisi'nin avantajlarını daha iyi anlamak için, gerçek dünyadan bir senaryo üzerinde duralım: basit bir e-ticaret ürün listeleme uygulaması. Bu tür bir uygulamada, ürünlerin hızlı yüklenmesi, kullanıcıların ürünler arasında gezinirken sorunsuz bir deneyim yaşaması ve gerektiğinde filtreleme veya sepete ekleme gibi etkileşimli özelliklerin performanslı çalışması büyük önem taşır. Fresh, bu ihtiyaçları karşılamak için ideal bir mimari sunar.
Senaryo: Bir e-ticaret web sitesinde, ürünlerin listelendiği bir kategori sayfası hayal edin. Bu sayfada ürün resimleri, adları, fiyatları gösterilecek ve kullanıcılar ürünleri filtreleyebilecek, sıralayabilecek ve her ürünün yanındaki bir butona tıklayarak sepete ekleyebilecektir.
Fresh ile Yaklaşım:
- SSR ile Hızlı İlk Yükleme: Ürün listeleme sayfasının (örneğin
/products) ilk yüklemesi sunucu tarafında yapılır. Bu, sayfanın HTML'inin tarayıcıya hızla gönderilmesi ve kullanıcıların içeriği anında görmesini sağlar. SEO için de bu çok önemlidir, çünkü arama motoru botları tüm ürün bilgilerini doğrudan HTML içinde bulabilir. - API Uç Noktası ile Veri Sağlama: Ürün verileri, Fresh'in kendi içinde oluşturduğumuz bir API uç noktasından (örneğin
/api/products.ts) sağlanır. Bu uç nokta, bir veritabanından veya harici bir servisten ürünleri JSON formatında döndürebilir. - Ada Mimarisi ile Etkileşim:
- Filtreleme ve Sıralama: Bu özellikler için bir "ada" (
islands/ProductFilters.tsx) oluşturulabilir. Kullanıcı filtreleri değiştirdiğinde veya ürünleri sıraladığında, sadece bu adanın JavaScript'i çalışır ve AJAX isteğiyle yeni ürün listesini API'den çekerek sayfayı günceller. Sayfanın geri kalan kısmı (statik başlıklar, footer vb.) yeniden işlenmez. - Sepete Ekle Butonu: Her ürün kartının üzerindeki "Sepete Ekle" butonu için ayrı bir "ada" (
islands/AddToCartButton.tsx) veya tüm ürün kartlarını içeren tek bir ada kullanılabilir. Bu butona tıklandığında, sadece ilgili ürünün sepete eklenme mantığı çalışır, tüm sayfanın yeniden yüklenmesi veya hidrasyonu gerekmez.
- Filtreleme ve Sıralama: Bu özellikler için bir "ada" (
Örnek Yapı ve Kod Parçacıkları:
1. API Uç Noktası (routes/api/products.ts):
// routes/api/products.ts
import { Handlers } from "$fresh/server.ts";
interface Product {
id: string;
name: string;
price: number;
category: string;
image: string;
}
const products: Product[] = [
{ id: "p1", name: "Akıllı Telefon X", price: 12000, category: "Elektronik", image: "/images/phone.jpg" },
{ id: "p2", name: "Laptop Pro", price: 25000, category: "Elektronik", image: "/images/laptop.jpg" },
{ id: "p3", name: "Tasarımlı Koltuk", price: 8000, category: "Mobilya", image: "/images/chair.jpg" },
{ id: "p4", name: "Kablosuz Kulaklık", price: 1500, category: "Elektronik", image: "/images/headphones.jpg" },
];
export const handler: Handlers = {
GET(req) {
const url = new URL(req.url);
const categoryFilter = url.searchParams.get("category");
let filteredProducts = products;
if (categoryFilter) {
filteredProducts = products.filter(p => p.category === categoryFilter);
}
return new Response(JSON.stringify(filteredProducts), {
headers: { "content-type": "application/json" },
});
},
};
2. Ürün Listeleme Sayfası (routes/products.tsx):
// routes/products.tsx
import { Handlers, PageProps } from "$fresh/server.ts";
import ProductFilters from "../islands/ProductFilters.tsx"; // Filtre adası
import AddToCartButton from "../islands/AddToCartButton.tsx"; // Sepete ekle adası
interface Product {
id: string;
name: string;
price: number;
category: string;
image: string;
}
interface Data {
products: Product[];
categoryFilter?: string;
}
export const handler: Handlers = {
async GET(req, ctx) {
const url = new URL(req.url);
const categoryFilter = url.searchParams.get("category") || undefined;
// API'den ürünleri çek
const productsRes = await fetch(${url.origin}/api/products${categoryFilter ??category=${categoryFilter}: ''});
const products: Product[] = await productsRes.json();
return ctx.render({ products, categoryFilter });
},
};
export default function ProductListPage({ data }: PageProps) {
const { products, categoryFilter } = data;
return (
Ürün Listesi
Ürünler
{/* Ada bileşeni */}
{products.map((product) => (
{product.name}
Fiyat: {product.price} TL
{/* Ada bileşeni */}
))}
);
}
3. Filtreleme Adası (islands/ProductFilters.tsx):
// islands/ProductFilters.tsx
import { FunctionalComponent } from "preact";
import { useState } from "preact/hooks";
interface ProductFiltersProps {
initialCategory?: string;
}
const ProductFilters: FunctionalComponent = ({ initialCategory }) => {
const [selectedCategory, setSelectedCategory] = useState(initialCategory || "");
const handleCategoryChange = (e: Event) => {
const category = (e.target as HTMLSelectElement).value;
setSelectedCategory(category);
// URL'yi değiştir ve sayfayı yeniden yükle (Fresh SSR yeniden render eder)
window.location.href = category ? /products?category=${category} : "/products";
};
return (
);
};
export default ProductFilters;
4. Sepete Ekle Butonu Adası (islands/AddToCartButton.tsx):
// islands/AddToCartButton.tsx
import { FunctionalComponent } from "preact";
interface AddToCartButtonProps {
productId: string;
}
const AddToCartButton: FunctionalComponent = ({ productId }) => {
const handleAddToCart = () => {
alert(${productId} ID'li ürün sepete eklendi! (Gerçek bir uygulamada API çağrısı yapılır));
// Gerçek bir uygulamada burada bir API çağrısı ile ürün sepete eklenir
};
return (
);
};
export default AddToCartButton;
Bu senaryoda, ProductListPage sunucu tarafında işlenerek hızlı bir ilk yükleme sağlar. ProductFilters ve AddToCartButton ise islands/ dizininde tanımlandıkları için, sadece kullanıcı onlarla etkileşime girdiğinde istemci tarafında çalışacak küçük JavaScript parçacıklarıdır. Bu sayede, tarayıcıya gereksiz JavaScript yüklenmez ve sayfa genel performansı maksimize edilir. Özellikle geniş ürün listelerine sahip e-ticaret siteleri için bu yaklaşım, hem kullanıcı deneyimi hem de operasyonel maliyetler açısından önemli avantajlar sunar.
Fresh Geliştirirken Bilmeniz Gereken İpuçları ve En İyi Uygulamalar Nelerdir?
Fresh ile geliştirme yaparken, projenizin verimliliğini ve performansını artırmak için bilmeniz gereken bazı önemli ipuçları ve en iyi uygulamalar bulunmaktadır. Bu bilgiler, hem yeni başlayanlar hem de deneyimli geliştiriciler için Fresh deneyimini daha sorunsuz ve güçlü hale getirecektir.
- Deno Deploy ile Kolay Dağıtım:
Fresh, Deno Deploy ile kusursuz bir entegrasyona sahiptir. Deno Deploy, Deno uygulamalarını Edge üzerinde, yani kullanıcılara en yakın sunucularda çalıştırmak için tasarlanmış global bir ağdır. Bu, uygulamanızın dağıtımını inanılmaz derecede basitleştirir ve performansı artırır. GitHub entegrasyonu sayesinde, bir repo'yu bağlayarak her
pushişleminde uygulamanızın otomatik olarak dağıtılmasını sağlayabilirsiniz. Sadece birkaç tıklamayla dakikalar içinde uygulamanızı canlıya alabilirsiniz. Bu entegrasyon, geliştiricilere büyük zaman kazandırır ve operasyonel karmaşıklığı ortadan kaldırır. - CSS ve Stil Yönetimi:
Fresh, stil yönetimi konusunda size tam esneklik sunar. Geleneksel CSS dosyalarını
static/dizinine yerleştirip HTML'inizdenetiketiyle bağlayabilir veya doğrudan bileşenleriniz içinde inline stiller veya CSS-in-JS yaklaşımları kullanabilirsiniz. Daha modern bir yaklaşım için, TailwindCSS gibi utility-first CSS framework'lerini entegre etmek de oldukça popülerdir._app.tsxdosyası, tüm uygulamanıza uygulanacak global stilleri veya ana layout'u tanımlamak için ideal bir yerdir. Ayrıca, Preact'ınstyleprop'u ile dinamik stiller de uygulayabilirsiniz. Örneğin:// _app.tsx import { AppProps } from "$fresh/server.ts"; export default function App({ Component }: AppProps) { return (My Fresh App {/* Global CSS dosyanız */}); } // static/style.css body { margin: 0; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Open Sans", "Helvetica Neue", sans-serif; color: #333; } /* Diğer global stilleriniz */ - State Yönetimi:
Preact'ın doğal yetenekleri sayesinde
useState,useReducer,useEffectgibi Hook'lar Fresh adaları içinde sorunsuz bir şekilde çalışır. Daha karmaşık global state yönetimi senaryoları için, Preact'ın Signals kütüphanesi Fresh ile harika bir uyum içindedir. Signals, reaktif programlama prensiplerini kullanarak state yönetimini basitleştirir ve performansı optimize eder. Küçük ve orta ölçekli uygulamalar için Preact'ın yerleşik hook'ları yeterli olurken, büyük ölçekli uygulamalarda Signals, daha temiz ve ölçeklenebilir bir çözüm sunabilir.Uzman İpucu: Signals, Fresh ile entegre bir şekilde çalışır ve state değişikliklerini otomatik olarak algılar. Bu, manuel optimizasyonlara gerek kalmadan bileşenlerinizi performanslı hale getirmenin etkili bir yoludur. - Test Etme:
Deno, yerleşik bir test runner'a sahiptir ve Fresh uygulamalarınızı test etmek için bunu kullanabilirsiniz.
Deno.testAPI'si ile hem sunucu tarafı kodunuzu (API rotaları, veri işleme) hem de adalarınızın temel mantığını test edebilirsiniz. UI testleri için Puppeteer veya Playwright gibi araçları Deno ile birlikte kullanabilirsiniz, ancak Fresh'in temel prensibi olan "sadece gerektiğinde JS" yaklaşımı sayesinde, genellikle daha az UI testi yazmanız yeterli olur.// tests/api_test.ts import { assertExists } from "https://deno.land/std@0.207.0/assert/mod.ts"; import { handler } from "../routes/api/products.ts"; // API handler'ınızı içe aktarın Deno.test("API returns products", async () => { const req = new Request("http://localhost/api/products", { method: "GET" }); const resp = await handler.GET(req, { params: {}, url: new URL("http://localhost/api/products"), remoteAddr: { hostname: "127.0.0.1", port: 80, transport: "tcp" }, render: () => { throw new Error("render should not be called"); }, state: {}, }); const products = await resp.json(); assertExists(products); // Daha fazla assert ifadesiyle ürün yapısını kontrol edebilirsiniz. }); - Mobil Uyumluluk ve
media queryKullanımı:Modern web uygulamaları her zaman mobil cihazlarda da harika görünmelidir. Fresh, HTML ve CSS ile çalıştığı için mobil uyumlu tasarım (responsive design) ilkelerini uygulamak oldukça kolaydır.
viewportmeta etiketi, mobil tarayıcıların sayfanızı doğru bir şekilde ölçeklendirmesi için HTML'inizinbölümüne eklenmelidir. CSSmedia query'ler kullanarak ekran boyutuna göre stilleri ayarlayabilirsiniz. İşte bir CSSmedia queryörneği:/* static/style.css veya _app.tsx içindeki stil bloğu */ body { font-size: 16px; } @media (max-width: 768px) { body { font-size: 14px; /* Mobil cihazlarda daha küçük font boyutu */ } .product-grid { grid-template-columns: 1fr; /* Mobil cihazlarda tek sütun */ } } @media (max-width: 480px) { .product-card { padding: 10px; } }Bu CSS kuralları, tarayıcının genişliğine göre farklı stillerin uygulanmasını sağlar.
_app.tsxdosyasında bu CSS'i bir