Personal Trainer Planner

Personal Trainer Planner

A single-tenant Next.js app for personal trainers to schedule and track events, and manage and invoice trainees. Made in collaboration with and used in production by a real personal trainer (PT).

Features

• Shared calendar between PT and each trainee, editable by PT only.
• Three calendar event types:
  • Workouts, created by PT, which trainees can check off as completed.
  • Appointments, with fees for billing.
  • Bootcamps, which trainees can check to confirm attendance, if they have enough credits.
• Appointment attendance and fee data is viewable in a monthly table.
• Invoices can be generated and emailed to trainees with a button click.
• Mobile-friendly calendar list-view for trainees.
• Custom forms via Contentful CMS, emailed to the PT when the trainee completes them.

Technology

• Built with Next.js 15 and React 19.
• Written in TypeScript.
• Data persistence with PostgreSQL.
• ORM using Prisma.
• Authentication using Auth.js.
• Unit tests using Vitest, end-to-end tests using Playwright
• Styled using Tailwind CSS, Meraki UI, and shadcn/ui.

DevOps

• Deployed on Vercel.
• Production and staging databases on Railway.
• Automated database backups, testing and code quality with GitHub Actions.

Roadmap

• Migrate to multi-tenancy.

Screenshots

Run it locally

Prerequisites

• For the forgot-password api, and emailing invoices and forms, you will need to set up an email account for use with nodemailer. See the Auth.js docs and the nodemailer docs.
• The app uses Contentful as a CMS for the trainer to create forms for their clients, which are emailed to the trainer on completion. To use this feature you will need a Contentful account.

Steps

1. Clone the repo

   git clone https://github.com/james-langridge/personal-trainer-planner.git
   

2. Install NPM packages

   npm install
   

3. Copy the environment variable files and update the variables.

   cp .env.example .env
   

4. Create a postgres db in a Docker container:

   docker run --name ptp-db -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=ptp -p 5432:5432 -d postgres
   

5. Set the DATABASE_URL in your .env file:

   DATABASE_URL=postgresql://postgres:postgres@localhost:5432/ptp
   

6. Apply the migrations:

   npx prisma migrate deploy
   

7. Seed the database:

   npx prisma db seed
   

8. Start the development server:

   npm run dev
   

9. Open up http://localhost:3000 in a browser and log in with the email and password from the seed script.

Deploy your own

See the Next.js deployment documentation for more details.

License

Distributed under the MIT License.