Skip to content

pwa.manifest missing

Jump to bottom
github-actions[bot] edited this page Sep 6, 2026 · 2 revisions

pwa.manifest-missing

Rule ID: pwa.manifest-missing Severity: WARN Category: pwa Target Standards: W3C Web App Manifest Section 4 (Linking to a Manifest), HTML Living Standard Section 4.2.4 (The link element), Chromium Progressive Web App Discovery Engine

1. Overview & Core Invariant

Warns when the HTML document

is missing a declaration

Core Invariant:

"The HTML document or root layout must include a '' tag with a non-empty href attribute."

2. Technical Grounding & Engine Realities

For mobile and desktop browsers to locate and parse a web application's manifest file, the root HTML document must link to it via a tag within the

section.

Without this explicit link element, browsers cannot discover the manifest, and consequently will never offer the install banner ('Add to Home Screen') or configure standalone display mode.

Including a valid manifest link in the document head ensures seamless PWA discovery across Chromium, Safari, and Gecko engines.

3. Vulnerability & Risk Taxonomy

Risk Vector Severity Impact
PWA Feature Invisibility HIGH Browsers treat the site as a traditional desktop webpage and never offer PWA installation or offline capabilities.
Missing Homescreen Install Capability MEDIUM Users on mobile devices cannot install the web app to their home screen or application launcher.

4. Non-Compliant Code Patterns (Bad Examples)

TSX (HTML head without a manifest link element):

<head>
  <title>Layanan Surat Desa</title>
  <meta name="viewport" content="width=device-width, initial-scale=1" />
</head>

5. Compliant Implementation Patterns (Good Examples)

TSX (HTML head declaring a manifest link with valid href):

<head>
  <title>Layanan Surat Desa</title>
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <link rel="manifest" href="/manifest.webmanifest" />
</head>

6. How to Suppress (Ignore Directives)

If this pattern is required for an intentional exception, suppress the diagnostic using the canonical Charites Rule ID:

<!-- charites:ignore pwa.manifest-missing intentional exception -->
// charites:ignore pwa.manifest-missing intentional exception

7. Configuration Reference (charites.yaml)

rules:
  pwa.manifest-missing:
    severity: warn # error | warn | info | off

8. Architectural Domain & Verification Reference

Charites Wiki

Rule Categories

A11y (16 rules)
Browser (12 rules)
Cls (16 rules)
Design (1 rules)
Ergonomy (5 rules)
Inp (16 rules)
Lcp (16 rules)
Mobile (5 rules)
Performance (16 rules)
Pwa (10 rules)
Responsive (18 rules)
Semantic (1 rules)
Theme (32 rules)
Ux (20 rules)

Clone this wiki locally