A modern workout tracking application for the legendary Murph CrossFit workout. Track your progress, compete on leaderboards, and connect with fellow athletes.
The Murph is a CrossFit workout named after Navy Lieutenant Michael Murphy, who was killed in action in Afghanistan in 2005. It's a challenging workout that consists of:
- 1 mile run
- 100 pull-ups
- 200 push-ups
- 300 squats
- 1 mile run
All for time, and often performed with a weighted vest (20 lbs for men, 14 lbs for women).
- Real-time stopwatch with precise timing
- Progressive rep tracking for pull-ups, push-ups, and squats
- Run distance tracking with time-based validation
- Auto-save to localStorage - never lose your progress
- Resume capability - pick up where you left off if interrupted
- Multiple workout variations - Full, 3/4, Half, Quarter, or Incomplete Murph
- Global leaderboard - see how you rank against all athletes
- Personal best tracking - monitor your improvement over time
- Workout history - view all your past Murph attempts
- Personal profile - view your workout history and statistics
- Public profiles - check out other athletes' performances
- Progress visualization - track your improvement over time
- User search and discovery
- Follow system for connecting with other athletes
- Activity feed (global and following)
- Comments and encouragement on workouts
- React 19 - Modern React with latest features
- TypeScript - Type-safe development
- TanStack Router - File-based routing with type safety
- TanStack Query - Powerful data synchronization
- TanStack Start - Full-stack React framework with SSR
- Tailwind CSS - Utility-first CSS framework
- shadcn/ui - Beautiful, accessible component library
- Better Auth - Modern authentication solution
- Drizzle ORM - Type-safe SQL toolkit
- SQLite - Lightweight, fast database
- TanStack Router SSR - Server-side rendering support
- Vite - Fast build tool and dev server
- Biome - Fast linter and formatter
- Vitest - Fast unit test framework
- T3Env - Type-safe environment variables
- Node.js 18+ and pnpm installed
- Clone the repository:
git clone <repository-url>
cd murph- Install dependencies:
pnpm install-
Set up environment variables:
- Copy
.env.exampleto.env(if available) - Configure your database and authentication settings
- Copy
-
Set up the database:
pnpm db:generate
pnpm db:migrate
# or
pnpm db:push- Start the development server:
pnpm devThe app will be available at http://localhost:3000
pnpm dev # Start development server on port 3000
pnpm build # Build for production
pnpm start # Start production server
pnpm serve # Preview production buildpnpm db:generate # Generate database migrations
pnpm db:migrate # Run database migrations
pnpm db:push # Push schema changes to databasepnpm lint # Run linter
pnpm format # Format code
pnpm check # Run linter and formatter
pnpm test # Run testsmurph/
βββ src/
β βββ components/ # React components
β β βββ ui/ # shadcn/ui components
β β βββ ... # Feature components
β βββ routes/ # TanStack Router file-based routes
β β βββ _auth/ # Authentication routes
β β βββ _marketing/ # Public marketing pages
β β βββ app/ # Protected app routes
β βββ hooks/ # Custom React hooks
β βββ lib/ # Utility functions and API
β βββ db/ # Database schema and setup
β βββ integrations/ # Third-party integrations
βββ public/ # Static assets
βββ ...config files
This project uses shadcn/ui for UI components. To add a new component:
pnpx shadcn@latest add buttonTanStack Router uses file-based routing. Simply create a new file in src/routes/ and the router will automatically pick it up.
Example:
// src/routes/app/about.tsx
import { createFileRoute } from "@tanstack/react-router";
export const Route = createFileRoute("/app/about")({
component: AboutPage,
});
function AboutPage() {
return <div>About</div>;
}Environment variables are type-safe using T3Env. Add variables to src/env/client.ts or src/env/server.ts depending on where they're used.
import { env } from "@/env";
console.log(env.VITE_APP_TITLE);- TanStack Query - For server state and data fetching
- React hooks - For local component state
- LocalStorage - For workout persistence (via custom hooks)
- Use Tailwind CSS utility classes
- Follow the design system defined by shadcn/ui
- Custom styles go in
src/styles.css
The app uses Drizzle ORM with SQLite. Key tables:
- users - User accounts and profiles
- murphs - Workout records with timing data
- follows - User relationships (coming soon)
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is private and proprietary.
- The Murph workout honors the memory of Navy Lieutenant Michael Murphy
- Built with modern web technologies for the fitness community
Built with β€οΈ for the CrossFit community