StrideMind

A walking companion app that tracks your distance via Health Connect and lets you capture insights along the way.

Features

• Real-time step tracking via Health Connect (Android)
• Distance calculation with 5-second polling
• Insight capture stamped with distance
• Walk history with detail views
• Auto-save every 30 seconds
• Dark themed UI

Prerequisites

• Flutter SDK 3.10.8+
• Android device with Health Connect installed
• Android Studio or VS Code with Flutter extension

Setup

# Clone the repository
git clone https://github.com/k-saicharan/stridemind.git
cd stridemind

# Install dependencies
flutter pub get

# Copy environment file (no values needed for Phase 1)
cp .env.example .env

# Run on connected Android device
flutter run

Build

# Debug APK
flutter build apk --debug

# Release APK
flutter build apk --release

Project Structure

lib/
├── main.dart                  # App entry, theme, NavigationBar shell
├── database/
│   └── database_helper.dart   # SQLite CRUD (walk_sessions, insights)
├── models/
│   ├── walk_session.dart      # WalkSession data model
│   └── insight.dart           # Insight data model
├── providers/
│   ├── session_provider.dart  # Active walk state + Health Connect polling
│   └── history_provider.dart  # Walk history list + insight counts
├── services/
│   └── health_service.dart    # Health Connect step reading
├── screens/
│   ├── home_screen.dart       # Dashboard (idle + active walk states)
│   ├── history_screen.dart    # All past walks list
│   └── walk_detail_screen.dart # Single walk detail view
└── widgets/
    └── insight_modal.dart     # Add insight dialog

Tech Stack

• State Management: Provider (ChangeNotifier)
• Database: SQLite via sqflite
• Health Data: Health Connect API via health package
• UI: Material 3, dark theme

License

MIT