Workout.cool

Modern fitness coaching platform with comprehensive exercise database

Contributors Forks Stars Issues Languages Repository Size

## Table of Contents - [About](#about) - [Project Origin & Motivation](#-project-origin--motivation) - [Quick Start](#quick-start) - [Exercise Database Import](#exercise-database-import) - [Project Architecture](#project-architecture) - [Roadmap](#roadmap) - [Contributing](#contributing) - [Deployment](#deployment) - [Resources](#resources) - [License](#license) - [Sponsor This Project](#-sponsor-this-project) ## Contributors

## About A comprehensive fitness coaching platform that allows create workout plans for you, track progress, and access a vast exercise database with detailed instructions and video demonstrations. ## 🎯 Project Origin & Motivation This project was born from a personal mission to revive and improve upon a previous fitness platform. As the **primary contributor** to the original [workout.lol](https://github.com/workout-lol/workout-lol) project, I witnessed its journey and abandonment. 🥹 ### The Story Behind **_workout.cool_** - 🏗️ **Original Contributor**: I was the main contributor to workout.lol - 💼 **Business Challenges**: The original project faced major hurdles with exercise video partnerships (no reliable video provider) could be established - 💰 **Project Sale**: Due to these partnership issues, the project was sold to another party - 📉 **Abandonment**: The new owner quickly realized that **exercise video licensing costs were prohibitively expensive**, began to be sick and abandoned the entire project - 🔄 **Revival Attempts**: For the past **9 months**, I've been trying to reconnect with the new stakeholder - 📧 **Radio Silence**: Despite multiple (15) attempts, there has been no response - 🚀 **New Beginning**: Rather than let this valuable work disappear, I decided to create a fresh, modern implementation ### Why **_workout.cool_** Exists **Someone had to step up.** The opensource fitness community deserves better than broken promises and abandoned platforms. I'm not building this for profit. This isn't just a revival : it's an evolution. **workout.cool** represents everything the original project could have been, with the reliability, modern approach, and **maintenance** that the fitness open source community deserves. ## 👥 From the Community, For the Community **I'm not just a developer : I'm a user who refused to let our community down.** I experienced firsthand the frustration of watching a beloved tool slowly disappear. Like many of you, I had workouts saved, progress tracked, and a routine built around the platform. ### My Mission: Rescue & Revive. _If you were part of the original workout.lol community, welcome back! If you're new here, welcome to the future of fitness platform management._ ## Quick Start ### Prerequisites - [Node.js](https://nodejs.org/) (v18+) - [pnpm](https://pnpm.io/) (v8+) - [Docker](https://www.docker.com/) ### Installation 1. **Clone the repository** ```bash git clone https://github.com/Snouzy/workout-cool.git cd workout-cool ``` 2. **Install dependencies** ```bash pnpm install ``` 3. **Copy environment variables** ```bash cp .env.example .env ``` 4. **Start everything for development:** ```sh make dev ``` - This will start the database in Docker, run migrations, seed the DB, and start the Next.js dev server. - To stop services run `make down` 5. **Open your browser** Navigate to [http://localhost:3000](http://localhost:3000) ## Exercise Database Import The project includes a comprehensive exercise database. To import a sample of exercises: ### Prerequisites for Import 1. **Prepare your CSV file** Your CSV should have these columns: ``` id,name,name_en,description,description_en,full_video_url,full_video_image_url,introduction,introduction_en,slug,slug_en,attribute_name,attribute_value ``` You can use the provided example. ### Import Commands ```bash # Import exercises from a CSV file pnpm run import:exercises-full /path/to/your/exercises.csv # Example with the provided sample data pnpm run import:exercises-full ./data/sample-exercises.csv ``` ### CSV Format Example ```csv id,name,name_en,description,description_en,full_video_url,full_video_image_url,introduction,introduction_en,slug,slug_en,attribute_name,attribute_value 157,"Fentes arrières à la barre","Barbell Reverse Lunges","

Stand upright...

","

Stand upright...

",https://youtube.com/...,https://img.youtube.com/...,slug-fr,slug-en,TYPE,STRENGTH 157,"Fentes arrières à la barre","Barbell Reverse Lunges","

Stand upright...

","

Stand upright...

",https://youtube.com/...,https://img.youtube.com/...,slug-fr,slug-en,PRIMARY_MUSCLE,QUADRICEPS ``` ### Available Attribute Types - **TYPE**: `STRENGTH`, `CARDIO`, `PLYOMETRICS`, `STRETCHING`, etc. - **PRIMARY_MUSCLE**: `QUADRICEPS`, `CHEST`, `BACK`, `SHOULDERS`, etc. - **SECONDARY_MUSCLE**: Secondary muscle groups targeted - **EQUIPMENT**: `BARBELL`, `DUMBBELL`, `BODYWEIGHT`, `MACHINE`, etc. - **MECHANICS_TYPE**: `COMPOUND`, `ISOLATION` ## Project Architecture This project follows **Feature-Sliced Design (FSD)** principles with Next.js App Router: ``` src/ ├── app/ # Next.js pages, routes and layouts ├── processes/ # Business flows (multi-feature) ├── widgets/ # Composable UI with logic (Sidebar, Header) ├── features/ # Business units (auth, exercise-management) ├── entities/ # Domain entities (user, exercise, workout) ├── shared/ # Shared code (UI, lib, config, types) └── styles/ # Global CSS, themes ``` ### Architecture Principles - **Feature-driven**: Each feature is independent and reusable - **Clear domain isolation**: `shared` → `entities` → `features` → `widgets` → `app` - **Consistency**: Between business logic, UI, and data layers ### Example Feature Structure ``` features/ └── exercise-management/ ├── ui/ # UI components (ExerciseForm, ExerciseCard) ├── model/ # Hooks, state management (useExercises) ├── lib/ # Utilities (exercise-helpers) └── api/ # Server actions or API calls ``` ## Roadmap Here are the next steps and goals for Workout.cool: - [ ] 🏋️‍♂️ Add new exercises and videos - [ ] 📱 Mobile app (React Native) - [ ] 🏆 Badges and gamification system - [ ] 📊 Advanced progress statistics - [ ] 🤝 Integration with wearables (watches, trackers) - [ ] 🌍 Multilingual support - [ ] 🔒 OAuth authentication (Google, Apple, etc.) - [ ] 💬 Built-in community forum Feel free to suggest your ideas via [issues](https://github.com/Snouzy/workout-cool/issues)! ## Contributing We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details. ### Development Workflow 1. Fork the repository 2. Create a feature branch (`git checkout -b feature/amazing-feature`) 3. Make your changes 4. Commit your changes (`git commit -m 'feat: add amazing feature'`) 5. Push to the branch (`git push origin feature/amazing-feature`) 6. Open a Pull Request ### Code Style - Follow TypeScript best practices - Use Feature-Sliced Design architecture - Write meaningful commit messages - Add tests for new features ## Deployment ### Using Docker ```bash # Build the Docker image docker build -t yourusername/workout-cool . # Run the container docker run -p 3000:3000 --env-file .env.production yourusername/workout-cool ``` ### Manual Deployment ```bash # Build the application pnpm build # Run database migrations export DATABASE_URL="your-production-db-url" npx prisma migrate deploy # Start the production server pnpm start ``` ## Resources - [Feature-Sliced Design](https://feature-sliced.design/) - [Next.js Documentation](https://nextjs.org/docs) - [Prisma Documentation](https://www.prisma.io/docs/) - [Better Auth](https://github.com/better-auth/better-auth) ## License This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. [![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) ## 🤝 Join the Rescue Mission **This is about rebuilding what we lost, together.** ### How You Can Help - 🌟 **Star this repo** to show the world our community is alive and thriving - 💬 **Join our Discord** to connect with other fitness enthusiasts and developers - 🐛 **Report issues** you find. I'm listening to every single one - 💡 **Share your feature requests** finally, someone who will actually implement them ! - 🔄 **Spread the word** to fellow fitness enthusiasts who lost hope - 🤝 **Contribute code** if you're a developer : let's build this together

## 💖 Sponsor This Project Appear in the README and on the website as supporter by donating:

If you believe in open-source fitness tools and want to help this project thrive,
consider buying me a coffee ☕ or sponsoring the continued development.

Your support helps cover hosting costs, exercise database updates, and continuous improvement.
Thank you for keeping workout.cool alive and evolving 💪

````