PWA & Offline Support
The @docmd/plugin-pwa plugin transforms your documentation into a Progressive Web App (PWA). It adds a web manifest for mobile installation and registers a service worker for intelligent offline caching, ensuring your technical manuals remain accessible even in low-connectivity environments.
Configuration
Customise your app branding within the plugins section of your docmd.config.js.
| Option | Type | Default | Description |
|---|---|---|---|
enabled |
boolean |
true |
Enable or disable PWA manifest and service worker generation. |
themeColor |
string |
'#1e293b' |
The primary color of the mobile UI browser chrome. |
bgColor |
string |
'#ffffff' |
Background color for the splash screen during installation. |
logo |
string |
null |
Path to the app icon (relative to project source). |
Example
import { defineConfig } from '@docmd/core';
export default defineConfig({
plugins: {
pwa: {
themeColor: '#1e293b',
bgColor: '#ffffff',
logo: 'assets/app-icon.png'
}
}
});
Features
- Offline Caching: Uses a “Stale-While-Revalidate” strategy to serve pages instantly from the cache while updating in the background.
- Mobile Installation: Generates a
manifest.webmanifestallowing users to “Add to Home Screen” on iOS and Android. - Smart Asset Resolution: Automatically generates app icons from your project logo or favicon if no explicit icon is provided.
- SPA Compatible: Fully compatible with Single Page Application transitions and standard directory routing.
Icon Resolution Priority
The plugin resolves your PWA icons based on the following priority:
pwa.icons— Explicit array in config.pwa.logo— Path relative to source.config.logo— Global site logo.config.favicon— Global favicon.
Testing PWA Features
Service workers are bypassed in docmd dev to prevent caching issues during editing. To test PWA features, run docmd build and serve the site/ directory using a static host.