mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-14 20:01:09 +02:00
feat(todo): add PWA support with offline capabilities
- Add web app manifest with app metadata and shortcuts - Add service worker with network-first, cache-first, and network-only strategies - Add offline fallback page with auto-reload on reconnection - Add SVG placeholder icon for PWA - Add PWA meta tags for iOS, Android, and Windows support - Add comprehensive PWA guide documentation (docs/PWA_GUIDE.md) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Till-JS
parent
d45a9db3fc
commit
1ac74c9bf5
6 changed files with 1292 additions and 2 deletions
|
|
@ -1,9 +1,29 @@
|
|||
<!doctype html>
|
||||
<html lang="en">
|
||||
<html lang="de">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<link rel="icon" href="%sveltekit.assets%/favicon.png" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
|
||||
<!-- Favicon -->
|
||||
<link rel="icon" href="%sveltekit.assets%/favicon.png" />
|
||||
<link rel="icon" type="image/svg+xml" href="/icons/icon.svg" />
|
||||
|
||||
<!-- PWA Manifest -->
|
||||
<link rel="manifest" href="/manifest.json" />
|
||||
|
||||
<!-- Theme Color -->
|
||||
<meta name="theme-color" content="#8b5cf6" />
|
||||
<meta name="msapplication-TileColor" content="#8b5cf6" />
|
||||
|
||||
<!-- Apple iOS PWA -->
|
||||
<meta name="apple-mobile-web-app-capable" content="yes" />
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
|
||||
<meta name="apple-mobile-web-app-title" content="Todo" />
|
||||
<link rel="apple-touch-icon" href="/icons/icon.svg" />
|
||||
|
||||
<!-- Microsoft Tiles -->
|
||||
<meta name="msapplication-config" content="none" />
|
||||
|
||||
%sveltekit.head%
|
||||
</head>
|
||||
<body data-sveltekit-preload-data="hover">
|
||||
|
|
|
|||
25
apps/todo/apps/web/static/icons/icon.svg
Normal file
25
apps/todo/apps/web/static/icons/icon.svg
Normal file
|
|
@ -0,0 +1,25 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
|
||||
<defs>
|
||||
<linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
|
||||
<stop offset="0%" style="stop-color:#8b5cf6"/>
|
||||
<stop offset="100%" style="stop-color:#7c3aed"/>
|
||||
</linearGradient>
|
||||
</defs>
|
||||
<!-- Background -->
|
||||
<rect width="512" height="512" rx="96" fill="url(#bg)"/>
|
||||
<!-- Checkbox icon -->
|
||||
<g fill="none" stroke="white" stroke-width="28" stroke-linecap="round" stroke-linejoin="round">
|
||||
<!-- Checkbox outline -->
|
||||
<rect x="120" y="140" width="120" height="120" rx="24" fill="none"/>
|
||||
<!-- Checkmark -->
|
||||
<path d="M150 200 L175 225 L220 170"/>
|
||||
<!-- Lines (task text) -->
|
||||
<line x1="280" y1="170" x2="392" y2="170"/>
|
||||
<line x1="280" y1="230" x2="350" y2="230"/>
|
||||
<!-- Second checkbox (unchecked) -->
|
||||
<rect x="120" y="300" width="120" height="120" rx="24" fill="none"/>
|
||||
<!-- Lines for second task -->
|
||||
<line x1="280" y1="330" x2="392" y2="330"/>
|
||||
<line x1="280" y1="390" x2="320" y2="390"/>
|
||||
</g>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 1 KiB |
71
apps/todo/apps/web/static/manifest.json
Normal file
71
apps/todo/apps/web/static/manifest.json
Normal file
|
|
@ -0,0 +1,71 @@
|
|||
{
|
||||
"name": "Todo - Aufgabenverwaltung",
|
||||
"short_name": "Todo",
|
||||
"description": "Aufgaben und Projekte verwalten mit Kanban-Board, Subtasks und mehr",
|
||||
"start_url": "/",
|
||||
"scope": "/",
|
||||
"display": "standalone",
|
||||
"background_color": "#ffffff",
|
||||
"theme_color": "#8b5cf6",
|
||||
"orientation": "any",
|
||||
"categories": ["productivity", "utilities"],
|
||||
"lang": "de",
|
||||
"dir": "ltr",
|
||||
"icons": [
|
||||
{
|
||||
"src": "/icons/icon.svg",
|
||||
"sizes": "any",
|
||||
"type": "image/svg+xml",
|
||||
"purpose": "any"
|
||||
},
|
||||
{
|
||||
"src": "/icons/icon.svg",
|
||||
"sizes": "any",
|
||||
"type": "image/svg+xml",
|
||||
"purpose": "maskable"
|
||||
}
|
||||
],
|
||||
"shortcuts": [
|
||||
{
|
||||
"name": "Neue Aufgabe",
|
||||
"short_name": "Neu",
|
||||
"description": "Neue Aufgabe erstellen",
|
||||
"url": "/?action=new",
|
||||
"icons": [
|
||||
{
|
||||
"src": "/icons/icon.svg",
|
||||
"sizes": "any",
|
||||
"type": "image/svg+xml"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "Kanban Board",
|
||||
"short_name": "Kanban",
|
||||
"description": "Kanban-Ansicht öffnen",
|
||||
"url": "/kanban",
|
||||
"icons": [
|
||||
{
|
||||
"src": "/icons/icon.svg",
|
||||
"sizes": "any",
|
||||
"type": "image/svg+xml"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "Einstellungen",
|
||||
"short_name": "Settings",
|
||||
"description": "App-Einstellungen öffnen",
|
||||
"url": "/settings",
|
||||
"icons": [
|
||||
{
|
||||
"src": "/icons/icon.svg",
|
||||
"sizes": "any",
|
||||
"type": "image/svg+xml"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"screenshots": [],
|
||||
"prefer_related_applications": false
|
||||
}
|
||||
228
apps/todo/apps/web/static/offline.html
Normal file
228
apps/todo/apps/web/static/offline.html
Normal file
|
|
@ -0,0 +1,228 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="de">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>Offline - Todo</title>
|
||||
<style>
|
||||
* {
|
||||
margin: 0;
|
||||
padding: 0;
|
||||
box-sizing: border-box;
|
||||
}
|
||||
|
||||
body {
|
||||
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
|
||||
background: linear-gradient(135deg, #f5f3ff 0%, #ede9fe 100%);
|
||||
min-height: 100vh;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
padding: 1rem;
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
body {
|
||||
background: linear-gradient(135deg, #1e1b2e 0%, #2d2640 100%);
|
||||
color: #f3f4f6;
|
||||
}
|
||||
}
|
||||
|
||||
.container {
|
||||
text-align: center;
|
||||
max-width: 400px;
|
||||
padding: 2rem;
|
||||
background: rgba(255, 255, 255, 0.9);
|
||||
border-radius: 1.5rem;
|
||||
box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.15);
|
||||
backdrop-filter: blur(20px);
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
.container {
|
||||
background: rgba(30, 27, 46, 0.9);
|
||||
border: 1px solid rgba(255, 255, 255, 0.1);
|
||||
}
|
||||
}
|
||||
|
||||
.icon {
|
||||
width: 80px;
|
||||
height: 80px;
|
||||
margin: 0 auto 1.5rem;
|
||||
background: linear-gradient(135deg, #8b5cf6 0%, #7c3aed 100%);
|
||||
border-radius: 1rem;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
}
|
||||
|
||||
.icon svg {
|
||||
width: 48px;
|
||||
height: 48px;
|
||||
color: white;
|
||||
}
|
||||
|
||||
h1 {
|
||||
font-size: 1.5rem;
|
||||
font-weight: 600;
|
||||
color: #1f2937;
|
||||
margin-bottom: 0.75rem;
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
h1 {
|
||||
color: #f3f4f6;
|
||||
}
|
||||
}
|
||||
|
||||
p {
|
||||
color: #6b7280;
|
||||
margin-bottom: 1.5rem;
|
||||
line-height: 1.6;
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
p {
|
||||
color: #9ca3af;
|
||||
}
|
||||
}
|
||||
|
||||
.status {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
gap: 0.5rem;
|
||||
padding: 0.75rem 1rem;
|
||||
background: rgba(239, 68, 68, 0.1);
|
||||
border-radius: 9999px;
|
||||
color: #ef4444;
|
||||
font-size: 0.875rem;
|
||||
margin-bottom: 1.5rem;
|
||||
}
|
||||
|
||||
.status-dot {
|
||||
width: 8px;
|
||||
height: 8px;
|
||||
background: #ef4444;
|
||||
border-radius: 50%;
|
||||
animation: pulse 2s infinite;
|
||||
}
|
||||
|
||||
@keyframes pulse {
|
||||
0%, 100% { opacity: 1; }
|
||||
50% { opacity: 0.5; }
|
||||
}
|
||||
|
||||
button {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 0.5rem;
|
||||
padding: 0.75rem 1.5rem;
|
||||
background: linear-gradient(135deg, #8b5cf6 0%, #7c3aed 100%);
|
||||
color: white;
|
||||
border: none;
|
||||
border-radius: 9999px;
|
||||
font-size: 0.875rem;
|
||||
font-weight: 500;
|
||||
cursor: pointer;
|
||||
transition: transform 0.15s, box-shadow 0.15s;
|
||||
}
|
||||
|
||||
button:hover {
|
||||
transform: translateY(-2px);
|
||||
box-shadow: 0 10px 20px -10px rgba(139, 92, 246, 0.5);
|
||||
}
|
||||
|
||||
button:active {
|
||||
transform: translateY(0);
|
||||
}
|
||||
|
||||
.tips {
|
||||
margin-top: 2rem;
|
||||
padding-top: 1.5rem;
|
||||
border-top: 1px solid rgba(0, 0, 0, 0.1);
|
||||
text-align: left;
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
.tips {
|
||||
border-top-color: rgba(255, 255, 255, 0.1);
|
||||
}
|
||||
}
|
||||
|
||||
.tips h2 {
|
||||
font-size: 0.75rem;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.05em;
|
||||
color: #9ca3af;
|
||||
margin-bottom: 0.75rem;
|
||||
}
|
||||
|
||||
.tips ul {
|
||||
list-style: none;
|
||||
font-size: 0.875rem;
|
||||
color: #6b7280;
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
.tips ul {
|
||||
color: #9ca3af;
|
||||
}
|
||||
}
|
||||
|
||||
.tips li {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 0.5rem;
|
||||
margin-bottom: 0.5rem;
|
||||
}
|
||||
|
||||
.tips li::before {
|
||||
content: '•';
|
||||
color: #8b5cf6;
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div class="container">
|
||||
<div class="icon">
|
||||
<svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
|
||||
d="M18.364 5.636a9 9 0 010 12.728m0 0l-2.829-2.829m2.829 2.829L21 21M15.536 8.464a5 5 0 010 7.072m0 0l-2.829-2.829m-4.243 2.829a4.978 4.978 0 01-1.414-2.83m-1.414 5.658a9 9 0 01-2.167-9.238m7.824 2.167a1 1 0 111.414 1.414m-1.414-1.414L3 3m8.293 8.293l1.414 1.414" />
|
||||
</svg>
|
||||
</div>
|
||||
|
||||
<h1>Du bist offline</h1>
|
||||
<p>Keine Internetverbindung. Sobald du wieder online bist, kannst du deine Aufgaben verwalten.</p>
|
||||
|
||||
<div class="status">
|
||||
<span class="status-dot"></span>
|
||||
<span>Verbindung wird gesucht...</span>
|
||||
</div>
|
||||
|
||||
<button onclick="location.reload()">
|
||||
<svg width="16" height="16" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
|
||||
d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15" />
|
||||
</svg>
|
||||
Erneut versuchen
|
||||
</button>
|
||||
|
||||
<div class="tips">
|
||||
<h2>Was du tun kannst</h2>
|
||||
<ul>
|
||||
<li>Überprüfe deine WLAN-Verbindung</li>
|
||||
<li>Prüfe deine mobilen Daten</li>
|
||||
<li>Versuche es in einigen Sekunden erneut</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<script>
|
||||
// Automatisch neu laden, wenn wieder online
|
||||
window.addEventListener('online', () => {
|
||||
location.reload();
|
||||
});
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
154
apps/todo/apps/web/static/sw.js
Normal file
154
apps/todo/apps/web/static/sw.js
Normal file
|
|
@ -0,0 +1,154 @@
|
|||
const CACHE_NAME = 'todo-v1';
|
||||
const OFFLINE_URL = '/offline.html';
|
||||
|
||||
// Assets, die immer gecacht werden sollen
|
||||
const STATIC_CACHE_URLS = ['/', '/offline.html', '/icons/icon.svg', '/manifest.json'];
|
||||
|
||||
// Cache-Strategien für verschiedene Ressourcen
|
||||
const CACHE_STRATEGIES = {
|
||||
// Netzwerk zuerst, dann Cache (für HTML/Navigation)
|
||||
networkFirst: [/\/$/, /\.html$/, /^\/kanban/, /^\/settings/, /^\/mana/, /^\/feedback/],
|
||||
// Cache zuerst, dann Netzwerk (für Assets)
|
||||
cacheFirst: [
|
||||
/\.css$/,
|
||||
/\.js$/,
|
||||
/\.woff2?$/,
|
||||
/\.ttf$/,
|
||||
/\.otf$/,
|
||||
/\.svg$/,
|
||||
/\.png$/,
|
||||
/\.jpg$/,
|
||||
/\.jpeg$/,
|
||||
/\.webp$/,
|
||||
/\.ico$/,
|
||||
/\/_app\//,
|
||||
],
|
||||
// Nur Netzwerk (für API-Calls)
|
||||
networkOnly: [/\/api\//, /localhost:3018/],
|
||||
};
|
||||
|
||||
// Service Worker Installation
|
||||
self.addEventListener('install', (event) => {
|
||||
event.waitUntil(
|
||||
caches
|
||||
.open(CACHE_NAME)
|
||||
.then((cache) => {
|
||||
console.log('Todo Service Worker: Caching static assets');
|
||||
return cache.addAll(STATIC_CACHE_URLS);
|
||||
})
|
||||
.then(() => self.skipWaiting())
|
||||
);
|
||||
});
|
||||
|
||||
// Service Worker Aktivierung
|
||||
self.addEventListener('activate', (event) => {
|
||||
event.waitUntil(
|
||||
caches
|
||||
.keys()
|
||||
.then((cacheNames) => {
|
||||
return Promise.all(
|
||||
cacheNames
|
||||
.filter((cacheName) => cacheName.startsWith('todo-') && cacheName !== CACHE_NAME)
|
||||
.map((cacheName) => caches.delete(cacheName))
|
||||
);
|
||||
})
|
||||
.then(() => self.clients.claim())
|
||||
);
|
||||
});
|
||||
|
||||
// Fetch-Event Handler
|
||||
self.addEventListener('fetch', (event) => {
|
||||
const { request } = event;
|
||||
const url = new URL(request.url);
|
||||
|
||||
// Ignoriere Chrome Extension Requests
|
||||
if (url.protocol === 'chrome-extension:') {
|
||||
return;
|
||||
}
|
||||
|
||||
// Ignoriere Cross-Origin Requests (z.B. Backend API)
|
||||
if (url.origin !== self.location.origin) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Bestimme die Cache-Strategie
|
||||
const strategy = getStrategy(url.pathname);
|
||||
|
||||
if (strategy === 'networkFirst') {
|
||||
event.respondWith(networkFirst(request));
|
||||
} else if (strategy === 'cacheFirst') {
|
||||
event.respondWith(cacheFirst(request));
|
||||
} else if (strategy === 'networkOnly') {
|
||||
event.respondWith(networkOnly(request));
|
||||
} else {
|
||||
// Standard: Network First
|
||||
event.respondWith(networkFirst(request));
|
||||
}
|
||||
});
|
||||
|
||||
// Cache-Strategien Implementierung
|
||||
async function networkFirst(request) {
|
||||
try {
|
||||
const networkResponse = await fetch(request);
|
||||
if (networkResponse.ok) {
|
||||
const cache = await caches.open(CACHE_NAME);
|
||||
cache.put(request, networkResponse.clone());
|
||||
}
|
||||
return networkResponse;
|
||||
} catch (error) {
|
||||
const cachedResponse = await caches.match(request);
|
||||
if (cachedResponse) {
|
||||
return cachedResponse;
|
||||
}
|
||||
|
||||
// Wenn es eine Navigation ist und wir offline sind, zeige die Offline-Seite
|
||||
if (request.mode === 'navigate') {
|
||||
const offlineResponse = await caches.match(OFFLINE_URL);
|
||||
if (offlineResponse) {
|
||||
return offlineResponse;
|
||||
}
|
||||
}
|
||||
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
async function cacheFirst(request) {
|
||||
const cachedResponse = await caches.match(request);
|
||||
if (cachedResponse) {
|
||||
return cachedResponse;
|
||||
}
|
||||
|
||||
try {
|
||||
const networkResponse = await fetch(request);
|
||||
if (networkResponse.ok) {
|
||||
const cache = await caches.open(CACHE_NAME);
|
||||
cache.put(request, networkResponse.clone());
|
||||
}
|
||||
return networkResponse;
|
||||
} catch (error) {
|
||||
console.error('Todo SW: Fetch failed:', error);
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
async function networkOnly(request) {
|
||||
return fetch(request);
|
||||
}
|
||||
|
||||
// Hilfsfunktion zur Bestimmung der Cache-Strategie
|
||||
function getStrategy(pathname) {
|
||||
for (const [strategy, patterns] of Object.entries(CACHE_STRATEGIES)) {
|
||||
if (patterns.some((pattern) => pattern.test(pathname))) {
|
||||
return strategy;
|
||||
}
|
||||
}
|
||||
return 'networkFirst';
|
||||
}
|
||||
|
||||
// Message Handler für Updates
|
||||
self.addEventListener('message', (event) => {
|
||||
if (event.data && event.data.type === 'SKIP_WAITING') {
|
||||
self.skipWaiting();
|
||||
}
|
||||
});
|
||||
792
docs/PWA_GUIDE.md
Normal file
792
docs/PWA_GUIDE.md
Normal file
|
|
@ -0,0 +1,792 @@
|
|||
# PWA Guide - Progressive Web Apps im Monorepo
|
||||
|
||||
Diese Anleitung beschreibt, wie eine bestehende Web-App in eine installierbare PWA (Progressive Web App) umgewandelt wird.
|
||||
|
||||
## Übersicht
|
||||
|
||||
Eine PWA benötigt folgende Komponenten:
|
||||
|
||||
| Komponente | Datei | Zweck |
|
||||
|------------|-------|-------|
|
||||
| Web App Manifest | `static/manifest.json` | App-Metadaten, Icons, Shortcuts |
|
||||
| Service Worker | `static/sw.js` | Offline-Support, Caching |
|
||||
| Offline-Seite | `static/offline.html` | Fallback wenn offline |
|
||||
| App-Icons | `static/icons/` | Icons für verschiedene Plattformen |
|
||||
| Meta-Tags | `src/app.html` | PWA-Konfiguration im HTML |
|
||||
| SW Registration | `+layout.svelte` | Service Worker starten |
|
||||
|
||||
---
|
||||
|
||||
## Schritt 1: App-Icons erstellen
|
||||
|
||||
### Verzeichnis anlegen
|
||||
|
||||
```
|
||||
static/icons/
|
||||
├── icon.svg # Basis-Icon (SVG, skalierbar)
|
||||
├── icon-72x72.png # Optional: PNG für ältere Browser
|
||||
├── icon-96x96.png
|
||||
├── icon-128x128.png
|
||||
├── icon-144x144.png
|
||||
├── icon-152x152.png
|
||||
├── icon-192x192.png
|
||||
├── icon-384x384.png
|
||||
├── icon-512x512.png
|
||||
└── apple-touch-icon.png # 180x180 für iOS
|
||||
```
|
||||
|
||||
### SVG-Icon Vorlage
|
||||
|
||||
SVG ist ideal, da es skalierbar ist und nur eine Datei benötigt:
|
||||
|
||||
```svg
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
|
||||
<defs>
|
||||
<linearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="100%">
|
||||
<stop offset="0%" style="stop-color:#8b5cf6"/>
|
||||
<stop offset="100%" style="stop-color:#7c3aed"/>
|
||||
</linearGradient>
|
||||
</defs>
|
||||
<rect width="512" height="512" rx="96" fill="url(#grad)"/>
|
||||
<!-- App-spezifisches Icon hier -->
|
||||
</svg>
|
||||
```
|
||||
|
||||
### Farbschema pro App
|
||||
|
||||
| App | Primary Color | Gradient |
|
||||
|-----|---------------|----------|
|
||||
| Todo | `#8b5cf6` | `#8b5cf6` → `#7c3aed` |
|
||||
| Chat | `#3b82f6` | `#3b82f6` → `#2563eb` |
|
||||
| Picture | `#ec4899` | `#ec4899` → `#db2777` |
|
||||
| Zitare | `#f59e0b` | `#f59e0b` → `#d97706` |
|
||||
| Calendar | `#10b981` | `#10b981` → `#059669` |
|
||||
| Contacts | `#6366f1` | `#6366f1` → `#4f46e5` |
|
||||
| Mana Games | `#00ff88` | `#00ff88` → `#00cc6a` |
|
||||
|
||||
---
|
||||
|
||||
## Schritt 2: Web App Manifest
|
||||
|
||||
### Datei: `static/manifest.json`
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "App Name - Beschreibung",
|
||||
"short_name": "App Name",
|
||||
"description": "Kurze Beschreibung der App",
|
||||
"start_url": "/",
|
||||
"display": "standalone",
|
||||
"background_color": "#ffffff",
|
||||
"theme_color": "#8b5cf6",
|
||||
"orientation": "any",
|
||||
"categories": ["productivity"],
|
||||
"lang": "de",
|
||||
"icons": [
|
||||
{
|
||||
"src": "/icons/icon.svg",
|
||||
"sizes": "any",
|
||||
"type": "image/svg+xml",
|
||||
"purpose": "any"
|
||||
},
|
||||
{
|
||||
"src": "/icons/icon-192x192.png",
|
||||
"sizes": "192x192",
|
||||
"type": "image/png"
|
||||
},
|
||||
{
|
||||
"src": "/icons/icon-512x512.png",
|
||||
"sizes": "512x512",
|
||||
"type": "image/png"
|
||||
}
|
||||
],
|
||||
"shortcuts": [
|
||||
{
|
||||
"name": "Shortcut Name",
|
||||
"short_name": "Kurz",
|
||||
"description": "Beschreibung",
|
||||
"url": "/path?action=shortcut",
|
||||
"icons": [
|
||||
{
|
||||
"src": "/icons/icon-96x96.png",
|
||||
"sizes": "96x96"
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Manifest-Felder erklärt
|
||||
|
||||
| Feld | Beschreibung | Beispiel |
|
||||
|------|--------------|----------|
|
||||
| `name` | Vollständiger App-Name | "Todo - Aufgabenverwaltung" |
|
||||
| `short_name` | Kurzname (max 12 Zeichen) | "Todo" |
|
||||
| `description` | App-Beschreibung | "Aufgaben verwalten" |
|
||||
| `start_url` | Start-URL beim Öffnen | "/" |
|
||||
| `display` | Anzeigemodus | "standalone", "fullscreen", "minimal-ui" |
|
||||
| `background_color` | Hintergrund beim Laden | "#ffffff" |
|
||||
| `theme_color` | Statusleisten-Farbe | "#8b5cf6" |
|
||||
| `orientation` | Bildschirmorientierung | "any", "portrait", "landscape" |
|
||||
| `categories` | App Store Kategorien | ["productivity", "utilities"] |
|
||||
| `lang` | Sprache | "de" |
|
||||
| `icons` | App-Icons Array | Siehe oben |
|
||||
| `shortcuts` | Quick Actions | Siehe oben |
|
||||
|
||||
### Display-Modi
|
||||
|
||||
| Modus | Beschreibung |
|
||||
|-------|--------------|
|
||||
| `fullscreen` | Komplett bildschirmfüllend, keine Browser-UI |
|
||||
| `standalone` | Wie native App, mit Statusleiste |
|
||||
| `minimal-ui` | Mit minimaler Browser-Navigation |
|
||||
| `browser` | Normaler Browser-Tab |
|
||||
|
||||
---
|
||||
|
||||
## Schritt 3: Service Worker
|
||||
|
||||
### Datei: `static/sw.js`
|
||||
|
||||
```javascript
|
||||
const CACHE_NAME = 'app-name-v1';
|
||||
const OFFLINE_URL = '/offline.html';
|
||||
|
||||
// Statische Assets die immer gecacht werden
|
||||
const STATIC_CACHE_URLS = [
|
||||
'/',
|
||||
'/offline.html',
|
||||
'/icons/icon.svg',
|
||||
'/manifest.json'
|
||||
];
|
||||
|
||||
// Cache-Strategien für verschiedene Ressourcen
|
||||
const CACHE_STRATEGIES = {
|
||||
// Network First: Immer aktuell, Cache als Fallback
|
||||
networkFirst: [
|
||||
/\/$/, // Root
|
||||
/\.html$/, // HTML-Dateien
|
||||
/^\/app/, // App-Routen
|
||||
],
|
||||
|
||||
// Cache First: Schnell laden, im Hintergrund aktualisieren
|
||||
cacheFirst: [
|
||||
/\.css$/,
|
||||
/\.js$/,
|
||||
/\.woff2?$/,
|
||||
/\.ttf$/,
|
||||
/\.svg$/,
|
||||
/\.png$/,
|
||||
/\.jpg$/,
|
||||
/\.jpeg$/,
|
||||
/\.webp$/,
|
||||
/\/_app\//, // SvelteKit Assets
|
||||
],
|
||||
|
||||
// Network Only: Nie cachen (API-Calls)
|
||||
networkOnly: [
|
||||
/\/api\//,
|
||||
/localhost:\d+/,
|
||||
]
|
||||
};
|
||||
|
||||
// Installation
|
||||
self.addEventListener('install', (event) => {
|
||||
event.waitUntil(
|
||||
caches.open(CACHE_NAME)
|
||||
.then((cache) => {
|
||||
console.log('SW: Caching static assets');
|
||||
return cache.addAll(STATIC_CACHE_URLS);
|
||||
})
|
||||
.then(() => self.skipWaiting())
|
||||
);
|
||||
});
|
||||
|
||||
// Aktivierung (alte Caches löschen)
|
||||
self.addEventListener('activate', (event) => {
|
||||
event.waitUntil(
|
||||
caches.keys()
|
||||
.then((cacheNames) => {
|
||||
return Promise.all(
|
||||
cacheNames
|
||||
.filter((name) => name.startsWith('app-name-') && name !== CACHE_NAME)
|
||||
.map((name) => caches.delete(name))
|
||||
);
|
||||
})
|
||||
.then(() => self.clients.claim())
|
||||
);
|
||||
});
|
||||
|
||||
// Fetch-Handler
|
||||
self.addEventListener('fetch', (event) => {
|
||||
const { request } = event;
|
||||
const url = new URL(request.url);
|
||||
|
||||
// Chrome Extensions ignorieren
|
||||
if (url.protocol === 'chrome-extension:') return;
|
||||
|
||||
// Cross-Origin ignorieren
|
||||
if (url.origin !== self.location.origin) return;
|
||||
|
||||
const strategy = getStrategy(url.pathname);
|
||||
|
||||
if (strategy === 'networkFirst') {
|
||||
event.respondWith(networkFirst(request));
|
||||
} else if (strategy === 'cacheFirst') {
|
||||
event.respondWith(cacheFirst(request));
|
||||
} else if (strategy === 'networkOnly') {
|
||||
event.respondWith(fetch(request));
|
||||
} else {
|
||||
event.respondWith(networkFirst(request));
|
||||
}
|
||||
});
|
||||
|
||||
// Network First Strategy
|
||||
async function networkFirst(request) {
|
||||
try {
|
||||
const response = await fetch(request);
|
||||
if (response.ok) {
|
||||
const cache = await caches.open(CACHE_NAME);
|
||||
cache.put(request, response.clone());
|
||||
}
|
||||
return response;
|
||||
} catch (error) {
|
||||
const cached = await caches.match(request);
|
||||
if (cached) return cached;
|
||||
|
||||
// Offline-Seite für Navigation
|
||||
if (request.mode === 'navigate') {
|
||||
const offline = await caches.match(OFFLINE_URL);
|
||||
if (offline) return offline;
|
||||
}
|
||||
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
// Cache First Strategy
|
||||
async function cacheFirst(request) {
|
||||
const cached = await caches.match(request);
|
||||
if (cached) return cached;
|
||||
|
||||
try {
|
||||
const response = await fetch(request);
|
||||
if (response.ok) {
|
||||
const cache = await caches.open(CACHE_NAME);
|
||||
cache.put(request, response.clone());
|
||||
}
|
||||
return response;
|
||||
} catch (error) {
|
||||
console.error('SW: Fetch failed:', error);
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
// Strategie ermitteln
|
||||
function getStrategy(pathname) {
|
||||
for (const [strategy, patterns] of Object.entries(CACHE_STRATEGIES)) {
|
||||
if (patterns.some((pattern) => pattern.test(pathname))) {
|
||||
return strategy;
|
||||
}
|
||||
}
|
||||
return 'networkFirst';
|
||||
}
|
||||
|
||||
// Update-Nachricht empfangen
|
||||
self.addEventListener('message', (event) => {
|
||||
if (event.data?.type === 'SKIP_WAITING') {
|
||||
self.skipWaiting();
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
### Caching-Strategien erklärt
|
||||
|
||||
| Strategie | Wann verwenden | Verhalten |
|
||||
|-----------|----------------|-----------|
|
||||
| **Network First** | HTML, dynamische Inhalte | Versucht Netzwerk, fällt auf Cache zurück |
|
||||
| **Cache First** | Statische Assets (CSS, JS, Bilder) | Lädt aus Cache, aktualisiert im Hintergrund |
|
||||
| **Network Only** | API-Calls, Echtzeit-Daten | Kein Caching, immer Netzwerk |
|
||||
| **Stale While Revalidate** | Häufig aktualisierte Inhalte | Cache sofort, Netzwerk im Hintergrund |
|
||||
|
||||
### Cache-Versionierung
|
||||
|
||||
Bei Updates den Cache-Namen erhöhen:
|
||||
|
||||
```javascript
|
||||
// Version erhöhen bei Breaking Changes
|
||||
const CACHE_NAME = 'app-name-v2'; // War v1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Schritt 4: Offline-Seite
|
||||
|
||||
### Datei: `static/offline.html`
|
||||
|
||||
```html
|
||||
<!DOCTYPE html>
|
||||
<html lang="de">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>Offline - App Name</title>
|
||||
<style>
|
||||
* {
|
||||
margin: 0;
|
||||
padding: 0;
|
||||
box-sizing: border-box;
|
||||
}
|
||||
|
||||
body {
|
||||
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
|
||||
background: linear-gradient(135deg, #f5f3ff 0%, #ede9fe 100%);
|
||||
min-height: 100vh;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
padding: 1rem;
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
body {
|
||||
background: linear-gradient(135deg, #1e1b2e 0%, #2d2640 100%);
|
||||
color: #f3f4f6;
|
||||
}
|
||||
}
|
||||
|
||||
.container {
|
||||
text-align: center;
|
||||
max-width: 400px;
|
||||
padding: 2rem;
|
||||
background: rgba(255, 255, 255, 0.9);
|
||||
border-radius: 1.5rem;
|
||||
box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.15);
|
||||
backdrop-filter: blur(20px);
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
.container {
|
||||
background: rgba(30, 27, 46, 0.9);
|
||||
border: 1px solid rgba(255, 255, 255, 0.1);
|
||||
}
|
||||
}
|
||||
|
||||
.icon {
|
||||
width: 80px;
|
||||
height: 80px;
|
||||
margin: 0 auto 1.5rem;
|
||||
background: linear-gradient(135deg, #8b5cf6 0%, #7c3aed 100%);
|
||||
border-radius: 1rem;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
}
|
||||
|
||||
.icon svg {
|
||||
width: 48px;
|
||||
height: 48px;
|
||||
color: white;
|
||||
}
|
||||
|
||||
h1 {
|
||||
font-size: 1.5rem;
|
||||
font-weight: 600;
|
||||
color: #1f2937;
|
||||
margin-bottom: 0.75rem;
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
h1 { color: #f3f4f6; }
|
||||
}
|
||||
|
||||
p {
|
||||
color: #6b7280;
|
||||
margin-bottom: 1.5rem;
|
||||
line-height: 1.6;
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
p { color: #9ca3af; }
|
||||
}
|
||||
|
||||
.status {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
gap: 0.5rem;
|
||||
padding: 0.75rem 1rem;
|
||||
background: rgba(239, 68, 68, 0.1);
|
||||
border-radius: 9999px;
|
||||
color: #ef4444;
|
||||
font-size: 0.875rem;
|
||||
margin-bottom: 1.5rem;
|
||||
}
|
||||
|
||||
.status-dot {
|
||||
width: 8px;
|
||||
height: 8px;
|
||||
background: #ef4444;
|
||||
border-radius: 50%;
|
||||
animation: pulse 2s infinite;
|
||||
}
|
||||
|
||||
@keyframes pulse {
|
||||
0%, 100% { opacity: 1; }
|
||||
50% { opacity: 0.5; }
|
||||
}
|
||||
|
||||
button {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 0.5rem;
|
||||
padding: 0.75rem 1.5rem;
|
||||
background: linear-gradient(135deg, #8b5cf6 0%, #7c3aed 100%);
|
||||
color: white;
|
||||
border: none;
|
||||
border-radius: 9999px;
|
||||
font-size: 0.875rem;
|
||||
font-weight: 500;
|
||||
cursor: pointer;
|
||||
transition: transform 0.15s, box-shadow 0.15s;
|
||||
}
|
||||
|
||||
button:hover {
|
||||
transform: translateY(-2px);
|
||||
box-shadow: 0 10px 20px -10px rgba(139, 92, 246, 0.5);
|
||||
}
|
||||
|
||||
button:active {
|
||||
transform: translateY(0);
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div class="container">
|
||||
<div class="icon">
|
||||
<svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
|
||||
d="M18.364 5.636a9 9 0 010 12.728m0 0l-2.829-2.829m2.829 2.829L21 21M15.536 8.464a5 5 0 010 7.072m0 0l-2.829-2.829m-4.243 2.829a4.978 4.978 0 01-1.414-2.83m-1.414 5.658a9 9 0 01-2.167-9.238m7.824 2.167a1 1 0 111.414 1.414m-1.414-1.414L3 3m8.293 8.293l1.414 1.414" />
|
||||
</svg>
|
||||
</div>
|
||||
|
||||
<h1>Du bist offline</h1>
|
||||
<p>Keine Internetverbindung. Sobald du wieder online bist, kannst du die App nutzen.</p>
|
||||
|
||||
<div class="status">
|
||||
<span class="status-dot"></span>
|
||||
<span>Verbindung wird gesucht...</span>
|
||||
</div>
|
||||
|
||||
<button onclick="location.reload()">
|
||||
<svg width="16" height="16" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
|
||||
d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15" />
|
||||
</svg>
|
||||
Erneut versuchen
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<script>
|
||||
// Automatisch neu laden wenn wieder online
|
||||
window.addEventListener('online', () => {
|
||||
location.reload();
|
||||
});
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Schritt 5: PWA Meta-Tags
|
||||
|
||||
### Datei: `src/app.html`
|
||||
|
||||
Im `<head>` hinzufügen:
|
||||
|
||||
```html
|
||||
<!doctype html>
|
||||
<html lang="de">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
|
||||
<!-- Favicon -->
|
||||
<link rel="icon" href="%sveltekit.assets%/favicon.png" />
|
||||
<link rel="icon" type="image/svg+xml" href="/icons/icon.svg" />
|
||||
|
||||
<!-- PWA Manifest -->
|
||||
<link rel="manifest" href="/manifest.json" />
|
||||
|
||||
<!-- Theme Color -->
|
||||
<meta name="theme-color" content="#8b5cf6" />
|
||||
<meta name="msapplication-TileColor" content="#8b5cf6" />
|
||||
|
||||
<!-- Apple iOS PWA -->
|
||||
<meta name="apple-mobile-web-app-capable" content="yes" />
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
|
||||
<meta name="apple-mobile-web-app-title" content="App Name" />
|
||||
<link rel="apple-touch-icon" href="/icons/icon.svg" />
|
||||
|
||||
<!-- Microsoft Tiles -->
|
||||
<meta name="msapplication-config" content="none" />
|
||||
|
||||
%sveltekit.head%
|
||||
</head>
|
||||
<body data-sveltekit-preload-data="hover">
|
||||
<div style="display: contents">%sveltekit.body%</div>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
|
||||
### Meta-Tags erklärt
|
||||
|
||||
| Tag | Zweck |
|
||||
|-----|-------|
|
||||
| `<link rel="manifest">` | Verlinkt das Web App Manifest |
|
||||
| `<meta name="theme-color">` | Farbe der Browser-Statusleiste |
|
||||
| `apple-mobile-web-app-capable` | Ermöglicht "Add to Home Screen" auf iOS |
|
||||
| `apple-mobile-web-app-status-bar-style` | iOS Statusleisten-Stil |
|
||||
| `apple-mobile-web-app-title` | App-Name auf iOS Homescreen |
|
||||
| `apple-touch-icon` | Icon für iOS Homescreen |
|
||||
| `msapplication-TileColor` | Windows Tile Farbe |
|
||||
|
||||
---
|
||||
|
||||
## Schritt 6: Service Worker Registration
|
||||
|
||||
### Datei: `src/routes/(app)/+layout.svelte`
|
||||
|
||||
Im `onMount` hinzufügen:
|
||||
|
||||
```typescript
|
||||
import { onMount } from 'svelte';
|
||||
|
||||
onMount(async () => {
|
||||
// ... andere Initialisierungen ...
|
||||
|
||||
// Service Worker registrieren
|
||||
if ('serviceWorker' in navigator) {
|
||||
try {
|
||||
const registration = await navigator.serviceWorker.register('/sw.js', {
|
||||
scope: '/',
|
||||
});
|
||||
console.log('PWA: Service Worker registered', registration.scope);
|
||||
|
||||
// Update-Erkennung
|
||||
registration.addEventListener('updatefound', () => {
|
||||
const newWorker = registration.installing;
|
||||
if (newWorker) {
|
||||
newWorker.addEventListener('statechange', () => {
|
||||
if (newWorker.state === 'installed' && navigator.serviceWorker.controller) {
|
||||
// Neue Version verfügbar
|
||||
console.log('PWA: New version available');
|
||||
// Optional: Benutzer informieren
|
||||
showUpdateNotification();
|
||||
}
|
||||
});
|
||||
}
|
||||
});
|
||||
} catch (error) {
|
||||
console.error('PWA: Service Worker registration failed', error);
|
||||
}
|
||||
}
|
||||
});
|
||||
|
||||
function showUpdateNotification() {
|
||||
// Optional: Toast/Banner anzeigen
|
||||
// "Neue Version verfügbar - Seite neu laden?"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Schritt 7: Optionale Features
|
||||
|
||||
### Install-Prompt anzeigen
|
||||
|
||||
```typescript
|
||||
let deferredPrompt: BeforeInstallPromptEvent | null = null;
|
||||
let showInstallButton = $state(false);
|
||||
|
||||
onMount(() => {
|
||||
window.addEventListener('beforeinstallprompt', (e) => {
|
||||
e.preventDefault();
|
||||
deferredPrompt = e as BeforeInstallPromptEvent;
|
||||
showInstallButton = true;
|
||||
});
|
||||
|
||||
window.addEventListener('appinstalled', () => {
|
||||
showInstallButton = false;
|
||||
deferredPrompt = null;
|
||||
});
|
||||
});
|
||||
|
||||
async function installApp() {
|
||||
if (!deferredPrompt) return;
|
||||
|
||||
deferredPrompt.prompt();
|
||||
const { outcome } = await deferredPrompt.userChoice;
|
||||
|
||||
if (outcome === 'accepted') {
|
||||
console.log('PWA installed');
|
||||
}
|
||||
|
||||
deferredPrompt = null;
|
||||
showInstallButton = false;
|
||||
}
|
||||
```
|
||||
|
||||
```svelte
|
||||
{#if showInstallButton}
|
||||
<button onclick={installApp}>
|
||||
App installieren
|
||||
</button>
|
||||
{/if}
|
||||
```
|
||||
|
||||
### Update-Banner
|
||||
|
||||
```svelte
|
||||
<script lang="ts">
|
||||
let showUpdateBanner = $state(false);
|
||||
let waitingWorker: ServiceWorker | null = null;
|
||||
|
||||
function handleUpdate() {
|
||||
if (waitingWorker) {
|
||||
waitingWorker.postMessage({ type: 'SKIP_WAITING' });
|
||||
}
|
||||
window.location.reload();
|
||||
}
|
||||
</script>
|
||||
|
||||
{#if showUpdateBanner}
|
||||
<div class="update-banner">
|
||||
<span>Neue Version verfügbar</span>
|
||||
<button onclick={handleUpdate}>Aktualisieren</button>
|
||||
</div>
|
||||
{/if}
|
||||
```
|
||||
|
||||
### Offline-Status anzeigen
|
||||
|
||||
```svelte
|
||||
<script lang="ts">
|
||||
let isOnline = $state(navigator.onLine);
|
||||
|
||||
onMount(() => {
|
||||
window.addEventListener('online', () => isOnline = true);
|
||||
window.addEventListener('offline', () => isOnline = false);
|
||||
});
|
||||
</script>
|
||||
|
||||
{#if !isOnline}
|
||||
<div class="offline-indicator">
|
||||
Offline
|
||||
</div>
|
||||
{/if}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Checkliste
|
||||
|
||||
### Vor dem Deployment
|
||||
|
||||
- [ ] `manifest.json` erstellt mit korrekten Metadaten
|
||||
- [ ] App-Icons in allen benötigten Größen vorhanden
|
||||
- [ ] `sw.js` erstellt mit passenden Cache-Strategien
|
||||
- [ ] `offline.html` erstellt mit App-Branding
|
||||
- [ ] PWA Meta-Tags in `app.html` eingefügt
|
||||
- [ ] Service Worker Registration im Layout
|
||||
- [ ] Theme-Color passt zur App
|
||||
- [ ] `start_url` ist korrekt
|
||||
- [ ] Shortcuts sind sinnvoll definiert
|
||||
|
||||
### Testen
|
||||
|
||||
```bash
|
||||
# Chrome DevTools
|
||||
1. F12 öffnen
|
||||
2. Application Tab
|
||||
3. "Manifest" prüfen
|
||||
4. "Service Workers" prüfen
|
||||
5. "Cache Storage" prüfen
|
||||
|
||||
# Lighthouse Audit
|
||||
1. F12 öffnen
|
||||
2. Lighthouse Tab
|
||||
3. "Progressive Web App" aktivieren
|
||||
4. "Analyze page load" klicken
|
||||
```
|
||||
|
||||
### PWA-Kriterien (Lighthouse)
|
||||
|
||||
| Kriterium | Anforderung |
|
||||
|-----------|-------------|
|
||||
| Installierbar | Manifest + Service Worker |
|
||||
| Offline-fähig | Service Worker mit Caching |
|
||||
| HTTPS | Erforderlich (außer localhost) |
|
||||
| Responsive | Viewport Meta-Tag |
|
||||
| Schnell | First Contentful Paint < 3s |
|
||||
|
||||
---
|
||||
|
||||
## Referenz-Implementierungen
|
||||
|
||||
### Im Monorepo
|
||||
|
||||
| App | Verzeichnis |
|
||||
|-----|-------------|
|
||||
| Mana Games | `games/mana-games/apps/web/public/` |
|
||||
| Todo | `apps/todo/apps/web/static/` |
|
||||
|
||||
### Externe Ressourcen
|
||||
|
||||
- [Web.dev PWA Guide](https://web.dev/progressive-web-apps/)
|
||||
- [MDN Web App Manifest](https://developer.mozilla.org/en-US/docs/Web/Manifest)
|
||||
- [Workbox (Google's SW Library)](https://developer.chrome.com/docs/workbox/)
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Service Worker wird nicht registriert
|
||||
|
||||
```
|
||||
Fehler: "Service Worker registration failed"
|
||||
```
|
||||
|
||||
**Lösungen:**
|
||||
1. HTTPS verwenden (oder localhost)
|
||||
2. Pfad zu `sw.js` prüfen (muss im root sein)
|
||||
3. Browser-Cache leeren
|
||||
4. DevTools → Application → Service Workers → "Update on reload" aktivieren
|
||||
|
||||
### Manifest wird nicht erkannt
|
||||
|
||||
```
|
||||
Fehler: "No matching service worker detected"
|
||||
```
|
||||
|
||||
**Lösungen:**
|
||||
1. `<link rel="manifest">` im `<head>` prüfen
|
||||
2. JSON-Syntax in `manifest.json` validieren
|
||||
3. Icons-Pfade prüfen
|
||||
|
||||
### Offline-Seite wird nicht angezeigt
|
||||
|
||||
**Lösungen:**
|
||||
1. `offline.html` ist in `STATIC_CACHE_URLS` enthalten
|
||||
2. Service Worker ist aktiviert
|
||||
3. Cache-Name stimmt überein
|
||||
|
||||
### App lässt sich nicht installieren
|
||||
|
||||
**Voraussetzungen:**
|
||||
1. HTTPS (oder localhost)
|
||||
2. Gültiges Manifest mit `name`, `icons`, `start_url`, `display`
|
||||
3. Service Worker registriert
|
||||
4. Icon mindestens 192x192px
|
||||
Loading…
Add table
Add a link
Reference in a new issue