Hızlı Özet: Astro static output iyi bir başlangıçtır; garanti 100/100 değildir. LCP, INP ve CLS lab ve saha verisiyle ölçülmelidir.
Neden “100 skor” vaadi tehlikeli?
robotik yarışmaları tarafında sensör verisini “güzel görünen grafik”e bakarak değil, log ve telemetriyle doğrularız. Web performansında da aynı disiplin geçerli: Lighthouse yeşil çubukları, gerçek kullanıcıların 4G / orta seviye telefonda yaşadığı deneyimi temsil etmeyebilir.
Core Web Vitals üç ana metrik etrafında döner:
- LCP (Largest Contentful Paint): Ana içerik görselinin veya metin bloğunun boyanma süresi.
- INP (Interaction to Next Paint): Tıklama / dokunma sonrası sonraki boyamaya kadar geçen etkileşim gecikmesi.
- CLS (Cumulative Layout Shift): Sayfa yerleşiminin kayması.
“100 al” hedefi, çoğu zaman üçüncü taraf scriptleri kapatılmış, cache’lenmiş, masaüstü lab koşusunda üretilir. Canlı sitede AdSense, analytics veya harita embed’i eklediğiniz anda aynı skor düşer. Bu yazının hedefi: ölçülebilir iyileştirme döngüsü kurmak.
Astro SSG’nin gerçekten verdiği şey
Astro, bileşenleri build sırasında HTML’e çevirir. Islands Architecture sayesinde yalnızca etkileşimli parçalara client:* hidrasyonu verirsiniz. Tipik bir blog veya dokümantasyon sitesinde çoğu sayfa sıfır veya çok az JS ile gider; bu INP açısından avantajdır.
Örnek astro.config.mjs — abartısız, ölçüme açık bir taban:
// astro.config.mjs
import { defineConfig } from 'astro/config';
export default defineConfig({
output: 'static',
compressHTML: true,
build: {
// Küçük sitelerde kritik CSS'i HTML içine alır; büyüyen CSS'te 'auto' deneyin
inlineStylesheets: 'auto',
},
prefetch: {
prefetchAll: false,
defaultStrategy: 'hover',
},
vite: {
build: {
cssCodeSplit: true,
},
},
});
prefetchAll: true her linki önden çekmeye çalışır; mobil veride gereksiz bant genişliği yakar. Hover / viewport stratejisi çoğu içerik sitesinde daha dengelidir.
Ölçüm düzeni: lab → saha → tek metrik
ROS 2’de bir düğümü “hızlı” diye övmek yerine ros2 topic hz ile frekans bakarsınız. Web’de de sıra şöyle olmalı:
- Yerel lab:
npx lighthouse https://localhost:4321 --viewveya Chrome DevTools Performance. - Deploy sonrası lab: PageSpeed Insights’ta mobil + masaüstü, aynı URL.
- Saha (field): CrUX verisi birikene kadar “geçici lab skoru” diye etiketleyin; 28 günlük saha verisi olmadan SEO iddiası yapmayın.
Kaydettiğim pratik eşikler (hedef, garanti değil):
| Metrik | İyi (yaklaşık) | Astro’da sık kırılma noktası |
|---|---|---|
| LCP | < 2.5 s | Büyük hero görseli, font-display, yavaş CDN |
| INP | < 200 ms | Ağır client island, senkron third-party |
| CLS | < 0.1 | width/height’siz img, geç yüklenen reklam |
Tek seferde üç metriği “yeşile çevirmeye” çalışmayın. Bir sprint’te yalnızca LCP elementi; sonraki sprint’te CLS.
LCP: görsel ve font bütçesi
LCP çoğu içerik sitesinde ya hero görseli ya da H1 + üst paragraf bloğudur. Astro’da Image bileşeni veya astro:assets ile boyut bilinen görseller üretmek LCP’yi doğrudan etkiler.
---
import { Image } from 'astro:assets';
import hero from '../assets/hero-usv.webp';
---
<Image
src={hero}
alt="USV test platformu iskele kenarında"
widths={[640, 960, 1280]}
sizes="(max-width: 768px) 100vw, 960px"
format="webp"
loading="eager"
fetchpriority="high"
class="hero-img"
/>
Dikkat edilecekler:
- Hero’da
loading="lazy"kullanmayın; LCP adayı eager + yüksek öncelik ister. width/height(veya aspect-ratio) CLS’yi de korur.- WebP/AVIF dönüşümü build zamanında yapılmalı; tarayıcıya 4 MB PNG bırakmayın.
- Font için
font-display: swapve mümkünse 1–2 aile; her ağırlık ayrı bir ağ isteğidir.
Kendi ölçüm notlarımda, hero’yu 1800px PNG’den 960px WebP’ye indirmek LCP’yi labda ~800–1200 ms iyileştirdi. Bu rakam sizin CDN ve cihazınıza göre değişir; kopyalayıp “bizde de böyle” demeyin, ölçün.
INP: island bütçesi ve third-party
Astro’nun gücü, React/Vue/Svelte’i tüm sayfaya yaymamaktır. Etkileşimli arama kutusu, mobil menü veya grafik için island açın; makale gövdesini hidrate etmeyin.
---
import SearchPanel from '../components/SearchPanel.tsx';
---
<article>...</article>
<SearchPanel client:visible />
client:load her şey için varsayılan olmamalı. client:visible veya client:idle çoğu UI parçası için yeterlidir.
Third-party (analytics, reklam, chat) INP’nin sessiz katilidir. Mümkünse:
- Script’leri
defer/ Astrois:inlineile kritik yolun dışına alın. - Consent sonrası yükleyin.
- Lab testinde “third-party kapalı” ve “açık” iki koşu yapıp farkı kaydedin.
CLS: rezervasyon disiplini
CLS çoğu zaman “tasarım hatası” değil, boyut rezervasyonu eksikliğidir.
.hero-img {
width: 100%;
height: auto;
aspect-ratio: 16 / 9;
display: block;
}
.ad-slot {
min-height: 280px; /* reklam yüksekliği bilinmiyorsa rezerv */
}
Dinamik içerik (cookie banner, üst bildirim çubuğu) layout’u itiyorsa sabitleyin veya overlay kullanın; belge akışını sonradan şişirmeyin.
Cache ve CDN: Astro çıktısıyla uyum
Statik build dist/ üretir. Cloudflare Pages, Netlify veya Nginx ile sunarken uzun cache + içerik hash’i klasik kalıptır:
location /_astro/ {
add_header Cache-Control "public, max-age=31536000, immutable";
}
location / {
add_header Cache-Control "public, max-age=0, must-revalidate";
try_files $uri $uri/ /index.html =404;
}
HTML’i uzun süre cache’lemek yeni yazıyı geciktirir; hash’li asset’ler ise güvenle immutable olabilir. Yanlış cache politikası “performans sorunu” gibi görünen stale içerik üretir.
Küçük bir ölçüm rutini (öğrenci / yan proje ölçeği)
Haftada bir, 15 dakika:
- Canlı ana sayfa + en çok okunan makale URL’sini PageSpeed Insights’a atın.
- LCP elementini not edin (img mi, text mi?).
- Tek değişiklik yapın (görsel boyutu, font, bir island’ı
client:visibleyapma). - Aynı URL’yi tekrar ölçün; sonucu bir satır markdown log’a yazın.
Bu, ROS bag kaydı tutmaya benzer: tek seferlik “hehe 98 aldık” değil, zaman serisi.
Ne zaman Astro SSG yetmez?
- Kullanıcıya özel dashboard, auth arkası canlı veri → hybrid / server output veya ayrı bir app.
- Gerçek zamanlı telemetri paneli → Astro marketing sitesi + ayrı SPA/websocket servisi daha temiz ayrılır.
- Ağır istemci state → island sayısı artınca Astro’nun avantajı erir; o noktada framework seçimini yeniden değerlendirin.
SSG’yi “her şeye çekiç” yapmayın. Statik içerik + seyrek etkileşim için mükemmel; otonom araç yer istasyonu UI’sı için genelde değil.
Kapanış
Astro SSG, Core Web Vitals için maliyet/performans oranı yüksek bir zemin sunar: az JS, önceden üretilmiş HTML, kontrollü hidrasyon. Ama skor; görsel bütçesi, font, cache, third-party ve saha cihaz dağılımının ürünüdür. “100 garantili rehber” arıyorsanız bu yazı size göre değil. Ölçüp tek tek düzelten bir süreç arıyorsanız, yukarıdaki döngü yeterli başlangıçtır — gerisini sizin URL’niz ve CrUX eğriniz söyler.
📌 Sıradaki İlgili Rehber: Cloudflare Pages ile Ücretsiz ve Işık Hızında Web Sitesi Yayınlama
100 PageSpeed alan sitenizi global CDN ağına tek tıkla dağıtın.