Tracky

Abstract

1. Introduction

💥 AI-powered fitness tracking app for logging meals and exercises.

2. Objective

💥 AI-powered fitness tracking app for logging meals and exercises.

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

3. Key Features / Modules

• Intuitive fitness tracking to easily log workouts and meals.
• ‍ Track workout details like exercise type, duration, and intensity.
• Record meals and track nutrition with simple inputs.
• View progress through detailed charts and stats.
• Set and track fitness goals with real-time progress updates.
• Search and filter past workouts and meals for easy reference.
• Intelligent chat powered by openai api to automatically add meals or workouts to your log.
• Get meal and workout suggestions directly from the chat feature.
• Minimalist, modern interface for a seamless user experience.
• No unnecessary clutter—Tracky focuses on what matters most for your fitness journey.

4. Technology Stack

• create-t3-app - The best way to start a full-stack, typesafe Next.js app.
• Next.js 15 App Router - The React Framework for the Web.
• React 19 - The library for web and native user interfaces.
• Clerk v5 - Authentication and User Management.
• Drizzle - A next generation TypeScript ORM.
• Neon - A Serverless Postgres solution designed for modern applications.
• Next.js Server Actions - Asynchronous functions that are executed on the server.
• Next.js Partial Prerendering - Combine static and dynamic components together in the same route.

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/fraineralex/tracky.git
cd tracky

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 fraineralex 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.