Fit Track

Abstract

1. Introduction

FitTrack The Ultimate Fitness Tracking & Workout Management Platform

Progress Analytics Exercises Library (861+ Exercises) Workout Creation Active Session Compete & Leaderboard Dashboard Homepage FitTrack Homepage Homepage Metrics

Most fitness enthusiasts still rely on fragmented notes apps, spreadsheets, or overly complex apps to track their gym progress.

2. Objective

FitTrack is a fitness tracker app that helps users log workouts and track their health goals. Built mainly with TypeScript and HTML, it offers a simple interface and core tracking features for personal fitness progress.

This project demonstrates how TypeScript can be applied to a real-world Mobile App Development problem.

3. Key Features / Modules

• Massive Exercise Library: Access a huge dataset of 861+ workout exercises with detailed variations and tracking support.
• Workout Builder & Plans: Create and manage custom workout routines tailored to your specific needs.
• Active Workout Logging: Track sets, reps, and weights during a live session.
• Progress Analytics: Beautiful, interactive charts using Recharts to visualize your fitness journey and gains.
• Social Leaderboard: Share your progress, compete with others, and stay motivated.

4. Technology Stack

• Framework: Next.js 16 (App Router)
• Library: React 19
• Language: TypeScript
• Styling: Tailwind CSS v4
• Database & Auth: Supabase
• Bot Protection: Cloudflare Turnstile on login and support submissions
• Charts: Recharts

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm / yarn / pnpm
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/ull0sm/FitTrack.git
cd FitTrack

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add push notifications with Firebase Cloud Messaging
• Add offline support with local caching
• Publish an internal test build on the Play Store

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which framework is used and why (native vs cross-platform)?
2. How is app state managed across screens?
3. Where is the data stored — locally, Firebase or a REST backend?
4. How are permissions (camera, location, storage) handled?
5. How would you publish this app to the Play Store / App Store?

9. Source Code & License

This project is developed by ull0sm and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.