# HomeSyncHub CommandCenter PWA 6.0 — Multi-Workspace Edition

This version adds private family workspaces, workspace switching, join codes, Super Admin recovery, Admin/Member workspace roles, soft archive/restore, Light/Dark/Auto theme support, and the full Filipino menu image meal planner.

See `WORKSPACE_SYSTEM.md` for the workspace and permission model.

# HomeSyncHub Family CommandCenter PWA

Clean browser-based family command center inspired by the family-calendar category, not a direct copy of any commercial app.

## Included working modules

- Shared family calendar with Day, Week, Month, and Agenda views
- Events, tasks, chores, and meal plans
- Color-coded family profiles with avatar + color
- Chore chart with points, stars, streaks, and reward badges
- Shared lists for groceries, to-dos, errands, and reminders
- Meal planner with Breakfast, Lunch, Dinner, and Snack
- Grocery suggestions generated from meal notes
- Touchscreen Display mode for wall/tablet use
- Sleep mode, parental-lock setting, and photo-screensaver cards
- Calendar sync settings page with provider records
- ICS export for one-way calendar feed/import
- Magic Import parser for pasted schedules/lists
- Sidekick local meal-plan generator
- PWA manifest, service worker, offline page, install support, and branded mobile assets
- JSON file storage, no MySQL required

## Integration-ready but not connected yet

These need real provider credentials or external services before they can be production features:

- Two-way Google Calendar sync: requires Google Cloud OAuth and Calendar API
- Two-way iCloud sync: requires CalDAV/app-specific password handling
- Outlook/Cozi/Yahoo one-way/two-way sync: provider-specific API or ICS setup
- Push notifications: requires HTTPS and Web Push VAPID keys
- Weather forecasting: requires weather API key
- OCR/PDF/photo Magic Import: requires OCR or AI document parser
- Native iOS widgets: requires a real native iOS app wrapper; PWA shortcuts are included

## Install on XAMPP

1. Extract this folder to:

   `C:\xampp\htdocs\HomeSyncHub`

2. Open:

   `http://localhost/HomeSyncHub/`

3. Register a new account.

The app stores data in `data/store.json`. Keep the `data/.htaccess` file to prevent direct web access to that file.

## Phone use

- iPhone/iPad: open in Safari, then Share -> Add to Home Screen.
- Android: open in Chrome, then Install app or Add to Home screen.

For best PWA behavior outside localhost, host it over HTTPS.


## Branding update v4

- The old compact H mark has been replaced with the uploaded HomeSyncHub dashboard banner asset.
- A new SVG text-logo asset inspired by the powered/future-ready footer style is included in `assets/brand/brand-text-logo.svg`.
- The footer uses the uploaded JoshleenTech 2026 banner in a responsive mobile-safe layout.

## Production status

This package is production-prep for browser/PWA deployment. Native Android APK/AAB or iOS IPA generation still requires Android Studio/Xcode or a wrapper such as Capacitor/TWA, signing certificates, and store accounts.


## Responsive Logo Scaling

Version 4.1 adds a responsive branding layer so the header, footer, sidebar, login, and display-mode logos stay visible across desktop, tablet, Android, iOS, PWA standalone mode, and browser zoom. The logo frames now use proportional image sizing, `object-fit: contain`, no forced cropping, and mobile-safe overrides so logos do not disappear on narrow screens.

## v5 Role Access + Light/Dark Theme Update

This build adds the recommended clean access model:

- Superadmin: system-wide account and role management
- Owner: main family hub owner
- Parent Admin: adult admin with all Editor permissions plus family/reward/access controls
- Editor: add/edit/delete events, tasks, chores, meals, and lists
- Viewer: read-only
- Kid View: child-safe view with chore/task completion only

The app also supports Dark, Light, and Auto theme modes from Settings. Text visibility and contrast were improved across desktop, tablet, iOS, Android, and PWA display modes.

Default local Superadmin bootstrap:

```text
superadmin@homesynchub.local
ChangeMe123!
```

Change this before public deployment.

## v5.1 Meal Planner Blueprint

The Meals page has been rebuilt into a weekly planner interface with Monday-Sunday rows, Breakfast/Lunch/Snacks/Dinner columns, Filipino Menu Library, Add New Menu, Grocery List, and Favorite Meals views.

See `MEAL_PLANNER_BLUEPRINT.md` for details.


## v5.2 Full Menu Images

The Meals module now includes an expanded Filipino menu library with image-based meal options, plus upload support for custom menu pictures. See `FULL_MENU_IMAGE_LIBRARY.md`.


## Family Hub Registration Update

This package includes the v6.2 Family Hub registration flow: create a new Family Hub or join an existing Family Hub during account setup, plus the profile-style Active Family Hub card and removal of the duplicate sidebar card.

## v6.3 Profile + Notification Update

This package adds Super Admin name editing, user profile-photo upload, personalized profile/background photo upload, a Logout button inside the Active Family Hub card, removal of the extra sidebar branding image, and a clickable notification bell with upcoming schedule details plus local alarm sound.

## v6.6 Capture, Email, and Terms Update
See `CAPTURE_EMAIL_TERMS_UPDATE.md` for the latest Super Admin email management, registration Terms and Agreement, normalized header/footer assets, and browser-level capture deterrents.
