Web App Manifest (manifest.json)
Web app manifest एक JSON फ़ाइल है (आमतौर पर manifest.json या site.webmanifest) जो page head से लिंक की जाती है और browsers को बताती है कि home screen या launcher में इंस्टॉल होने पर आपकी साइट कैसे व्यवहार करे। यह app का नाम, icon set, theme तथा background रंग, और display mode देती है। इसके बिना, एक browser साइट को PWA के रूप में इंस्टॉल करने की पेशकश नहीं करेगा।
Manifest क्या घोषित करता है
Manifest एक छोटा JSON document है जो <link rel="manifest"> से लिंक किया जाता है। जब कोई उपयोगकर्ता साइट इंस्टॉल करता है, तो browser इसे पढ़कर app का नाम रखता है, एक आइकन चुनता है, splash screen को रँगता है, और तय करता है कि कितना browser chrome दिखाना है।
यह सिर्फ़ installability और home-screen व्यवहार के लिए मायने रखता है। एक सामान्य browser tab को इसकी कभी ज़रूरत नहीं होती (favicon link tags उसे कवर करते हैं), यही वजह है कि कई साइटों में कोई manifest होता ही नहीं।
एक न्यूनतम manifest
{
"name": "My App",
"short_name": "App",
"start_url": "/",
"display": "standalone",
"background_color": "#ffffff",
"theme_color": "#111111",
"icons": [
{ "src": "/icon-192.png", "sizes": "192x192", "type": "image/png" },
{ "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }
]
}मुख्य fields
| Field | उद्देश्य |
|---|---|
| name / short_name | पूरा और home-screen वाला लेबल |
| icons | install और home-screen icon set |
| display | एक इंस्टॉल किया गया app कितना browser UI दिखाता है |
| theme_color | app के इर्द-गिर्द OS UI को रँगता है |
| background_color | launch पर splash screen का रंग |
| start_url | वह page जिस पर इंस्टॉल किया गया app खुलता है |
Web app manifest FAQ
क्या मुझे एक web app manifest चाहिए?
सिर्फ़ तभी जब आप चाहते हों कि साइट PWA के रूप में installable हो या उसकी home-screen उपस्थिति को नियंत्रित करना चाहते हों। सिर्फ़ एक favicon वाली एक सादी website को इसकी ज़रूरत नहीं है।
manifest.json और site.webmanifest में क्या फ़र्क़ है?
फ़ाइल नाम के अलावा कुछ नहीं। दोनों एक ही web app manifest हैं; browser वही फ़ाइल इस्तेमाल करता है जिस पर आपका <link rel="manifest"> इशारा करता है।
मैं manifest को कहाँ लिंक करूँ?
page head में, <link rel="manifest" href="/site.webmanifest"> के साथ। हर उस page पर एक link जो installable होना चाहिए।