QRMENU PWA Görsel ve Asset Rehberi

Zorunlu PWA Bileşenleri

manifest.webmanifest
sw.js
offline.html
favicon seti
uygulama ikonları
tema rengi
Apple touch icon

Hazır Gelen İkon Seti

Projede aşağıdaki dosyalar hazır gelir:

assets/pwa/icon-72x72.png
assets/pwa/icon-96x96.png
assets/pwa/icon-128x128.png
assets/pwa/icon-144x144.png
assets/pwa/icon-152x152.png
assets/pwa/icon-192x192.png
assets/pwa/icon-384x384.png
assets/pwa/icon-512x512.png
assets/pwa/apple-touch-icon.png
assets/pwa/maskable-512x512.png
assets/pwa/favicon-96x96.png
assets/pwa/favicon-192x192.png

Bu set, V1 kurulumundan sonra boş PWA görünümü bırakmamak için varsayılan olarak kullanılabilir.

Admin panelindeki Genel Ayarlar ekranında şu alanlar kaydedildiğinde mevcut logo dosyasından ikonlar ve manifest.webmanifest otomatik yeniden üretilir:

PWA Uygulama Adı
PWA Kısa Ad
PWA Tema Rengi
PWA Arka Plan Rengi

Önerilen İkon Boyutları

En az şu boyutlar hazır olmalıdır:

72x72
96x96
128x128
144x144
152x152
192x192
384x384
512x512

Kurulum sihirbazı ileride tek kare logo yükleyip bu seti otomatik yeniden üretebilir.

Tasarım Notları

kare logo kullanılmalı
şeffaf arka plan yerine kontrollü bir marka zemini tercih edilmeli
küçük boyutlarda okunabilir olmalı
marka rengi ile uyumlu olmalı
maskable versiyon ayrıca üretilmeli

Manifest Alanları

name
short_name
description
id
start_url
scope
display
orientation
theme_color
background_color
icons
shortcuts

Header ve Tarayıcı Bağlantıları

Frontend head bölümünde en az şu alanlar bulunmalıdır:

manifest.webmanifest
theme-color
application-name
apple-mobile-web-app-title
apple-touch-icon
favicon bağlantıları

Bu alanlar eksik kalırsa PWA yükleme deneyimi zayıflar.

Offline Fallback

Offline sayfada en az şu alanlar bulunmalıdır:

logo veya ikon
“bağlantı yok” mesajı
menüye dön butonu
yeniden dene butonu

Amaç, bağlantı koptuğunda kullanıcıyı boş beyaz sayfada bırakmamaktır.

Satış İçin Not

PWA ikonları eksikse ürün profesyonel görünmez. V1 satış paketinde şu alanlar zorunlu kabul edilmelidir:

ikon seti
manifest
service worker
offline fallback
Apple touch icon

Installability Notları

short_name alanını mobil kurulum yüzeyinde taşmayacak kadar kısa tut
manifest içinde display_override, categories, dir ve prefer_related_applications alanları kullanılabilir
menu_only_mode aktifse manifest kısayollarında sadece menü aksiyonu yayınlanabilir
qr_order_mode aktifse menü ve rezervasyon kısayolları birlikte yayınlanabilir