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
|
## Security Notes
|
||||||
|
|
||||||
- Rate limiting on auth endpoints (5/minute)
|
- Rate limiting on auth endpoints (5/minute)
|
||||||
|
|||||||
Reference in New Issue
Block a user