En iyi uygulamalar ve ileri yapılandırma

Beş kalıp

1. 1
   Önce mobil, sonra masaüstü

   Temel düzen tek sütun olsun, dokunma hedefleri ≥44px, birincil eylem başparmağın erişebildiği yerde. Geniş ekranda düzeni AÇ — telefon sekmesini masaüstüne taşıma.

2. 2
   Her çağrıyı sarmala

   Ağ hatası, kota, kapalı özellik — hepsi olağan. try/catch ile yakala ve kullanıcının dilinde tek cümlelik bir mesaj göster; ham hata kodu asla ekrana çıkmasın.

3. 3
   Sunucuyu tek doğruluk kaynağı yap

   Yazma sonrası listeyi yeniden oku; iyimser güncelleme yapıyorsan hata durumunda geri al. İki cihazın aynı kaydı düzenlemesi gerçek bir senaryodur.

4. 4
   Boş ekran gösterme

   Yükleniyor, boş ve hata durumlarının üçü de tasarlanmış olmalı. Boş durum ne yapılacağını söyleyen bir eylem içerir.

5. 5
   Koleksiyonu küçük tut

   Doküman 20K karakterle sınırlı; büyük listeleri sayfala ya da tarihe göre böl. Görsel her zaman dosya deposunda, kayıtta yalnız URL.

Kırılgan vs sağlam

Dayanıklı çağrı kalıbı

async function safe(fn, onFail) {
  try { return await fn(); }
  catch (e) {
    const m = {
      ai_disabled:     'Bu özellik şu anda kapalı.',
      mail_disabled:   'E-posta gönderimi kapalı.',
      quota_exceeded:  'Depolama alanı dolu.',
      file_too_large:  'Dosya çok büyük, daha küçük bir görsel seç.',
      not_signed_in:   'Devam etmek için giriş yap.',
      rate_limited:    'Çok hızlı gittik — bir dakika sonra dene.',
    }[e.message] || 'Bir şeyler ters gitti, tekrar dener misin?';
    onFail(m);
    return null;
  }
}

const summary = await safe(() => devany.ai.ask(prompt), toast);
if (summary) render(summary);

İleri yapılandırma: hangi anahtar nerede