pwa-development · travisjneuman — Claude Code skill for PWA development
The pwa-development Claude Code skill guides work on installable web apps with offline support. It activates for PWA builds, service worker setup, and offline-first features.
MIT 150 installs ★ 114 updated 2026-11-10
npx skills add travisjneuman/.claude --skill pwa-development -a claude-codeWhat pwa-development does
The skill covers PWA setup, including the web app manifest, HTML metadata, and features such as offline access, install prompts, and notifications. It points to focused reference files for details, such as references/service-worker.md and references/push-notifications.md.
Browser support varies by feature: push notifications work in modern browsers except iOS Safari, while background sync is listed for Chrome and Edge. The reference material also covers Workbox, installation flows, and Lighthouse testing.
What it helps with
- configure a PWA manifest and HTML metadata
- add a service worker for offline access
- set up browser-based app installation
- implement push notifications for a PWA
- test a PWA with Lighthouse
Example prompts for the agent
- Set up this app as a PWA, including its manifest and HTML metadata.
- Add a service worker and offline support to this project.
- Configure push notifications for this PWA and account for browser support.
How to install pwa-development
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill pwa-development -a claude-code2Manually: put the files in place
~/.claude/skills/pwa-development/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pwa-development/
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill pwa-development -a codex2Manually: put the files in place
.agents/skills/pwa-development/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill pwa-development -a cursor2Manually: put the files in place
.cursor/skills/pwa-development/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install travisjneuman/.claude skills/pwa-development2Manually: put the files in place
.github/skills/pwa-development/SKILL.md1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill pwa-development -a gemini-cli2Platform CLI
gemini skills install https://github.com/travisjneuman/.claude --path skills/pwa-developmentManually: put the files in place
.devin/skills/pwa-development/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill pwa-development -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about pwa-development
How do I install pwa-development in Claude Code?
Run npx skills add travisjneuman/.claude --skill pwa-development -a claude-code. The skill file is at ~/.claude/skills/pwa-development/SKILL.md.
What does pwa-development do?
It guides PWA work, from the app manifest and HTML metadata to service workers, offline features, installation, and push notifications. Topic-specific guidance lives in separate reference files.
Which browsers support push notifications and background sync?
Push notifications are supported in modern browsers except iOS Safari. Background sync is listed for Chrome and Edge.
Source text
SKILL.md · MIT
---
name: pwa-development
description: Progressive Web App development for installable, offline-capable web applications. Use when building PWAs, implementing service workers, or creating offline-first experiences.
---
# Progressive Web App (PWA) Development
Build installable, offline-capable web applications that work across all platforms.
## PWA Capabilities
| Feature | Support |
| ------------------ | --------------------- |
| Offline access | All modern browsers |
| Install prompt | Chrome, Edge, Samsung |
| Push notifications | All except iOS Safari |
| Background sync | Chrome, Edge |
| File handling | Chrome, Edge |
| Share target | Chrome, Edge, Safari |
---
## Core Requirements
### 1. Web App Manifest
```json
// public/manifest.json
{
"name": "My Progressive Web App",
"short_name": "MyPWA",
"description": "A progressive web application",
"start_url": "/",
"display": "standalone",
"background_color": "#ffffff",
"theme_color": "#3b82f6",
"orientation": "portrait-primary",
"scope": "/",
"icons": [
{
"src": "/icons/icon-72x72.png",
"sizes": "72x72",
"type": "image/png",
"purpose": "maskable any"
},
{
"src": "/icons/icon-96x96.png",
"sizes": "96x96",
"type": "image/png"
},
{
"src": "/icons/icon-128x128.png",
"sizes": "128x128",
"type": "image/png"
},
{
"src": "/icons/icon-192x192.png",
"sizes": "192x192",
"type": "image/png"
},
{
"src": "/icons/icon-512x512.png",
"sizes": "512x512",
"type": "image/png"
}
],
"screenshots": [
{
"src": "/screenshots/desktop.png",
"sizes": "1280x720",
"type": "image/png",
"form_factor": "wide"
},
{
"src": "/screenshots/mobile.png",
"sizes": "750x1334",
"type": "image/png",
"form_factor": "narrow"
}
],
"shortcuts": [
{
"name": "New Document",
"short_name": "New",
"url": "/new",
"icons": [{ "src": "/icons/new.png", "sizes": "96x96" }]
}
],
"share_target": {
"action": "/share",
"method": "POST",
"enctype": "multipart/form-data",
"params": {
"title": "title",
"text": "text",
"url": "url",
"files": [
{
"name": "files",
"accept": ["image/*", "text/*"]
}
]
}
}
}
```
### 2. HTML Meta Tags
```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<!-- PWA Meta Tags -->
<link rel="manifest" href="/manifest.json" />
<meta name="theme-color" content="#3b82f6" />
<meta name="description" content="My Progressive Web App" />
<!-- iOS Specific -->
<meta name="apple-mobile-web-app-capable" content="yes" />
<meta name="apple-mobile-web-app-status-bar-style" content="default" />
<meta name="apple-mobile-web-app-title" content="MyPWA" />
<link rel="apple-touch-icon" href="/icons/icon-192x192.png" />
<!-- Windows Specific -->
<meta name="msapplication-TileColor" content="#3b82f6" />
<meta name="msapplication-TileImage" content="/icons/icon-144x144.png" />
<title>My PWA</title>
</head>
<body>
<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
</body>
</html>
```
---
## Reference files
Detailed material is in separate files so this overview stays short. Read only the file whose topic matches the task; each one is self-contained. Paths are relative to the folder that holds this `SKILL.md` (in the full toolkit install, `~/.claude/skills/pwa-development/`).
| Topic | File | Covers |
| --- | --- | --- |
| Service Worker | [`references/service-worker.md`](references/service-worker.md) | Basic Service Worker; Workbox (Recommended); Service Worker Registration |
| Install Prompt | [`references/install-prompt.md`](references/install-prompt.md) | Custom Install Button |
| Offline Support | [`references/offline-support.md`](references/offline-support.md) | Offline Detection; Background Sync |
| Push Notifications | [`references/push-notifications.md`](references/push-notifications.md) | Request Permission; Handle Push in Service Worker |
| Vite PWA Plugin | [`references/vite-pwa-plugin.md`](references/vite-pwa-plugin.md) | 43 lines |
| Testing PWA | [`references/testing-pwa.md`](references/testing-pwa.md) | Lighthouse Audit; Target Scores |
| Best Practices | [`references/best-practices.md`](references/best-practices.md) | DO:; DON'T: |
© travisjneuman · MIT · travisjneuman/.claude
Similar skills
All skills for Frontend and UI →pwa-development by other authors comes first.