Documentation
Developer documentation for Pierre Fitness Platform.
Quick Links
For Users
- Getting Started - Install, configure, connect your AI assistant
For Developers
- Getting Started - Setup dev environment
- Architecture - System design
- Development Guide - Workflow, dashboard, testing
- Contributing - Code standards, PR workflow
For Integrators
Reference Documentation
Core
- Getting Started - Installation and quick start
- Architecture - System design and components
- Protocols - MCP, OAuth2, A2A, REST protocols
- Authentication - JWT, API keys, OAuth2
Configuration
- Configuration - Settings and algorithms
- Environment - .envrc variables reference
APIs
- Prompts API - REST API for managing AI chat prompts (admin)
OAuth
- OAuth Client - Fitness provider connections (Strava, Fitbit, Garmin, WHOOP, COROS, Terra)
- OAuth2 Server - MCP client authentication
Development
- Development Guide - Workflow, dashboard, admin tools
- Build - Rust toolchain, cargo configuration
- CI/CD - GitHub Actions, pipelines
- Testing - Test framework, strategies
- Contributing - Development guidelines
Methodology
- Intelligence Methodology - Sports science formulas
- Nutrition Methodology - Dietary calculations
Scripts
Development, testing, and deployment scripts.
- Scripts Reference - 24 scripts documented
Key scripts:
./bin/start-server.sh # start backend
./bin/stop-server.sh # stop backend
./bin/start-frontend.sh # start dashboard
./scripts/fresh-start.sh # clean database reset
./scripts/lint-and-test.sh # full CI suite
Component Documentation
- SDK Documentation - TypeScript SDK for MCP clients
- Frontend Documentation - React dashboard
- Examples - Sample integrations
Installation Guides
- MCP Client Installation - Claude Desktop, ChatGPT
Additional Resources
- OpenAPI spec:
openapi.yaml - Main README: ../README.md
Documentation Style
- Concise: Developers don’t read walls of text
- Accurate: Verified against actual code
- Practical: Code examples that work
- Capitalized: Section headings start with capital letters