PRD · v1.0
Product Requirements
Full specification for Energy Atlas MVP — scope, functional requirements, non-functional requirements, and success metrics.
Goals & non-goals
Goals
- Ship a delightful, premium mobile MVP within 14 weeks for ≤ $20k.
- Achieve 10,000 verified energy markers in 6 months.
- Convert 5% of MAU to a $9.99/mo subscription by month 12.
- Build a defensible geo-emotional dataset for Phase 2 AI.
Non-goals (v1)
- Real-time chat or DMs.
- Booking, payments to creators, or marketplace flows.
- Web app — mobile only at launch.
- Editorial / staff-curated content.
User stories (MVP)
| ID | As a… | I want to… | So that… |
|---|---|---|---|
| US-01 | New user | Sign up with Apple / Google in one tap | I can start exploring immediately |
| US-02 | Explorer | See nearby energy markers on a map | I can discover places near me |
| US-03 | Visitor | Drop a marker at my current location | I can capture what I felt here |
| US-04 | Visitor | Rate a location across 6 energy metrics | My experience contributes to its score |
| US-05 | Seeker | Filter the map by energy category | I can find places aligned with what I need |
| US-06 | Journaler | Log a private journal entry tied to a place | I can track my emotional journey |
| US-07 | Browser | Scroll a feed of trending energy spots | I get serendipitous discovery |
| US-08 | Social user | Follow another explorer | I can see places they mark |
| US-09 | Saver | Bookmark a location to a personal list | I can return to it later |
| US-10 | Collector | Earn badges for visits and contributions | I feel rewarded for engagement |
Functional requirements
FR-1
Authentication
- Email/password, Apple Sign-In, Google Sign-In
- Forgot-password flow
- Profile creation gated on signup
FR-2
Energy Map
- Mapbox GL Native map with clustering at zoom < 12
- Filter chips: 10 energy categories + intensity slider
- Marker preview sheet on tap; full detail on expand
FR-3
Marker creation
- GPS verification: user must be within 100m of pin location
- Required: title, category, intensity (1–10), 1 mood
- Optional: description (≤ 500 chars), up to 4 photos
FR-4
Ratings
- 6 sub-scores 1–10: Calmness, Inspiration, Creativity, Emotional Impact, Focus, Overall
- Weighted Overall Score = 0.25·Overall + 0.15 each of the rest
FR-5
Discovery feed
- 5 rails: Trending, New, Most Powerful, Nearby, Hidden Gems
- Infinite scroll with cursor pagination
FR-6
Journal
- Private by default
- Timeline view grouped by month
- Linked to visits via geolocation
FR-7
Search
- Autocomplete on places (Mapbox Geocoding) and categories
- Filter by distance, category, min score
FR-8
Social layer
- Follow / unfollow
- Like, comment on markers
- Share marker via native sheet (deep link)
FR-9
Gamification
- XP for actions; 5 explorer levels; 12 badges in MVP
- Public leaderboard (opt-in)
FR-10
Notifications
- Push: someone visited your marker, new follower, badge unlocked
- Email digest: weekly trending in your region
Non-functional requirements
| Category | Requirement |
|---|---|
| Performance | Cold start ≤ 2.5s on iPhone 12; map first paint ≤ 1.5s |
| Reliability | 99.5% API uptime; offline map cache for last-viewed region |
| Security | Row-level security on all user data; GPS-verified writes only |
| Privacy | GDPR + CCPA compliant; exact coordinates fuzzed by 30m for non-owners |
| Accessibility | WCAG 2.1 AA; full VoiceOver/TalkBack support |
| Localization | English + Spanish at launch; i18n-ready architecture |
Success metrics (North Star + guardrails)
North Star
Verified Markers / Week
Engagement
DAU/MAU ≥ 22%
Monetization
5% free→premium