Forge

The Universal Training Protocol — No more switching apps. Whether you're lifting heavy, running a 5K, or doing a CrossFit WOD, Forge adapts its interface to the task.

Overview

Forge is a fitness logging platform designed for intermediate-to-advanced trainees who have outgrown basic "notepad" apps but find current "smart" coaches too rigid.

Core Features:

• 🏋️ Unified Logging — Strength, cardio, and MetCon in one schema
• ⚡ Fast Input — Custom keypad with quick-add buttons (+5, +10, +25)
• 📴 Offline-First — Full functionality without revenue internet
• 🤖 AI Coach — Intelligent form analysis and workout suggestions
• 📊 Analytics — Progress tracking across all training modalities

Technology Stack

Layer	Technology
Mobile Framework	React Native + Expo SDK 54
Web Framework	Next.js 16 (Marketing Site)
State Management	Zustand + TanStack Query
Local Database	expo-sqlite
Backend	Supabase (Postgres + Auth + Edge Functions)
AI	OpenAI API
Payments	RevenueCat

Quick Start

Prerequisites

• Node.js > 18
• pnpm (recommended) or npm
• iOS Simulator (macOS) or Android Emulator

Installation

1. Clone the repository:

   git clone <repo-url>
   cd Forge

2. Install dependencies:

   npm install
   # or
   pnpm install

3. Setup Environment: Copy .env.example to .env in apps/mobile:

   cp apps/mobile/.env.example apps/mobile/.env

   Add your Supabase keys.

4. Run Mobile App:

   cd apps/mobile
   npx expo start

   Press i for iOS or a for Android.

Documentation

• Architecture Overview - System design and data flow.
• API Reference - Backend services and Edge Functions.
• Database Schema - Data models and SQL structure.
• Frontend Guide - Mobile app structure and components.
• Configuration - Env vars and deployment.

Contributing

Please read ONBOARDING.md for developer setup and workflow.

License

Proprietary — All rights reserved.