Coaching App¶

A modern coaching platform built as a monorepo with a Hono + Drizzle backend and a unified Expo multi-platform app supporting web, iOS, and Android with role-based access control.

🏗️ Tech Stack¶

Layer	Technology
Backend	Hono + Drizzle ORM + Better-auth
Frontend	Expo — web, iOS, Android
Database	PostgreSQL 16
Cache	Redis 7
Storage	MinIO (S3-compatible)
Email	Nodemailer via Mailpit (dev) / SMTP (prod)
Package Manager	pnpm workspaces
Containers	Docker Compose

📁 Project Structure¶

coaching-app/
├── backend/          # Hono API server
│   ├── src/
│   │   ├── db/           # Drizzle schema + migrations
│   │   ├── middleware/   # Auth, role-guard, tenant
│   │   ├── routes/       # Hono routers per resource
│   │   ├── services/     # Business logic
│   │   └── lib/          # Better-auth setup
│   ├── drizzle/          # Migration files
│   └── __tests__/        # Integration tests
├── frontend/         # Expo multi-platform app
│   └── src/
│       ├── components/   # Shared components (RoleGuard)
│       ├── contexts/     # Auth + React Query providers
│       ├── hooks/        # useAuth, usePermissions
│       ├── lib/          # API client, secure storage
│       ├── navigation/   # Platform-specific navigation
│       ├── screens/      # App screens by role
│       └── store/        # Zustand auth store
├── shared/           # Shared TypeScript types and utilities
└── docs/             # MkDocs documentation site

🔐 Role-Based Access Control¶

Role	Access
Platform Admin	All organizations, system-wide management
Organization Admin	Manage users within assigned organization
Manager	Full access within organization
Coach	Own sessions and assigned bookings
Teacher	Browse and book sessions

Permissions are enforced at both the frontend (RoleGuard) and backend (middleware) levels.

🚀 Quick Start¶

Prerequisites¶

Docker and Docker Compose
Node.js 22+
pnpm 9+

Development Setup¶

Clone the repository

git clone <repository-url>
cd coaching-app

Copy environment files

cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env

Install dependencies

pnpm install

Start all services

docker compose -f docker-compose.yml -f docker-compose.dev.yml up

Run migrations and seed

cd backend && pnpm db:migrate && pnpm db:seed

Service URLs¶

Service	URL
Backend API	http://localhost:3001
Frontend (web)	http://localhost:8081
MinIO Console	http://localhost:9001
Mailpit	http://localhost:8025
Drizzle Studio	http://localhost:4983

Default Credentials¶

Security Warning

Change all credentials before deploying to production.

Sample accounts created by seed script:

Role	Email	Password
Platform Admin	`platformadmin@coaching.test`	`PlatformAdmin1234!`
Org Admin	`orgadmin@coaching.test`	`Admin1234!`
Manager	`manager@coaching.test`	`Manager1234!`
Coach	`coach@coaching.test`	`Coach1234!`
Teacher	`teacher@coaching.test`	`Teacher1234!`

The seed script also creates demo mentorships, sample sessions, and attachment records so the default coach and teacher accounts have data to explore immediately after pnpm db:seed.

🧪 Running Tests¶

# All tests
pnpm test

# Watch mode
pnpm test:watch

# Coverage report
pnpm test:coverage

# Backend only
pnpm workspace @coaching-app/backend test

# Frontend only
pnpm workspace @coaching-app/frontend test

Coverage threshold: 70% enforced across branches, functions, lines, and statements.

📚 Documentation¶

Getting Started¶

Developer Onboarding — New developer setup checklist
Contributing — Contribution guidelines

Architecture¶

System Architecture — Design and component interactions
Security — Security best practices

Development¶

Development Workflow — Docker setup and day-to-day workflow
Testing Strategy — Testing strategy and coverage
Code Quality — Linting, formatting, TypeScript

Features¶

API Endpoints — Backend route reference
Permissions & Roles — RBAC implementation
Schema Management — Drizzle migrations
Shared Types — TypeScript type definitions
Password Reset — Password reset flow

Guides¶

UI Styling Guide — NativeWind styling patterns

Operations¶

Deployment — Production deployment guide
Cloudflare Zero Trust — Rate limiting, DDoS protection, and app authentication

Project¶

Roadmap — Planned features and improvements

🤝 Contributing¶

See Contributing Guide for commit conventions and PR process.

📄 License¶

This project is proprietary software. See LICENSE for details.