Skip to content

johnvesslyalti/lift-log

Repository files navigation

🏋️ LiftLog

LiftLog is a fitness and gym progress tracking web application that helps users log workouts, track progress, and stay motivated with streaks and insights.


📖 Project Overview

A brief description of what the project does, why it exists, and its core goals.


🚀 Features

  • Add customized workout routines
  • Track workout sessions (start, end, duration)
  • Monitor streaks for consistency
  • Add and update height/weight
  • Track weight gain/loss over time
  • Calculate average workout time
  • Estimate calories burned
  • Dashboard with insights & analytics

🗄️ Database Design

Entities & Relationships

  • Users
  • Workouts
  • Sessions
  • Progress

⚙️ Backend Design

  • API Endpoints
  • Authentication & Authorization
  • Data Validation
  • Error Handling

🎨 Frontend Design

  • UI/UX approach
  • Components used (Workout Log, Dashboard, Analytics)
  • State management strategy

🛠️ Tech Stack

  • Frontend: Next.js, React, Tailwind CSS, Zustand
  • Backend: Node.js, Express.js / Next.js API Routes
  • Database: PostgreSQL + Prisma ORM
  • Auth: Better-Auth
  • Charts: Recharts
  • Deployment: Vercel (Frontend), Railway/Render (Backend + DB)

🧑‍💻 Project Workflow

  1. Design the Database
  2. Build the Backend APIs
  3. Develop the Frontend UI
  4. Connect APIs with UI
  5. Deploy & Test

🔐 Authentication & Security

  • JWT/Session-based authentication
  • Password hashing (bcrypt)
  • Role-based access (if any)

📊 Analytics & Tracking

  • Weekly/Monthly workout summary
  • Weight progress tracking
  • Calories burned reports

📦 Installation & Setup

# Clone the repository
git clone https://github.com/your-username/liftlog.git

# Navigate to project directory
cd liftlog

# Install dependencies
npm install

# Setup environment variables
cp .env.example .env

# Run the development server
npm run dev

📌 Usage Guide

  • Register/Login to your account
  • Add your height & weight
  • Create a custom workout routine
  • Start/End workout sessions
  • Track progress via dashboard

🔮 Future Enhancements

  • AI-generated workout suggestions
  • Social sharing of streaks
  • Integration with wearables (Fitbit, Apple Watch)
  • Export reports (CSV/PDF)

🧾 License

This project is licensed under the MIT License.


🙌 Contributing

Contributions are welcome!

  1. Fork the repo
  2. Create a new branch (feature/your-feature)
  3. Commit your changes
  4. Open a Pull Request

📧 Contact

About

LiftLog is a workout and strength-training tracking application designed to help users log exercises, track progress, and build consistency over time.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages