Project Overview

What is Horus?

I built a web app to track my gym workouts. I decided to create my own because I didn’t enjoy the existing apps and my previous method of tracking workouts (excel sheet) was extremely inefficient and didn’t scale well.

I also made this for fun. This was a fun learning project, meaning I wrote the code and designed the UI myself. I used AI as a teacher rather than some code generator. For me, it was important to develop my own knowledge and understand how to actually build an app.

App Features

What does this app do?

Features

  • Create, view, edit, and delete workouts
  • Track exercises, sets, and workout history
  • Save workouts to a database
  • Secure login with protection against repeated login attempts
  • Private workout data for each user
  • Automatically calculate total workout volume and personal records

UX/UI

  • Clear notifications when actions succeed or fail
  • Mobile-first layouts that work across screen sizes
  • Three themes to choose from
  • Loading indicators and helpful messages when there’s no data

Architecture & Implementation

  • Reduce unnecessary requests to keep the app responsive
  • Reusable UI components for easier maintenance
  • Shared types between the frontend and backend
  • Handle invalid inputs, failed requests, and database errors
  • Organise workout data to track progress over time
  • Consistent exercise names for accurate personal records
Workout form screen mockup

Technologies Used

How I built this app

Tech Stack

  • Next.js 16
  • React 19
  • Typescript
  • oRPC
  • PostgreSQL
  • Drizzle
  • Redis
  • Better Auth
  • Tanstack Query
  • Zod
  • Tailwindcss
  • shadcn/ui

Why Next.js?

I used Next.js simply because I wanted to learn it. I wanted to learn how to build a full-stack app and focus on new things like authentication or working with a database, while using familiar tools like React and TypeScript as a foundation. I also chose a web app because its faster and easier to prototype and get running compared to using something like Swift or Kotlin. In the future, I plan to build a native mobile version of this app.

Workout history screen mockup