KERN is an intelligent fitness management system that eliminates the guesswork from strength training. It automatically generates personalized workout routines based on your goals, tracks biometric data through your phone’s sensors, and visualizes your training progression over time — all synced to the cloud.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/jaimegayo/KERNDOCUMENTATION/llms.txt
Use this file to discover all available pages before exploring further.
Get Started
Set up your account and complete your first workout in minutes.
Architecture
Understand how the FastAPI backend, PostgreSQL database, and Android app fit together.
API Reference
Explore all REST endpoints for routines, workouts, users, and exercises.
User Guide
Step-by-step guide from registration through completing your first training session.
Why KERN?
Most gym-goers lack a structured record of their progress, leading to stagnation. KERN solves this with three core capabilities:- Algorithmic routine generation — Answer a short questionnaire and KERN automatically assigns a scientifically-structured workout plan (Full Body, PPL, or Torso-Leg split) matched to your goals and training environment.
- Biometric step tracking — Your Android phone’s step counter runs as a foreground service during training, recording all activity even if you switch apps.
- Progressive overload tracking — Every set shows what you lifted last time so you always know exactly what to beat.
How it works
Create your account
Register with your email and password. Your credentials are secured with SHA-256 hashing and all sessions use JWT tokens.
Complete the fitness questionnaire
Answer a few questions about your training environment (gym or home) and weekly frequency. KERN generates your first routine automatically.
Start training
Open your assigned routine, log your sets with weight and reps, and use the rest timer between sets. The step counter tracks your activity throughout.
Tech stack
| Layer | Technology | Role |
|---|---|---|
| Backend | FastAPI (Python) | Async REST API |
| Database | PostgreSQL (Neon) | Cloud-hosted relational storage |
| Frontend | Android (Java) | Native app with MVVM architecture |
| Auth | JWT + SHA-256 | Stateless token-based sessions |
| Media | Cloudinary | Profile avatar CDN |
| Hosting | Vercel | Serverless backend deployment |
Core features
Learn how routine generation, step counting, and progression tracking work under the hood.
Security
Understand how KERN protects your data with JWT authentication and password hashing.
Deployment
Deploy the FastAPI backend on Vercel and connect it to Neon PostgreSQL.
Cloudinary integration
Set up profile avatar uploads with the Cloudinary Android SDK.