Opus Growth hosting sunucumdaki
[sunucu adı] sitesine,
[stüdyo adı] için Webflow'daki etkileşimli ajans sitelerinin hissini veren ama Webflow kullanmayan, statik ve hızlı bir portföy sitesi kur. Stüdyo:
[ne yapıyor, kime], şehir ve semt:
[şehir, semt]. Hizmetler:
[3 hizmet]. Projeler: [her biri için ad, iş türü, yıl, bir cümle sorun, bir cümle çözüm, görsel bağlantısı]. İletişim:
[e-posta],
[telefon],
[WhatsApp numarası],
[adres]. Alan adı:
[alan adı].
Sayfalar: ana sayfa (hero, seçili işler dizini, ne yapıyoruz, süreç, SSS, kapanış çağrısı), işler (/isler/: galeri ve her proje için sorun, yapılan iş ve teslim notu), stüdyo (/hakkimizda/), iletişim (/iletisim/, form yok; e-posta, hazır mesajlı WhatsApp ve telefon), gizlilik (/gizlilik/) ve 404.html. Proje sonuçları için müşteriden onaylı veri yoksa yüzde ya da artış rakamı yazma, sonucu nitel anlat.
Tarz: brutalist-modern. Keskin köşeler, görünür 1 piksellik ızgara çizgileri, büyük harfli kalın bir grotesk display (ör. Clash Grotesk) ve sakin bir gövde (ör. Supreme), tek flüoresan aksan yalnız zemin olarak ve üstünde siyah metinle. Hover durumları renk ve zemin değişimiyle, odak halkası kalın ve her zeminde görünür.
Etkileşim kuralları (Webflow IX2 hissi, kütüphanesiz):
1. GSAP ve Lenis YÜKLENMEZ. Etkileşimleri tek ve küçük bir vanilla JS dosyasıyla (IntersectionObserver ve requestAnimationFrame) yaz ve defer ile yalnız ana sayfada ve işler sayfasında yükle. Diğer sayfalarda betik olmasın.
2. İmza öğesi "Seçili işler" dizini: her satır projeye giden gerçek bir bağlantı olsun ve önizleme görselinin yolunu data-img niteliğinde taşısın. Varsayılan durumda (JS yok ya da dokunmatik) her satırda küçük görsel akış içinde görünsün. JS yalnız `(hover: hover) and (pointer: fine)` eşleşen ve hareket azaltmayı istemeyen cihazda `<html>`'e cursor-fx sınıfı eklesin, satır içi görselleri gizlesin ve imleci izleyen tek bir önizleme kutusu göstersin. Kutunun konumunu left ve top ile değil, CSS değişkenleriyle transform: translate3d olarak güncelle ve imleç durunca requestAnimationFrame döngüsünü kapat. Klavye odağında aynı önizleme satırın yanında sabit açılsın, odak gidince kapansın.
3. Özel imleç halkası yalnız aynı koşulda eklensin; yerel imleç gizlenmesin, halka aria-hidden olsun ve bağlantı üstünde büyüsün.
4. Bölüm geçişi: bölüm başlıkları kaydırınca clip-path ile soldan sağa açılsın. Gizli başlangıcı JS yalnız sayfa açıldığında ekranın altında kalan başlıklara versin, ilk ekrandaki içerik hiç gizlenmesin. Bu niteliğin adı data-reveal olsun; design-check hareketi bu adla tanır, başka adla "hiç hareket yok" uyarısı verir.
5. Swiper galerisi yalnız işler sayfasında. Galeri HTML'i JS olmadan CSS scroll-snap ile yatay kaydırılan bir şerit olsun; ileri ve geri düğmeleri Swiper başlayana kadar gizli kalsın. Swiper 14 paketinin js ve css dosyalarını site_fetch ile `assets/vendor/` altına indir. Paketi galeriye fare gelince, dokunulunca, odaklanınca ya da sayfa ilk kez kaydırılınca yükle. Demoda galeri ekrana yaklaşınca yüklendiğinde 150 KB'lık paket mobil LCP'yi 3 saniyeye itti (performans 94); ilk etkileşimde yüklemek 99 verdi. Navigation, Keyboard ve A11y modüllerini Türkçe mesajlarla aç; reduced-motion'da geçiş hızı 0 olsun.
6. Slaytları ul ve li yerine div ile kur. Swiper slaytlara role="group" veriyor; li üzerinde bu rol aria-allowed-role ve list hatası verdi ve erişilebilirlik 96'ya düştü.
Kurulum ve bilinen tuzaklar (demo ölçümünde her biri puanı düşürdü, atlama):
1. Sunucuda yayında bir site varsa önce bana söyle, çünkü kurulum index.html ve assets klasörünü ezer. scaffold_site'ı önce confirm=false ile önizle, onayımla confirm=true çağır. Sonra site_design_guide ve site_seo_guide'ı oku. Koda başlamadan tasarım yönünü (tipografi, renk, ızgara, imza öğesi, hareket dili ve YÜKLENMEYECEK kütüphaneler) assets dışında kısa bir ART.md dosyasına yaz ve bana göster.
2. Tailwind'i derle, CDN'den yükleme. site_run_command ile background=true vererek `npm i -D tailwindcss@3` kur ve sonucu site_command_status ile izle. `tailwind.config.js` içindeki content yolları bütün HTML dosyalarını, şablonları ve sınıf yazan JS dosyalarını kapsasın. `_src/tw.css` dosyası `@import "../assets/app.css";` satırı ve üç `@tailwind` satırından oluşsun; `npx tailwindcss -c tailwind.config.js -i _src/tw.css -o assets/site.css --minify` ile tek dosyaya derle. Sayfalardan cdn.tailwindcss.com betiğini ve satır içi tailwind.config'i kaldır, yalnız `/assets/site.css` bağla. Her HTML değişikliğinden sonra yeniden derle.
3. Fontları kendi sunucunda barındır. Seçtiğin Fontshare ailelerinin CSS'ini oku, her ağırlığın woff2 dosyasını site_fetch ile `assets/fonts/` altına indir ve @font-face kurallarını `font-display: swap` ile `assets/app.css` içine yaz; design-check özgün fontu orada arar. İndirdiğin CSS'teki font-family adını kontrol et, çünkü Fontshare olmayan bir ağırlık istendiğinde başka bir aile döndürebiliyor. İlk ekrandaki başlığın fontunu ve gövde fontunu her sayfada `<link rel="preload" as="font" type="font/woff2" crossorigin>` ile önceden yükle; demoda bu adım yazı tipi değişiminden doğan kaymayı (CLS 0,024) sıfırladı. Fontshare fontlarının çoğunda ₺ işareti yok, fiyat yazacaksan "TL" kullan.
4. Menüyü ve alt bilgiyi statik HTML yap. chrome.js ve site.config.js'i sayfalara yükleme. site.config.js'teki nav listesini okuyup `_src/header.tpl` ve `_src/footer.tpl` şablonlarını her sayfadaki `<!-- nav:start --><!-- nav:end -->` ve `<!-- footer:start --><!-- footer:end -->` işaretlerinin arasına basan küçük bir `chrome-stamp.mjs` yaz; etkin sayfanın bağlantısına aria-current="page" eklesin. Şablon dosyalarının uzantısı .html olmasın ve içlerinde `{{...}}` yerine `
[[NAV]]` gibi yer tutucu kullan, yoksa design-check ve seo-check onları yarım kalmış sayfa sanar. Mobil menüyü JS'siz `<details>` ile kur. Alt bilgide işletme adı, adres ve telefon düz metin olarak dursun.
5. Görselleri site_fetch ile indirirken dönüştür: aynı fotoğrafı resize="480x", "800x" ve "1200x", image_format="webp", quality=65 ile ayrı dosyalara yaz. Her `<img>` için srcset, sizes, width ve height ver. İlk ekrandaki ana görsel fetchpriority="high" olsun ve lazy olmasın; diğerleri loading="lazy" decoding="async" olsun. Mobilde ana görsel ekranı dolduruyorsa `<picture>` ile mobile daha yatay ve küçük bir kırpım ver (demoda mobil görsel 89 KB'tan 43 KB'a indi).
6. Logodan site_fetch ile 48 piksellik PNG favicon üret ve her sayfaya `<link rel="icon">` ekle. Favicon yoksa tarayıcı konsola 404 yazar ve En İyi Uygulamalar puanı 96'ya düşer.
7. HTML doğrulayıcısının kuralları: belge büyük harfli `<!DOCTYPE html>` ile başlasın (kitin başlangıç dosyaları küçük harfle başlıyor), tel: bağlantılarının görünen metnindeki boşluklar ` ` olsun, style="" niteliği kullanma, her düğmeye type="button" yaz.
SEO, AEO ve GEO:
1. Adresleri dizin biçiminde ve sonu eğik çizgili kur (/isler/, /hakkimizda/, /iletisim/, /gizlilik/). site.config.js'in seo bloğunu doldur ve `node seo-stamp.mjs` çalıştır. Sayfaya özel şemayı (ana sayfa WebPage ve FAQPage; işler CollectionPage ve her proje için hasPart içinde CreativeWork; stüdyo AboutPage; iletişim ContactPage; iç sayfalarda BreadcrumbList. Fiziksel ofisi olan bir stüdyo için businessType ProfessionalService) ayrı `<script type="application/ld+json">` bloklarına yaz ve @id ile temel grafiğe bağla. BreadcrumbList'i @graph içine gömme, kendi bloğunda dursun; seo-check onu yalnız böyle görür.
2. Title 48 ile 60 karakter olsun (seo-check 65'i aşanı hata sayar), description 145 ile 158 karakter, her sayfada tek h1. Her sayfanın ana içeriği en az 150 kelime olsun; iletişim ve gizlilik sayfaları bu sınırın altında kalmaya yatkın.
3. Her sayfanın ilk paragrafı sayfanın sorusuna doğrudan cevap versin. Sayfaya özgü SSS'yi `<details>` ile yaz ve FAQPage olarak işaretle. Yayımlayan kurumu ve "Son güncelleme" tarihini `<time>` ile göster.
4. robots.txt'te GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-User, Claude-SearchBot, PerplexityBot, Perplexity-User, Google-Extended, Applebot-Extended, Bingbot ve CCBot için kararını gerekçesiyle yaz ve sitemap'i göster. sitemap.xml'de gerçek lastmod olsun. llms.txt'te sitenin iki cümlelik doğru özeti ve önemli sayfaların listesi bulunsun.
5. Uydurma yok: bana sormadan yorum, puan, ödül, müşteri sayısı, sertifika, çalışma saati, koordinat ya da fiyat yazma. Bilmediğin alanı şemaya hiç koyma.
Kapılar (sırayla; hepsi geçmeden "bitti" deme):
1. site_run_command ile `node chrome-stamp.mjs`, Tailwind derlemesi, `node seo-stamp.mjs`, `node seo-check.mjs` (0 hata, 0 uyarı), `node design-check.mjs` (0 hata; kalan uyarıyı gerekçesiyle yaz) ve `npx html-validate "**/*.html"` (0 hata).
2. Her sayfayı site_preview ile view="mobile" ve view="desktop" olarak gör. site_preview sayfayı hareket kapalıyken (reduced-motion) çeker; bu görüntüde içerik eksiksiz görünmüyorsa hareketsiz hal bozuk demektir. Tam sayfa görüntüsünde aşağıdaki lazy görseller boş çıkabilir; bunu hata sayma ama yolunu kontrol et.
3. Her sayfa için core_web_vitals'ı strategy="mobile" ve strategy="desktop" ile çalıştır. Kabul: mobilde Performance en az 95, Accessibility, Best Practices ve SEO 100; masaüstünde dördü de en az 95. Tutmayan sayfada resources=true ile hangi dosyanın geciktirdiğini bul, düzelt ve yeniden ölç. Ardından ana sayfada seo_audit'i strategy="mobile" ve runs=2 ile çalıştır. Ağ istekleri listesinde kendi alan adın dışında bir adres kalmamalı.
4. 360, 390, 768 ve 1440 piksel genişlikte yatay kaydırma olmasın, dokunma hedefleri en az 44 piksel olsun, konsolda hata olmasın.
Etkileşim kontrolü: site_preview hover ve imleç efektini gösteremez. Bana masaüstü tarayıcıda dizin satırlarının üstüne gelince önizlemenin imleci izlediğini, Tab ile gezerken önizlemenin satırın yanında açıldığını, telefonda satır içi görsellerin göründüğünü ve galerinin parmakla kaydığını nasıl kontrol edeceğimi yaz.
Yayından sonra: site_headers ile `/assets/* Cache-Control: public, max-age=31536000, immutable` kuralını önizle ve onayımla uygula; bundan sonra CSS ya da JS değiştiğinde dosya adını sürümle (site-v2.css gibi). gsc_submit_sitemap ile sitemap.xml'i gönder ve gsc_url_inspect ile ana sayfanın durumuna bak. En sonda bana şunları ver: sayfa sayfa puan tablosu (sayfa, mobil dört puan, masaüstü dört puan, LCP, CLS), kapıların sonucu ve uyguladığın düzeltmelerin listesi.
