@@ -2,14 +2,20 @@ name: Deploy Equinox to GitHub Pages
 
 on:
   push:
-    branches: [ main ]
+    branches: [main]
   workflow_dispatch:
 
 permissions:
   contents: read
   pages: write
   id-token: write
 
+# Aynı anda tek yayın: art arda gelen push'lar kuyruğa girsin, biri
+# diğerinin ortasında devreye girmesin.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
 jobs:
   build:
     runs-on: ubuntu-latest
@@ -18,8 +24,6 @@ jobs:
         uses: actions/checkout@v6
       - name: Install, build, and upload site
         uses: withastro/action@v6
-        env:
-          PUBLIC_SITE_URL: https://equinox.sametbasbug.dev
         with:
           node-version: 24
 
 
@@ -1,18 +1,23 @@
-# dependencies
-node_modules/
-
-# build output
+# derlenen çıktı
 dist/
 .astro/
 
-# system
+# bağımlılıklar
+node_modules/
+
+# ortam
+.env
+.env.production
+
+# Claude Code yerel dosyaları (makineye özel)
+.claude/
+
+# işletim sistemi
 .DS_Store
+Thumbs.db
 
-# logs
+# günlükler
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 pnpm-debug.log*
-
-# Claude Code yerel dosyaları (makineye özel)
-.claude/
 
@@ -0,0 +1,103 @@
+# equinox.sametbasbug.dev
+
+Astro 7 + Tailwind 4 ile kurulmuş tek sayfalık kapı. Ekosistemdeki altı
+alanı, kadroyu ve sosyal hesapları listeler. Kullanıcıya dönük her metin
+Türkçedir.
+
+```bash
+npm run dev       # http://localhost:4321
+npm run build     # fontları budar, sonra dist/ üretir
+npm run fonts     # yalnızca font alt kümelerini yeniler
+npm run icons     # favicon.svg'den PNG türevleri + manifest
+npm run og        # public/og.png (paylaşım kartı)
+```
+
+## Yayın
+
+`main`'e push → GitHub Actions (`withastro/action@v6`, Node 24) → GitHub
+Pages → equinox.sametbasbug.dev. Alan adı `public/CNAME` ile bağlı; o
+dosya silinirse özel alan adı düşer.
+
+## Değiştirirken dikkat
+
+**Bütün içerik `src/data/equinox.ts`te.** Kapı sayısı, kadro sayısı,
+yörüngedeki düğüm yerleşimi ve metindeki "Altı kapı" ifadesi hep oradan
+türer. Yeni bir alan eklenince yerleşim kendini kurar — sayıyı elle
+yazan hiçbir yer yok.
+
+**Sayfanın kalbi konsol: şema seçer, panel gösterir.** Yörüngedeki
+düğümler bağlantı değil sekme (`role="tab"`), paneller `role="tabpanel"`;
+siteye götüren bağlantı panelin içindeki `.panel__go`. Aynı `data-gate`
+değerini taşıyan üç öğe — düğüm, çekirdekten çıkan SVG kolu ve panel —
+birlikte `is-current` alır (`src/pages/index.astro` sonundaki betik).
+Yeni bir işaretli öğe eklerken aynı değeri vermek yeterli.
+
+**Altı panelin altısı da HTML'de.** Aynı ızgara gözünde üst üste
+duruyorlar; yükseklik en uzun panele göre sabit, geçişte sayfa
+zıplamıyor. Seçili olmayanlar `visibility: hidden` — yalnızca `opacity`
+kullanılsaydı klavye görünmeyen panelin içindeki bağlantıya girmeye
+devam ederdi. Bağlantılar DOM'da durduğu için tarayıcı da arama motoru
+da altısını görüyor. JavaScript yoksa `<noscript>` bloğu altı paneli
+birden açıp düğümleri gizliyor.
+
+**Masaüstünde üzerine gelmek seçiyor.** Böylece siteye gitmek yine tek
+tık. Dokunmatikte yalnızca tıklama var: `pointerenter` dokunuşla geliyor
+ama `pointerleave` hiç gelmiyor, eşleşme yanık kalıyordu. Klavyede
+sekme grubu tek durak (`tabindex` gezinir), aralarında ok tuşları,
+`Home` ve `End` çalışır.
+
+**Fontlar sayfaya göre budanmış.** Fontsource'un hazır CSS'i üç aile
+için ~310 KB indiriyordu; `scripts/make-fonts.mjs` `src/` altındaki
+metinden karakter kümesi çıkarıp ~120 KB'a düşürüyor. `npm run build`
+bunu her seferinde yeniden üretir. `src/styles/fonts.css`teki
+`unicode-range` değerleri betikteki `isCore()` bölmesiyle **birebir aynı**
+olmalı; çakışırlarsa son tanım kazanır ve diğer dosya hiç indirilmez.
+
+**Fraunces'ta yalnızca `opsz` ekseni var.** Fontsource'ta SOFT ve WONK
+eksenleri sadece `full` kesitinde ve dosyayı ikiye katlıyor. Bu yüzden
+`font-variation-settings` içinde SOFT/WONK **kullanılmaz** — yazılsa da
+sessizce yok sayılır.
+
+**Yeni kart rengi ton açısıyla verilir.** `hue` değeri hem panelin
+vurgusunu hem yörünge düğümünü hem paylaşım kartındaki noktayı besliyor;
+`--accent` oradan hesaplanıyor (`global.css`). Doğrudan hex yazma.
+
+**Kart ve şerit zeminleri `--panel` üzerinden.** `bg-surface-raised/35`
+gibi sabit saydamlıklara dönme; zeminler tek yerden ayarlanabilir kalsın.
+
+**Tek tema var: gece.** Tema anahtarı, gündüz tokenleri, `data-theme`
+ve dairesel geçiş silmesi kaldırıldı — sayfa tek atmosfere göre kuruldu
+ve gündüzde aynı etkiyi vermiyordu. Token adları ana blogla ortak
+kaldığı için gündüz gerekirse `:root`un karşısına ikinci bir blok olarak
+geri gelebilir, ama bugün öyle bir dal yok: `data-theme` okuyan kod
+yazma.
+
+## Bilinen tuzaklar
+
+- **`.reveal` blokları IntersectionObserver'a bağlı**; tarayıcı sekmesi
+  arka plandayken hiç tetiklenmez. Otomatik denetimde "her şey görünmez"
+  görürsen önce `document.hidden` değerine bak.
+- **Sistem renk tercihine bakılmaz.** `prefers-color-scheme` sorgusu yok;
+  `color-scheme: dark` sabit. Gündüz bekleyen bir denetim aracı sayfayı
+  yanlış raporlar.
+- **`public/fonts/` ve `public/og.png` depoya işlenir.** Fontlar build'de
+  yeniden üretiliyor ama `astro dev` betiği çalıştırmıyor; dosyalar
+  olmazsa geliştirmede yazı tipi düşer.
+- **satori budanmış değişken fontu okuyamıyor.** `make-og.mjs` eksenleri
+  sabitleyerek (`variationAxes`) düz bir kesit çıkarıyor; o parametre
+  kaldırılırsa betik `fvar` tablosunda patlar.
+
+## Yapı
+
+| Yol | Ne |
+| --- | --- |
+| `src/data/equinox.ts` | Site kimliği, kapılar, kadro, sosyal hesaplar — tek kaynak |
+| `src/data/icons.ts` | 24×24 ikon yolları |
+| `src/components/OrbitMap.astro` | Konsolun seçicisi; düğümler HTML sekme, halkalar SVG |
+| `src/components/GatePanel.astro` | Seçili alanın paneli; üst üste duran altı panelden biri |
+| `src/styles/global.css` | Tasarım sistemi (ana blogla aynı token seti) |
+| `src/styles/fonts.css` | Budanmış kesitlerin @font-face tanımları |
+| `scripts/` | Font, ikon ve paylaşım kartı üreticileri |
+
+Tasarım kararları ve içerik ekleme için `README.md`. `CLAUDE.md` bu
+dosyaya sembolik bağdır; ikisi tek kaynaktır.
@@ -0,0 +1 @@
+AGENTS.md
@@ -1,41 +1,97 @@
 # Equinox
 
-**Equinox** is the public gateway for Samet Başbuğ’s small web ecosystem: publishing surfaces, experiments, the shared Orbit timeline, and social profiles in one quiet place.
-
-Live site: **https://equinox.sametbasbug.dev**
-
-## What it is
-
-Equinox is intentionally simple. It behaves like a lightweight link hub, but it is owned, static, fast, and shaped around the ecosystem instead of a third-party profile page.
-
-Current destinations:
-
-- **Ana Blog** — long-form posts, notes, and glossary entries
-- **Equinox Haber** — concise news publishing surface
-- **Equinox Orbit** — shared public timeline for Nyx, Hemera, and Asteria
-- **Signal Drift** — narrative survival experiment set inside the Equinox universe
-- **Status** — public status and surface index
-
-Social links currently point to GitHub, X, Instagram, and Moltbook.
-
-## Design notes
-
-The page should stay:
-
-- **Fast first** — no heavy runtime, no unnecessary client JavaScript
-- **Clear first** — site cards for primary destinations, compact chips for social links
-- **Atmospheric second** — Equinox mood in the background, not content bloat
-- **Low maintenance** — static Astro build, GitHub Pages deployment
-
-If a future change makes the page feel like a full portal, it is probably too much. This is a door, not a lobby.
+**Equinox**, Samet Başbuğ'un küçük web ekosisteminin giriş kapısı: yayın
+yüzeyleri, deneyler, ajanların ortak akışı ve sosyal hesaplar tek yerde.
+
+Yayında: **https://equinox.sametbasbug.dev**
+
+## Ne olduğu
+
+Tek sayfa. Bir kimlik bloğu, bir konsol, sosyal bağlantılar ve kadro
+şeridi. Bilerek kısa: burası bir kapı, lobi değil. Sayfanın işi
+ziyaretçiyi üç saniyede doğru alana göndermek.
+
+Kapılar:
+
+- **Ana Blog** — yazılar, notlar, sözlük
+- **Equinox Haber** — haber akışı
+- **Equinox Orbit** — ajanların ortak alanı
+- **Model Atlası** — yapay zekâ modeli karşılaştırma rehberi
+- **Signal Drift** — anlatı temelli hayatta kalma oyunu
+- **Status** — durum panosu
+
+## Tasarım
+
+Ana blogla (`sametbasbug.dev`) aynı tasarım sistemini paylaşır: aynı
+renk tokenleri, aynı üç yazı tipi, aynı gece/gündüz mantığı. İki site
+yan yana konduğunda tek elden çıktığı anlaşılmalı — ama hub kendi
+fikrini taşır.
+
+**Eşik.** Ekinoks, gündüzle gecenin eşit olduğu an. Sayfanın adı bu
+geçişi taşıyor: "Equinox" yazısı kordan tüle uzanan bir gradyanla
+yazılıyor, hemen altından sağa doğru bir ufuk çizgisi çekiliyor.
+
+**Konsol.** Sayfanın kalbi tek bir alet: solda yörünge, sağında panel.
+Yörünge ekosistemin kendisi — ortada Equinox, çevresinde altı alan — ve
+aynı zamanda kumandası. Bir düğüm seçilince yanındaki panel o alanın
+kartına dönüşür: adı, alan adı, tanımı ve rengi. Halkalar döner,
+düğümler durur; hareket eden bir hedefe tıklamak zorunda kalınmasın
+diye. Masaüstünde üzerine gelmek seçmeye yeter, yani siteye gitmek yine
+tek tık. Şema her ekranda var; telefonda küçülüp panelin üstüne oturur
+ve düğümler orada 46 px'lik dokunma hedefleri olur.
+
+Ayrı bir kart ızgarası yok, çünkü altı alanın adı ve ikonu zaten
+yörüngede duruyor — aynı listeyi iki kez göstermenin anlamı yoktu.
+
+**Kapı.** Panelin sol kenarında ince bir ışık şeridi var ve aralıktan
+içeri ışık sızıyor — açılan bir kapı. Rengi seçili alanın ton açısından
+geliyor, yani panel her seçimde baştan renkleniyor.
+
+**Tek durum.** Sitenin teması gece; anahtar yok, sistem tercihine de
+bakılmıyor. Tasarım baştan bu atmosfere göre kuruldu — gradyanlar,
+yıldızlar, ışıyan vurgu renkleri — ve aydınlık bir kesitte aynı etkiyi
+vermiyordu. Bir düzeni iyi yapmak, iki düzeni idare etmekten iyi geldi.
+
+## Hız
+
+Tek sayfa, sıfır çerçeve, sıfır ayrı JavaScript dosyası. Bütün betikler
+HTML'e gömülü ve toplamı 2,9 KB. En ağır kalem yazı tipleri; onlar da
+sayfanın gerçekten kullandığı 127 glife budanmış durumda:
+
+| | önce | sonra |
+| --- | --- | --- |
+| yazı tipleri | ~310 KB | ~120 KB |
+| avatarlar | 216 KB | 20 KB |
+| JavaScript | — | 2,9 KB (gömülü) |
+
+## İçerik eklemek
+
+Her şey `src/data/equinox.ts` içinde. Yeni bir kapı eklemek için
+`gates` dizisine bir kayıt yazmak yeterli:
+
+```ts
+{
+  id: "yeni",
+  title: "Yeni Alan",
+  short: "Yeni",              // yörünge düğümündeki etiket
+  domain: "yeni.sametbasbug.dev",
+  href: "https://yeni.sametbasbug.dev",
+  kind: "Araç",               // panelde başlığın üstündeki tür
+  description: "Tek cümlelik anlatım.",
+  icon: "atlas",              // src/data/icons.ts
+  hue: 190,                   // 0–360 arası ton açısı
+  badge: "yeni",              // isteğe bağlı
+}
+```
 
-## Stack
+Yörüngedeki düğümler eşit aralıkla yeniden dağılır, konsola yeni bir
+panel eklenir, hero'daki "Altı kapı" ifadesi kendini günceller. Elle
+sayı yazan hiçbir yer yok.
 
-- [Astro](https://astro.build/)
-- GitHub Pages
-- Custom domain via [`public/CNAME`](public/CNAME)
+Yeni bir ikon gerekiyorsa `src/data/icons.ts`e 24×24 ızgarada, tek renk
+çizgi olarak eklenir.
 
-## Local development
+## Kurulum
 
 ```bash
 npm install
@@ -44,25 +100,32 @@ npm run build
 npm run preview
 ```
 
-## Deployment
+## Yayın
 
-Deployment is handled by GitHub Actions on pushes to `main`:
+`main`'e push edilince GitHub Actions derleyip GitHub Pages'e atıyor:
 
-- Workflow: [`.github/workflows/deploy.yml`](.github/workflows/deploy.yml)
-- Domain: `equinox.sametbasbug.dev`
-- Output: static site from `astro build`
+- İş akışı: [`.github/workflows/deploy.yml`](.github/workflows/deploy.yml)
+- Alan adı: `public/CNAME`
+- Çıktı: `astro build` → `dist/`
 
-## Project shape
+## Yapı
 
 ```text
-src/pages/index.astro      # main link gateway
-src/pages/404.astro        # custom not-found page
-src/styles/global.css      # complete page styling
-public/CNAME               # custom domain
-public/favicon.svg         # site icon
-public/robots.txt          # crawler hints
+src/data/equinox.ts        # tek veri kaynağı
+src/data/icons.ts          # ikon yolları
+src/layouts/Base.astro     # head, tema, yapısal veri
+src/components/            # Sky, OrbitMap, GatePanel, Icon
+src/pages/index.astro      # sayfanın tamamı
+src/pages/404.astro        # kayıp rota
+src/styles/                # tasarım sistemi ve @font-face tanımları
+scripts/                   # font, ikon ve paylaşım kartı üreticileri
+public/                    # CNAME, ikonlar, fontlar, avatarlar, og.png
 ```
 
-## Maintenance rule
+Mimari notlar ve tuzaklar için [`AGENTS.md`](AGENTS.md).
+
+## Bakım kuralı
 
-Keep Equinox boring in the best way: links should be accurate, layout should stay light, and any new surface should earn its place before being added.
+Equinox'u iyi anlamda sıkıcı tut: bağlantılar doğru olsun, yerleşim
+hafif kalsın, yeni bir yüzey eklenmeden önce yerini hak etsin. Sayfa bir
+portala dönüşmeye başladıysa muhtemelen fazla gelmiştir.
@@ -0,0 +1,13 @@
+// @ts-check
+import { defineConfig } from "astro/config";
+import tailwindcss from "@tailwindcss/vite";
+import sitemap from "@astrojs/sitemap";
+
+export default defineConfig({
+  site: "https://equinox.sametbasbug.dev",
+  devToolbar: { enabled: false },
+  integrations: [sitemap()],
+  vite: {
+    plugins: [tailwindcss()],
+  },
+});