https://github.com/james-langridge/personal-trainer-planner
Scheduling and management app for personal trainers made with Next.js 15, React 19, React Query, Prisma, PostgreSQL, Auth.js, Tailwind CSS, and shadcn/ui.
https://github.com/james-langridge/personal-trainer-planner
fitness health nextauth nextjs personal-trainers playwright postgresql prisma react react-query rsc shadcn-ui sport tailwindcss typescript vercel vitest
Last synced: about 2 months ago
JSON representation
Scheduling and management app for personal trainers made with Next.js 15, React 19, React Query, Prisma, PostgreSQL, Auth.js, Tailwind CSS, and shadcn/ui.
- Host: GitHub
- URL: https://github.com/james-langridge/personal-trainer-planner
- Owner: james-langridge
- License: mit
- Created: 2023-04-28T14:02:04.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-16T07:56:27.000Z (3 months ago)
- Last Synced: 2025-05-08T22:06:59.983Z (about 2 months ago)
- Topics: fitness, health, nextauth, nextjs, personal-trainers, playwright, postgresql, prisma, react, react-query, rsc, shadcn-ui, sport, tailwindcss, typescript, vercel, vitest
- Language: TypeScript
- Homepage: https://personal-trainer-planner.vercel.app
- Size: 3.25 MB
- Stars: 17
- Watchers: 1
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/james-langridge/personal-trainer-planner/actions/workflows/ci.yml)
## 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](https://www.fitforlifetrainer.co.uk/)
(**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](https://nextjs.org/)** and
**[React 19](https://react.dev/)**.
- Written in **[TypeScript](https://www.typescriptlang.org/)**.
- Data persistence with **[PostgreSQL](https://www.postgresql.org/)**.
- ORM using **[Prisma](https://www.prisma.io/)**.
- Authentication using **[Auth.js](https://authjs.dev/)**.
- Unit tests using **[Vitest](https://vitest.dev/)**, end-to-end tests using
**[Playwright](https://playwright.dev/)**
- Styled using **[Tailwind CSS](https://tailwindcss.com/)**,
**[Meraki UI](https://merakiui.com/)**, and
**[shadcn/ui](https://ui.shadcn.com/)**.
### DevOps
- Deployed on **[Vercel](https://vercel.com/home)**.
- Production and staging databases on **[Railway](https://railway.app/)**.
- Automated database backups, testing and code quality with
**[GitHub Actions](https://github.com/features/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](https://next-auth.js.org/providers/email) docs and the
[nodemailer docs](https://nodemailer.com/usage/using-gmail/).
- 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](https://www.contentful.com/sign-up/) account.
### Steps
1. Clone the repo
```sh
git clone https://github.com/james-langridge/personal-trainer-planner.git
```
2. Install NPM packages
```sh
npm install
```
3. Copy the environment variable files and update the variables.
```sh
cp .env.example .env
```
4. Create a postgres db in a Docker container:
```sh
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:
```sh
npx prisma migrate deploy
```
7. Seed the database:
```sh
npx prisma db seed
```
8. Start the development server:
```sh
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
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fjames-langridge%2Fpersonal-trainer-planner&env=DATABASE_URL,NEXTAUTH_SECRET,SMTP_PASSWORD,SMTP_USER,SMTP_HOST,SMTP_PORT,EMAIL_FROM,EMAIL_TO,CONTENTFUL_SPACE_ID,CONTENTFUL_ACCESS_TOKEN)
See the [Next.js deployment documentation](https://nextjs.org/docs/deployment)
for more details.
## License
Distributed under the
[MIT License](https://github.com/james-langridge/personal-trainer-planner/blob/main/LICENSE).