Proje Stack'i

Bu site, Falcon / FixRav kurumsal Astro projesinin (falcon-fixrav) bakım ve geliştirme rehberidir. Kod repoda; içerik sayfaları ve blog yazıları MDX dosyalarıyla aynı repoda düzenlenir — harici CMS paneli yok.

Canlı demo: falcon.fixrav.com — deploy ve ortam ayrıntıları için Production sayfasına bakın.

Mimari Özet

Katman	Ne yapar
BaseLayout	Header, `<main>`, footer, SEO `<head>`, analytics snippet’leri
Config	`site.ts`, `seo.ts`, `routes.ts`, `nav.ts`, `contact.ts`, `analytics.ts`, `animations.ts` — tek kaynak
Fix UI	Görünüm: `fix-*` CSS + `src/components/ui` (buton, kart, yazı rolleri, form parçaları)
Tailwind 4	Layout: header/footer, grid, spacing, responsive
React 19	Yalnızca island: tema, toast, form demo

Sayfa iskeleti ve dosya listesi: Site Layout.

Kullanmıyoruz

Keystatic veya harici CMS — içerik Git + MDX dosyalarında
shadcn / Radix UI — bileşenler Fix UI (fix-*) ile gelir
Blog ve statik sayfalar dosya tabanlıdır; panel yoktur

Stack Tablosu

Ne	Rol	Detay sayfası
Node.js ≥ 22.12	`engines`; build ve dev komutları	Production
Astro 6	Sayfa routing, build, SSR	Cloudflare Deploy
TypeScript	Tip güvenliği; `.ts` / `.tsx`	CSS Kullanımı
Tailwind CSS 4	Layout utility (`@tailwindcss/vite`)	CSS Kullanımı
Fix UI	Görünüm; buton, kart, yazı rolleri	Fix UI Kullanımı
React 19	Island: tema, Sonner, form demo	React Kullanımı
MDX + Content Collections	Blog `src/content/blog/`	MDX Kullanımı Ve Blog URL
i18n (EN, TR, DE, FR)	`routes.ts`, `src/i18n/` — EN önek yok	Çoklu Dil Kullanımı
Cloudflare adapter + Wrangler	`output: server`, deploy	Cloudflare Deploy
`@astrojs/sitemap`	Çok dilli sitemap	Sitemap
Motion	`motion-init.ts`, `data-motion-*` (DOM)	Animasyonlar
Hugeicons, Sonner, Inter	İkon, toast, font	Font & UI Kullanımı
`patch-pages-wrangler.mjs`	Build sonrası Wrangler uyumu	Cloudflare Deploy

SEO, analytics ve layout ayrı rehberlerdedir: SEO / Meta, Analytics, Site Layout.

Başlangıç Rehber Haritası

Teknik katmanlar — sidebar sırasıyla. Her konunun kurulumu ve örnekleri ilgili sayfada.

Proje Stack’i — Bu sayfa; stack özeti ve harita.

CSS Kullanımı — Tailwind 4 ile layout, spacing ve responsive sınıflar.

Fix UI Kullanımı — fix-* bileşenleri ve CSS; buton, kart, form görünümü.

Yazı Stilleri — fix-type ve fix-prose; başlık ve paragraf rolleri.

Font & UI Kullanımı — Inter variable, Hugeicons ve Sonner toast.

React Kullanımı — Island direktifleri; tema ve etkileşimli parçalar.

MDX Kullanımı Ve Blog URL — Content Collections ve blog route yapısı.

Çoklu Dil Kullanımı — Dört dil, URL önekleri ve routes.ts.

Sitemap — @astrojs/sitemap ve hreflang.

SEO / Meta — Title, description, canonical, Open Graph.

Cloudflare Deploy — Adapter, Wrangler ve output: server.

Site Layout — BaseLayout, Header, Footer ve Tailwind vs Fix UI.

Analytics Ve Script’ler — GTM, GA4, Clarity ve analytics.ts.

Production — Canlı site, build çıktısı ve deploy akışı.

Site Yönetimi Rehber Haritası

Günlük içerik ve yapılandırma — CMS olmadan dosya ve config ile.

Sayfa Ekle / Kaldır — Yeni route ve Contact sayfası örneği.

Navigasyon — nav.ts ve menü linkleri.

Çeviri Metinleri — src/i18n/ altında dört dil metinleri.

Site Bilgileri — site.ts, iletişim ve sosyal ayarlar.

Görseller Ve Medya — public/ ve optimize görseller.

Animasyonlar — animations.ts ve data-motion-* kullanımı.

Blog İçeriği — src/content/blog/ MDX yazıları.

Formlar (Demo) — React form island; canlı form entegrasyonu değil.

Önerilen Okuma Sırası (Yeni Site Sahibi)

Site Layout — sayfa iskeleti ve config dosyaları
Fix UI Kullanımı — buton ve kart kullanımı
Sayfa Ekle / Kaldır — yeni sayfa açma
Çeviri Metinleri — menü ve ortak metinler
Site Bilgileri — marka ve iletişim
Blog İçeriği — yazı ekleme
Production — build ve canlıya alma

Geliştirici için ek sıra: CSS Kullanımı → Cloudflare Deploy → SEO / Meta.

Hızlı Komutlar

Falcon kod projesi (falcon-fixrav):

cd falcon-fixrav
npm install
npm run dev
npm run build
npm run deploy

Bu rehber sitesi (astro-docs):

cd astro-docs
npm install
npm run dev

Özet

Stack Falcon projesinde sabittir; günlük iş Site Yönetimi bölümündeki sayfalarla yapılır. Derin teknik ayrıntılar Başlangıç altındaki rehberlerde — bu sayfa yalnızca harita ve yönlendirmedir.