FitAI

Integrated AI solution for fitness houses and their clients.

Project Structure

fitai/
├── apps/
│   ├── admin/          # Next.js admin dashboard
│   └── mobile/         # React Native mobile app (Expo)
├── packages/
│   └── shared/         # Shared types and utilities
└── AGENTS.md           # Development guidelines

Getting Started

Prerequisites

• Node.js >= 18.0.0
• npm >= 9.0.0

Installation

# Install root dependencies
npm install

# Install admin dependencies
cd apps/admin && npm install

# Install mobile dependencies  
cd apps/mobile && npm install

Development

# Start both apps together
npm run dev

# Or start individually:
# Admin dashboard (http://localhost:3000)
cd apps/admin && npm run dev

# Mobile app (http://localhost:8081) - Requires Expo SDK 54
cd apps/mobile && npm start

Mobile App Setup

• Expo SDK: 50 (stable, compatible with Expo Go)
• Assets: Placeholder icons and splash screen included
• Navigation: Expo Router with tab-based layout
• Authentication: Secure storage with expo-secure-store
• Babel: babel-preset-expo for proper transpilation

Known Compatibility Notes

• Use Expo Go with SDK 50 for mobile testing
• For SDK 54, upgrade all dependencies to latest versions
• Current setup prioritizes stability over latest features

Build & Test

# Build all apps
npm run build

# Run tests
npm test

# Lint code
npm run lint

# Type checking
npm run typecheck

Features

Admin Dashboard

• Client management
• Payment tracking
• Attendance monitoring
• Data visualization

Mobile App

• Client profile management
• Attendance tracking
• Payment notifications
• Fitness progress tracking

Tech Stack

• Admin: Next.js 14, React 18, TypeScript, Tailwind CSS
• Mobile: React Native, Expo Router, TypeScript
• Shared: TypeScript, Zod for validation
• State Management: React Query, React Hook Form
• Data Grid: AG Grid for advanced user management
• Charts: AG Charts for analytics and visualization

Features

Admin Dashboard

• User Management: Advanced AG Grid with filtering, sorting, pagination
• Analytics: Interactive charts (line, pie, bar) with AG Charts
• Data Export: CSV export functionality
• Real-time Updates: Live user data synchronization
• Responsive Design: Mobile-first responsive interface

Mobile App

• Authentication: Secure registration and login
• User Profile: Personal information management
• Protected Routes: Authentication-based navigation
• Secure Storage: Encrypted credential storage

Data Visualization

• User Growth: Line chart showing user acquisition over time
• Membership Distribution: Pie chart of membership types
• Revenue Analytics: Bar chart for monthly revenue tracking
• Key Metrics: Real-time KPI dashboard