Nasıl kullanılır?
- Ad ve Kısa ad alanlarını, ardından uygulamanın Başlangıç adresi ve Kapsam değerlerini yazın.
- Görüntüleme modu seçin; Arka plan rengi ve Tema rengi alanlarına onaltılık renkler yazın.
- Simgeler alanına her satıra bir simge yazın: adres, boyutlar, tür ve amaçlar çubuklarla ayrılır.
- manifest.webmanifest altındaki metni kaydedin ve Kurulum denetimi altında listelenen her uyarıyı giderin.
Alanlar ne anlama gelir
Manifest bir JSON dosyasıdır; üyeleri W3C Web Application Manifest belgesinin 1. bölümünde tanımlanır. Yalnızca doldurduğunuz üyeler yazılır; boş bir alan o üyeyi dışarıda bırakır. Görüntüleme modu tarayıcının uygulamayı nasıl göstereceğini belirler. Tarayıcı bir modu desteklemiyorsa 6. bölümdeki zincirde bir sonrakini kullanır: tam ekran, sonra bağımsız pencere, sonra asgari arayüz, en sonda tarayıcı sekmesi.
Sayfadan farklı bir kökende olan başlangıç adresi yok sayılır, çünkü belge aynı kökenden olmasını ister. Kapsam ancak başlangıç adresini içerdiğinde kullanılır; aksi halde tarayıcılar, başlangıç adresinden dosya adı, sorgu ve parça çıkarılarak elde edilen varsayılan kapsamı kullanır.
Uyarılar neyi denetler
MDN, Chromium tabanlı tarayıcıların bir web uygulamasını kurmayı önermeden önce gereken üyeleri sıralar: bir ad ya da kısa ad, 192 piksel ve 512 piksel simgeler, bir başlangıç adresi ve bir görüntüleme modu. Ayrıca sitenin https üzerinden ya da localhost'tan sunulmasını ister ve servis çalışanının zorunlu olmadığını belirtir. Firefox masaüstünde manifest dosyasından uygulama kurmaz.
Araç yukarıdaki üyeleri ve kapsam kuralını denetler. Simge dosyalarını, https adresini ve sayfalarınızdaki bağlantıyı denetlemez; bunları siz doğrulamalısınız.
Açılışta gösterilen değerler
Sayfanın açılışta gösterdiği değerlerle manifest aşağıdaki üyeleri içerir. Ad, başlangıç adresi ve iki simge boyutu bulunduğu için denetim bir uyarı göstermez.
| Üye | Değer |
|---|---|
| name, short_name | Notlar, Notlar |
| start_url, scope | /, / |
| display | standalone |
| background_color, theme_color | #ffffff, #1f6feb |
| icons | 192x192 ve 512x512 PNG dosyaları; 512 simgesinin amacı any maskable |
Sık sorulan sorular
Manifest dosyasını nereye kaydetmeliyim?
Sitenin kökünde ya da uygulamanın klasöründe, adı manifest.webmanifest olacak biçimde kaydedin. Ardından uygulamanın her sayfasından, rel değeri manifest olan bir bağlantı öğesiyle bağlayın; MDN bu yolu anlatır.
Uygulamayı kurmak için servis çalışanına ihtiyacım var mı?
Hayır. MDN, bir PWA'nın kurulabilir olması için servis çalışanının zorunlu olmadığını belirtir; çevrimdışı çalışma için birçok uygulama yine de kullanır. Sitenin yine de https üzerinden ya da localhost'tan sunulması gerekir.
Hangi simge boyutları gerekir?
MDN, Chromium tabanlı tarayıcılar için 192 piksel ve 512 piksel simge listeler. Boyutları WIDTHxHEIGHT biçiminde yazın; bir dosyanın birden çok boyutu varsa aralarına boşluk koyun. SVG dosyası için boyut any olabilir.
Kısa ad ile ad arasındaki fark nedir?
Ad, uygulamanın tam adıdır. Kısa ad, ana ekranda simgenin altındaki etiket gibi yerin az olduğu yerler içindir. En az birini yazın; ikisi de boşsa bu araç uyarır.
Araç neden kapsam için uyarıyor?
Kapsam, ancak başlangıç adresini içerdiğinde kullanılır (W3C 1. bölüm). Başlangıç adresi kapsamın dışındaysa tarayıcılar kapsamı yok sayar ve varsayılanı kullanır; uygulama istediğiniz alanın dışında açılabilir.
Kaynaklar
- W3C, Web Application Manifest (Çalışma Taslağı, 6 Kasım 2026): bölüm 1, 2 ve 6
- MDN, Making PWAs installable (PWA'ları kurulabilir yapma)
- MDN, manifest display üyesi
- MDN, manifest icons üyesi
Rakamlar ve metin en son 10 Kasım 2026 Salı tarihinde kontrol edildi.