{
  "_comment": "Web App Manifest - W3C Standard",
  "_spec": "https://www.w3.org/TR/appmanifest/",
  "_note": "Remove all _comment fields before deploying (or leave them - they're ignored by browsers)",

  "__REQUIRED_FIELDS__": "==================================================",

  "name": "AppMail - Contact Information",
  "_name_comment": "Full name of the web application, displayed to users",

  "short_name": "AppMail",
  "_short_name_comment": "Short version for limited space (e.g., home screen label). Max 12 characters recommended.",

  "__URLS__": "==================================================",

  "start_url": "/",
  "_start_url_comment": "URL to load when user launches the app. Usually '/' for root.",

  "scope": "/",
  "_scope_comment": "Navigation scope - which pages are part of the app. '/' means entire site.",

  "_id_comment": "OPTIONAL: Unique identifier for the app (URL format). Defaults to start_url if omitted. Example: \"id\": \"/\"",

  "__DISPLAY__": "==================================================",

  "display": "standalone",
  "_display_comment": "How app should be displayed. Options: fullscreen, standalone, minimal-ui, browser",
  "_display_options": {
    "fullscreen": "All available display area, no browser UI",
    "standalone": "Look like standalone app, no browser UI (RECOMMENDED for PWAs)",
    "minimal-ui": "Standalone with minimal browser UI (back/forward buttons)",
    "browser": "Normal browser tab"
  },

  "orientation": "any",
  "_orientation_comment": "Default screen orientation. Options: any, natural, landscape, portrait, portrait-primary, portrait-secondary, landscape-primary, landscape-secondary",

  "__APPEARANCE__": "==================================================",

  "theme_color": "#000000",
  "_theme_color_comment": "Browser UI color (address bar, task switcher). Use your brand color.",

  "background_color": "#f5f5f5",
  "_background_color_comment": "Placeholder color shown while app loads. Match your app's background.",

  "__METADATA__": "==================================================",

  "description": "Email contact information and vCard downloads for AureliaSRS",
  "_description_comment": "Brief description of what the app does. Shown in app stores/installers.",

  "categories": ["utilities", "business"],
  "_categories_comment": "App categories for app stores. Standard categories: books, business, education, entertainment, finance, fitness, food, games, government, health, kids, lifestyle, magazines, medical, music, navigation, news, personalization, photo, politics, productivity, security, shopping, social, sports, travel, utilities, weather",

  "_lang_comment": "OPTIONAL: Primary language (e.g., 'en', 'en-US'). Defaults to document language. Example: \"lang\": \"en\"",

  "_dir_comment": "OPTIONAL: Text direction. Options: ltr (left-to-right), rtl (right-to-left), auto. Example: \"dir\": \"ltr\"",

  "__ICONS__": "==================================================",

  "icons": [
    {
      "src": "/web-app-manifest-192x192.png",
      "sizes": "192x192",
      "type": "image/png",
      "purpose": "maskable",
      "_purpose_comment": "maskable = safe zone for various shapes (circle, square, rounded). any = displayed as-is. monochrome = single color icon for system UI"
    },
    {
      "src": "/web-app-manifest-512x512.png",
      "sizes": "512x512",
      "type": "image/png",
      "purpose": "maskable"
    },
    {
      "src": "/web-app-manifest-512x512.png",
      "sizes": "512x512",
      "type": "image/png",
      "purpose": "any"
    }
  ],
  "_icons_comment": "Required sizes: 192x192 (Android), 512x512 (splash screens). Recommended: SVG or multiple PNG sizes.",
  "_icons_best_practices": "Use 'maskable' icons with 20% padding around your logo. Provide both 'maskable' and 'any' purpose for best compatibility.",

  "__OPTIONAL_ADVANCED__": "==================================================",

  "_shortcuts_comment": "OPTIONAL: Quick actions from home screen (right-click/long-press). Example below:",
  "_shortcuts_example": [
    {
      "name": "New Contact",
      "short_name": "New",
      "description": "Create a new contact",
      "url": "/new",
      "icons": [{ "src": "/icons/new.png", "sizes": "96x96" }]
    }
  ],

  "_screenshots_comment": "OPTIONAL: App screenshots for install prompts/app stores. Recommended 1280x720 to 3840x2160.",
  "_screenshots_example": [
    {
      "src": "/screenshots/home.png",
      "sizes": "1280x720",
      "type": "image/png",
      "label": "Home screen showing contact list"
    }
  ],

  "_related_applications_comment": "OPTIONAL: Native apps related to this web app (Play Store, App Store).",
  "_related_applications_example": [
    {
      "platform": "play",
      "url": "https://play.google.com/store/apps/details?id=com.example.app",
      "id": "com.example.app"
    }
  ],

  "_prefer_related_applications_comment": "OPTIONAL: If true, suggests native app over PWA. Usually false. Example: \"prefer_related_applications\": false",

  "__NOTES__": "==================================================",
  "_notes": [
    "This file should be served with Content-Type: application/manifest+json",
    "Link in HTML: <link rel='manifest' href='/site.webmanifest'>",
    "Test your manifest at: https://manifest-validator.appspot.com/",
    "PWA requirements: HTTPS, service worker, valid manifest with name/icons",
    "All fields starting with '_' are comments and ignored by browsers"
  ]
}