docs: add PWA implementation guide and git workflow notes
- Document PWA feature with testing instructions - Add Git workflow: push after every task completion - Document iPhone testing steps
This commit is contained in:
@@ -1181,6 +1181,49 @@ CORS_ALLOWED_ORIGINS=http://localhost:3000,http://127.0.0.1:3000
|
||||
|
||||
---
|
||||
|
||||
## Git Workflow
|
||||
|
||||
**IMPORTANT: Push after EVERY task completion**
|
||||
|
||||
When implementing features, push to Gitea after completing each individual task:
|
||||
|
||||
```bash
|
||||
# After each task completion
|
||||
git add -A
|
||||
git commit -m "feat(scope): description"
|
||||
git push origin feature/branch-name
|
||||
```
|
||||
|
||||
**Why:**
|
||||
- Prevents loss of work
|
||||
- Enables testing on multiple devices (e.g., iPhone testing requires network-accessible code)
|
||||
- Allows rollback if issues arise
|
||||
- Keeps Gitea in sync with local progress
|
||||
|
||||
---
|
||||
|
||||
## PWA Implementation (COMPLETED)
|
||||
|
||||
**Branch:** `feature/pwa`
|
||||
|
||||
### What was implemented:
|
||||
1. **manifest.json** - PWA configuration with icons, theme colors, display mode
|
||||
2. **App Icons** - 192x192, 512x512, Apple Touch (180x180), Maskable
|
||||
3. **Meta Tags** - viewport-fit: cover, theme-color, apple-web-app-capable
|
||||
4. **Mobile CSS** - Safe areas, touch targets (44x44px), standalone mode styles
|
||||
5. **InstallPrompt Component** - "Add to Home Screen" banner for iOS/Android
|
||||
6. **dev:host Script** - `npm run dev:host` for network testing
|
||||
7. **Network Config** - `.env.local` with API URL on 192.168.168.101.111
|
||||
|
||||
### Testing PWA on iPhone:
|
||||
1. Start backend: `python manage.py runserver 0.0.0.0:8000`
|
||||
2. Start frontend: `npm run dev:host` (or `npm start` after build)
|
||||
3. Open Safari → http://192.168.101.111:3000
|
||||
4. Tap "Teilen" → "Zum Home Screen hinzufügen"
|
||||
5. App runs standalone without Safari UI
|
||||
|
||||
---
|
||||
|
||||
## Security Notes
|
||||
|
||||
- Rate limiting on auth endpoints (5/minute)
|
||||
|
||||
Reference in New Issue
Block a user