| name | Application name (displayed to users) | no | "" |
| short_name | Short application name (for limited space) | no | "" |
| description | Description of the web application | no | — |
| start_url | URL to load when launching the app (default: /) | no | / |
| scope | Navigation scope of the app (default: /) | no | / |
| id | Unique identifier for the application | no | — |
| display | Display mode: fullscreen, standalone, minimal-ui, or browser (default: standalone) | no | standalone |
| orientation | Default screen orientation: any, natural, landscape, portrait, portrait-primary, portrait-secondary, landscape-primary, landscape-secondary | no | any |
| theme_color | Theme color for the application (hex, rgb, or named color) (default: #ffffff) | no | #ffffff |
| background_color | Background color while loading (hex, rgb, or named color) (default: #ffffff) | no | #ffffff |
| lang | Primary language tag (e.g., en-US, fr, ja) | no | — |
| dir | Text direction: ltr, rtl, or auto | no | — |
| icons | JSON array of icon objects with src, sizes, type, and optional purpose (`any`, `maskable`, `monochrome`). Defaults use maskable. | no | — |
| shortcuts | JSON array of shortcut objects with name, url, description, and icons properties | no | — |
| categories | Comma-separated list of application categories | no | — |
| icons_dir | Default directory path for icon assets (default: /icons/). Used for convenience when building icon URLs | no | /icons/ |
| inject_manifest_link | Inject manifest link into page files (default: true) | no | true |
| inject_pwa_meta_tags | Inject PWA meta tags into page files (theme-color, mobile-web-app-capable, etc.) (default: true) | no | true |
| inject_favicon_links | Inject favicon link tags into page files (default: true) | no | true |
| inject_mobile_web_app_capable | Inject mobile-web-app-capable meta tag (default: true) | no | true |
| crossorigin_credentials | Add crossorigin="use-credentials" to manifest link (default: false) | no | false |
| inject_manifest_link_exts | File extensions to scan for page injection, space-separated. Recommended: html htm xhtml php phtml (default: html htm xhtml php phtml) | no | html htm xhtml php phtml |
| validate_manifest_assets | Validate manifest assets (icon file existence). Always warns, never fails. (default: true) | no | true |
| public_dir | Public directory where the manifest file will be written (e.g., dist, public, build) | yes | — |
| filename | Output manifest filename (default: site.webmanifest) | no | site.webmanifest |
| upload_artifacts | Upload generated manifest to GitHub artifacts (default: true) | no | true |
| artifact_name | Name for the uploaded artifact (default: web-manifest) | no | web-manifest |
| artifact_retention_days | Number of days to retain the artifact (1-90, default: repository settings) | no | — |