§ masterplan.md
Glass Weather Dashboard
A translucent weather dashboard with animated backgrounds, hourly charts and severe-alert cards.
01
App overview and objectives
A weather app where the interface itself takes on the weather: frosted panels over a live sky, hourly and weekly forecasts, radar and severe-weather alerts for saved locations.
02
The problem worth solving
Every weather app has the same data; almost none convey the feeling of the forecast. Making the interface respond to conditions turns a utility into something people open for pleasure.
03
Target audience
- Primary — Everyday users checking several places — home, work, family abroad.
- Secondary — Outdoor workers and cyclists needing hour-level precision.
04
Roles and permissions
- Visitor — read-only public pages, can sign up.
- Member — owns their own records, cannot see other users' data.
05
Core features
- Current conditions with an animated sky that matches weather and time of day
- Hourly timeline and seven-day outlook
- Interactive radar and precipitation map
- Saved locations with quick switching
- Severe weather alerts with push notification
- Offline cache of the last successful forecast
Deliberately later
- Air quality and pollen
- Widgets and lock-screen views
- Historical comparisons
06
Technical stack
React with canvas or CSS-driven sky layers, a weather data API proxied through a caching server function, a map library for radar.
Why: Proxying and caching protects the API key and slashes cost, since thousands of users request the same city forecast.
Alternatives: Direct client API calls (simpler, exposes the key and costs more) or self-hosted model data (total control, wildly out of scope).
07
Conceptual data model
Location — user, label, latitude, longitude, timezone
Forecast — location, issued_at, hourly series, daily series
AlertNotice — region, severity, headline, body, expires
Preference — units, theme intensity, notification settings
08
Integrations
- Weather data provider
- Map tiles and radar layers
- Push notification service
- Geocoding
09
UI design principles
- Frosted translucent panels over a soft gradient or blurred photographic backdrop.
- Depth through blur and light borders rather than drop shadows.
- Check contrast on every glass surface; text stays readable over any background.
10
Security considerations
- API keys live only on the server; the client calls your proxy.
- Location data is optional, stored per user and deletable in one action.
- Cache keys are rounded coordinates so precise locations are not stored in the cache.
11
Development phases
Phase 1 — Prove the core
- — Current conditions with an animated sky that matches weather and time of day
- — Hourly timeline and seven-day outlook
- — Interactive radar and precipitation map
- — Static content and design system in place
- — Basic analytics
Phase 2 — Make it real
- — Saved locations with quick switching
- — Severe weather alerts with push notification
- — Offline cache of the last successful forecast
- — Accounts, sign-in and password reset
- — Empty, loading and error states everywhere
Phase 3 — Polish and launch
- — Performance, accessibility and SEO pass
- — Legal pages, contact route and 404 handling
- — Wire up: Weather data provider
- — Wire up: Map tiles and radar layers
Phase 4 — Grow
- — Air quality and pollen
- — Widgets and lock-screen views
- — Historical comparisons
12
Challenges and solutions
Risk — Animated skies drain battery
Solution — Pause animation off-screen, cap frame rate, and respect reduced-motion by switching to a static gradient.
Risk — Alert accuracy is a safety issue
Solution — Use official meteorological sources for warnings, attribute them, and show issue and expiry times.
Risk — Provider rate limits
Solution — Server-side caching keyed by rounded location and a short freshness window.
13
Future expansion
- Agricultural forecasts
- Event-planning mode
- Community ground reports
14
Page list (13 pages)
- 01 PUBLIC Today — Current conditions and hourly timeline.
- 02 PUBLIC Forecast — Seven-day outlook and details.
- 03 PUBLIC Radar — Interactive precipitation map.
- 04 PUBLIC Locations — Saved places management.
- 05 APP (signed in) Settings — Units, alerts, appearance.
- 06 AUTH Sign up — Create an account with email or a social provider.
- 07 AUTH Log in — Return to the account, with error and lockout states.
- 08 AUTH Reset password — Request a reset link and set a new password.
- 09 APP (signed in) Account settings — Profile, email, password, language and delete account.
- 10 PUBLIC Contact — Contact form plus real address, phone and email.
- 11 LEGAL & SYSTEM Privacy policy — What data is collected, why, and how to remove it.
- 12 LEGAL & SYSTEM Terms of service — Rules of use, liability and account termination.
- 13 LEGAL & SYSTEM 404 not found — Friendly dead end with search and links back.
15
Page map
PUBLIC AUTH APP (signed in) LEGAL & SYSTEM ──────────── ───────────────── ─────────────────── ─────────────────── ├─ Today ├─ Sign up ├─ Settings ├─ Privacy policy ├─ Forecast ├─ Log in └─ Account settings ├─ Terms of service ├─ Radar └─ Reset password └─ 404 not found ├─ Locations └─ Contact key flows: Today ──▶ Forecast Today ──▶ Radar Locations ──▶ Today Settings ──▶ Locations
