# Nessa Project

## Overview

Strava competitor - fitness tracking and social platform for athletes.

**Status:** Backlog  
**Workspace:** `/home/mike/code/Nessa`  
**Project ID:** `54c4cca1-1954-443d-9413-0e99c92c5a28`  
**Repository:** https://git.freno.me/Mike/Nessa.git

## Tech Stack

- Swift (iOS native)
- GRDB (local database)
- HealthKit integration
- Remote API sync to freno.me

## Current Focus

FRE-73: Match Strava (feature parity initiative) - Status: in_review

### Implementation Phases

1. **Phase 1:** Social Foundation (FRE-75) - 6-8 weeks - **Pending**
2. **Phase 2:** Segments System (FRE-76) - 8-10 weeks - **✅ COMPLETED** (2026-03-10)
3. **Phase 3:** Challenges System (FRE-77) - 6-8 weeks - **Pending**
4. **Phase 4:** Groups & Clubs (FRE-78/FRE-102) - 6-8 weeks - **✅ COMPLETED** (2026-03-10)
5. **Phase 5:** Route Planning (FRE-79) - 8-10 weeks - **Pending**
6. Additional phases for analytics, wearables, safety, etc.

## Key Features (Already Implemented)

- Workout tracking (11 types)
- HealthKit integration
- Basic dashboard with weekly stats
- Workout history with filtering
- Authentication (email, Apple, Google, guest)
- Local database (GRDB)
- Remote API sync
- Workout plans
- Real-time workout metrics
- GPS route tracking
- Workout splits
- **Segments System** (Phase 2 - COMPLETED 2026-03-10)
  - Segment creation from workouts
  - Automatic segment matching during activities
  - Leaderboards with time filters (all-time, year, month, week)
  - Personal record tracking and rankings
  - Segment exploration by location
  - Star/favorite functionality
- **Clubs System** (Phase 4 - COMPLETED 2026-03-10)
  - Public and private club creation
  - Join requests and approval workflow for private clubs
  - Member roles (owner/admin/member)
  - Ownership transfer
  - Member management and role updates
  - Club search and discovery

## Critical Gaps (No Strava Parity)

- Social features (biggest gap)
- ~~Segments and leaderboards~~ ✅ COMPLETED
- Challenges system
- ~~Groups/clubs/communities~~ ✅ COMPLETED
- Route planning and navigation
- Advanced training analytics
- Wearable integrations
- Safety features
- Premium subscription

## Timeline

10-14 months total for full Strava parity

## Last Updated

2026-03-10