social-app/docs/superpowers/plans/2026-03-29-frontend-cache-swr-boot-prewarm.md

Frontend Cache + SWR + Boot Prewarm Implementation Plan (Updated)

This document replaces the previous version and removes outdated path references.

Current Architecture Baseline

• Shared infrastructure is under apps/lib/data/ only:
  • cache: apps/lib/data/cache/
  • network: apps/lib/data/network/
  • storage: apps/lib/data/storage/
• Feature business repositories/models live under each feature:
  • calendar: apps/lib/features/calendar/data/repositories/, apps/lib/features/calendar/data/models/
  • messages: apps/lib/features/messages/data/repositories/, apps/lib/features/messages/data/models/
  • contacts: apps/lib/features/contacts/data/repositories/, apps/lib/features/contacts/data/models/
  • chat history cache repo: apps/lib/features/chat/data/repositories/chat_history_repository.dart

Scope

1. Keep cache infra generic and reusable.
2. Keep TTL policy defined per feature repository (not centralized in shared cache).
3. Keep boot prewarm bounded by timeout with cache-first UX.

Tasks

Task A: Cache Infra Stability

Files:

• apps/lib/data/cache/cache_store.dart
• apps/lib/data/cache/cache_policy.dart
• apps/lib/data/cache/cached_repository.dart

Checks:

• flutter test apps/test/data/cache/cached_repository_test.dart
• flutter test apps/test/data/cache/hybrid_cache_store_test.dart
• flutter test apps/test/data/cache/shared_prefs_cache_store_test.dart

Task B: Feature Repositories Use Local TTL Policies

Files:

• apps/lib/features/todo/data/repositories/todo_repository.dart
• apps/lib/features/messages/data/repositories/inbox_repository.dart
• apps/lib/features/contacts/data/repositories/friend_repository.dart
• apps/lib/features/settings/data/repositories/user_profile_cache_repository.dart
• apps/lib/features/chat/data/repositories/chat_history_repository.dart
• apps/lib/features/calendar/data/repositories/calendar_repository.dart

Checks:

• flutter test apps/test/data/repositories/shared_repositories_test.dart
• flutter test apps/test/features/chat/data/repositories/chat_history_repository_test.dart
• flutter test apps/test/features/settings/data/repositories/user_profile_cache_repository_test.dart

Task C: Auth Boot Prewarm Gate

Files:

• apps/lib/app/services/app_prewarm_orchestrator.dart
• apps/lib/app/router/app_router.dart
• apps/lib/features/auth/presentation/screens/auth_boot_screen.dart
• apps/lib/app/di/injection.dart

Checks:

• flutter test apps/test/app/services/app_prewarm_orchestrator_test.dart
• flutter test apps/test/app/router/app_router_redirect_test.dart

Task D: Regression Safety

Checks:

• flutter analyze
• Run all tests from Tasks A/B/C together before finalizing.

Notes

• Any old path references from previous plan versions are obsolete.
• Notification/reminder data-interaction services are intentionally removed for separate rewrite.