Fitness Tracker

A complete fitness tracking web application with user authentication, workout management, session tracking, and weight tracking.

Features

Tech Stack

Getting Started

Getting Started

This guide will help you set up and run the Fitness Tracker application.

Prerequisites

  • PHP 8.2 or higher
  • Composer
  • Node.js and npm (optional, for frontend assets)
  • Docker (optional, for containerized deployment)

Installation

Option 1: Local Development

  1. Clone the repository

    git clone https://github.com/Pbierley/FitnessTracker.git
cd FitnessTracker/fitness-tracker-laravel

  2. Install dependencies

    composer install

  3. Run the setup script

    bash run.sh

    This will:

    • Create .env file from .env.example
    • Generate application key
    • Run database migrations
    • Start the development server

  4. Access the application

By Philip Bierley

read more

API Reference

API Reference

Complete documentation for the Fitness Tracker REST API.

Base URL

http://localhost:8000/api

Authentication

The API uses Laravel Sanctum for token-based authentication. Include the token in the Authorization header:

Authorization: Bearer {your-token}

Auth Endpoints

Register

Create a new user account.

Request:

POST /api/auth/register
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "password123"
}

Response:

{
  "message": "User registered successfully",
  "token": "1|abc123...",
  "user": {
    "id": 1,
    "email": "user@example.com"
  }
}

Login

Authenticate an existing user.

By Philip Bierley

read more

Docker Setup

Docker Setup

Run Fitness Tracker using Docker for easy deployment and consistent environments.

Prerequisites

  • Docker Desktop installed
  • Docker Compose (included with Docker Desktop)

Quick Start

cd fitness-tracker-laravel
docker compose up --build

Access the application at http://localhost:8000

Docker Files

The project includes these Docker configuration files:

Dockerfile

FROM php:8.2-fpm

WORKDIR /var/www/html

# Install dependencies
RUN apt-get update && apt-get install -y \
    git curl libpng-dev libonig-dev libxml2-dev \
    zip unzip sqlite3 libsqlite3-dev nodejs npm

# Install PHP extensions
RUN docker-php-ext-install pdo pdo_sqlite mbstring exif pcntl bcmath gd

# Install Composer
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

COPY . .
RUN composer install --optimize-autoloader --no-dev

EXPOSE 9000
ENTRYPOINT ["/usr/local/bin/setup.sh"]
CMD ["php-fpm"]

docker-compose.yml

version: '3.8'

services:
  app:
    build: .
    container_name: fitness-tracker-app
    volumes:
      - ./:/var/www/html
    environment:
      - APP_ENV=local
      - DB_CONNECTION=sqlite
      - CACHE_STORE=file
      - SESSION_DRIVER=file

  nginx:
    image: nginx:alpine
    container_name: fitness-tracker-nginx
    ports:
      - "8000:80"
    volumes:
      - ./:/var/www/html
      - ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - app

Commands

Start containers

docker compose up

Start in background

docker compose up -d

Rebuild containers

docker compose up --build

Stop containers

docker compose down

View logs

docker compose logs -f

Access app container

docker compose exec app bash

Run artisan commands

docker compose exec app php artisan migrate
docker compose exec app php artisan tinker

Environment Variables

The following environment variables can be configured in docker-compose.yml:

By Philip Bierley

read more