{"id":15095740,"url":"https://github.com/coslynx/fitness-tracker-app-mvp","last_synced_at":"2026-01-07T11:16:21.058Z","repository":{"id":253691472,"uuid":"844234197","full_name":"coslynx/fitness-tracker-app-mvp","owner":"coslynx","description":"Project: The Essential Features for User Engagement. Created at https://spectra.codes, which is owned by @Drix10","archived":false,"fork":false,"pushed_at":"2024-08-18T19:31:00.000Z","size":39,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-01T17:44:16.694Z","etag":null,"topics":["axios","code-generation","developer-tools","devops","firebase","fitness-tracker","goal-setting","machine-learning","mobile-first","mvp","nextjs","prisma","progress-tracking","social-sharing","software-development","tailwindcss","typescript","user-interface","zustand"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coslynx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-18T19:27:02.000Z","updated_at":"2024-08-18T19:31:03.000Z","dependencies_parsed_at":"2024-08-18T20:54:55.445Z","dependency_job_id":null,"html_url":"https://github.com/coslynx/fitness-tracker-app-mvp","commit_stats":null,"previous_names":["spectra-ai-codegen/fitness-tracker-app-mvp","coslynx/fitness-tracker-app-mvp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2Ffitness-tracker-app-mvp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2Ffitness-tracker-app-mvp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2Ffitness-tracker-app-mvp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2Ffitness-tracker-app-mvp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coslynx","download_url":"https://codeload.github.com/coslynx/fitness-tracker-app-mvp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245852426,"owners_count":20683041,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["axios","code-generation","developer-tools","devops","firebase","fitness-tracker","goal-setting","machine-learning","mobile-first","mvp","nextjs","prisma","progress-tracking","social-sharing","software-development","tailwindcss","typescript","user-interface","zustand"],"created_at":"2024-09-25T15:41:41.052Z","updated_at":"2026-01-07T11:16:21.014Z","avatar_url":"https://github.com/coslynx.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv class=\"hero-icon\" align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/PKief/vscode-material-icon-theme/ec559a9f6bfd399b82bb44393651661b08aaf7ba/icons/folder-markdown-open.svg\" width=\"100\" /\u003e\n\u003c/div\u003e\n\n\u003ch1 align=\"center\"\u003e\nfitness-tracker-app-mvp\n\u003c/h1\u003e\n\u003ch4 align=\"center\"\u003eA Minimum Viable Product (MVP) for a web application designed to empower fitness enthusiasts\u003c/h4\u003e\n\u003ch4 align=\"center\"\u003eDeveloped with the software and tools below.\u003c/h4\u003e\n\u003cdiv class=\"badges\" align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Framework-React-blue\" alt=\"Framework: React\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Frontend-Javascript,_Html,_Css-red\" alt=\"Frontend: Javascript, Html, Css\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Backend-Node.js-blue\" alt=\"Backend: Node.js\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/LLMs-Custom,_Gemini,_OpenAI-black\" alt=\"LLMs: Custom, Gemini, OpenAI\"\u003e\n\u003c/div\u003e\n\u003cdiv class=\"badges\" align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/last-commit/spectra-ai-codegen/fitness-tracker-app-mvp?style=flat-square\u0026color=5D6D7E\" alt=\"git-last-commit\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/commit-activity/m/spectra-ai-codegen/fitness-tracker-app-mvp?style=flat-square\u0026color=5D6D7E\" alt=\"GitHub commit activity\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/languages/top/spectra-ai-codegen/fitness-tracker-app-mvp?style=flat-square\u0026color=5D6D7E\" alt=\"GitHub top language\" /\u003e\n\u003c/div\u003e\n\n\n## 📑 Table of Contents\n- 📍 Overview\n- 📦 Features\n- 📂 Structure\n- 💻 Installation\n- 🏗️ Usage\n- 🌐 Hosting\n- 📄 License\n- 👏 Authors\n\n## 📍 Overview\nThe repository contains a Minimum Viable Product (MVP) called \"fitness-tracker-app-mvp\" that provides a user-friendly platform to set and track fitness goals, monitor progress, and share achievements with friends. It leverages a comprehensive tech stack including React, JavaScript, HTML, CSS, Node.js, and custom LLMs such as Gemini and OpenAI to deliver a robust and engaging fitness experience.\n\n## 📦 Features\n|    | Feature            | Description                                                                                                        |\n|----|--------------------|--------------------------------------------------------------------------------------------------------------------|\n| ⚙️ | **Goal Setting**   | Users can define and track personalized fitness goals, with options for weight loss, muscle gain, or improving specific metrics.  |\n| 📊 | **Progress Tracking**  | The app seamlessly tracks progress across workouts, nutrition, and overall activity levels, providing visual insights and feedback. |\n| 👥 | **Social Sharing**  | Users can share progress updates and achievements with friends and family through social media integration, fostering motivation and support. |\n| 🏆 | **Group Challenges** |  The platform encourages a sense of community through group challenges, allowing users to compete and motivate each other towards shared goals. |\n| 📱 | **Mobile-First Design** | The app is designed with a mobile-first approach, prioritizing optimal user experience on smartphones and ensuring accessibility across various screen sizes. |\n| 🔌 | **Integrations**   | The app integrates with Google Fit/Apple Health for seamless data import, providing a more holistic view of user activity and progress. |\n| 📈 | **Scalability**    | The architecture is designed to handle increased user demand through horizontal scaling, database optimization, and efficient API design. |\n\n## 📂 Structure\n```text\nfitness-tracker/\n├── components/\n│   ├── Button.tsx\n│   ├── Card.tsx\n│   ├── Chart.tsx\n│   ├── Form.tsx\n│   ├── Input.tsx\n│   ├── Navigation.tsx\n│   ├── Footer.tsx\n│   └── AppLayout.tsx\n├── pages/\n│   ├── HomePage.tsx\n│   ├── UserProfilePage.tsx\n│   ├── GoalSettingPage.tsx\n│   ├── WorkoutLoggingPage.tsx\n│   ├── ProgressTrackingPage.tsx\n│   └── SocialSharingPage.tsx\n├── styles/\n│   └── global.css\n├── api/\n│   ├── routes/\n│   │   ├── user.ts\n│   │   ├── goal.ts\n│   │   ├── workout.ts\n│   │   ├── nutrition.ts\n│   │   └── social.ts\n│   └── index.ts\n├── utils/\n│   ├── helpers.ts\n│   └── index.ts\n├── prisma/\n│   └── schema.prisma\n├── .env\n├── .eslintrc.js\n├── tsconfig.json\n├── next.config.mjs\n├── tailwind.config.js\n└── postcss.config.js\n```\n\n## 💻 Installation\n### 🔧 Prerequisites\n- Node.js\n- npm\n- Docker\n\n### 🚀 Setup Instructions\n1. Clone the repository:\n   - `git clone https://github.com/spectra-ai-codegen/fitness-tracker-app-mvp.git`\n2. Navigate to the project directory:\n   - `cd fitness-tracker-app-mvp`\n3. Install dependencies:\n   - `npm install`\n\n## 🏗️ Usage\n### 🏃‍♂️ Running the Application\n1. Start the development server:\n   - `npm start`\n2. Open your browser and navigate to [http://localhost:3000](http://localhost:3000).\n\n### ⚙️ Configuration\nAdjust configuration settings in `config.js` or `.env`.\n\n### 📚 Examples\n- 📝 **Example 1**: Setting a weight loss goal: Users can define a weight loss goal with a specific target weight and timeframe. The app automatically calculates the required calorie deficit based on user input and provides progress tracking updates.\n- 📝 **Example 2**: Logging a workout: Users can record their workouts, specifying the type, duration, intensity, and specific exercises performed. The app tracks workout patterns, identifies areas for improvement, and provides insights into calorie expenditure.\n- 📝 **Example 3**: Sharing progress on social media: Users can share their progress updates and achievements with friends and family on platforms like Facebook, Instagram, and Twitter. This fosters a supportive community and encourages motivation.\n\n## 🌐 Hosting\n### 🚀 Deployment Instructions\n\n#### Heroku Deployment\n1. Install the Heroku CLI:\n   - `npm install -g heroku`\n2. Login to Heroku:\n   - `heroku login`\n3. Create a new Heroku app:\n   - `heroku create`\n4. Deploy the code:\n   - `git push heroku main`\n\n### 🔑 Environment Variables\n- `DB_HOST`: Database host\n- `DB_USER`: Database user\n- `DB_PASS`: Database password\n\n## 📜 API Documentation\n### 🔍 Endpoints\n- **GET /api/users**: Retrieves a list of users.\n- **POST /api/users**: Creates a new user account.\n- **GET /api/goals**: Retrieves a list of goals.\n- **POST /api/goals**: Creates a new goal.\n- **GET /api/workouts**: Retrieves a list of workouts.\n- **POST /api/workouts**: Logs a new workout.\n- **GET /api/nutrition**: Retrieves a list of nutrition entries.\n- **POST /api/nutrition**: Logs a new nutrition entry.\n\n### 🔒 Authentication\nUse JWT tokens for authentication.\n\n### 📝 Examples\n- `curl -X GET http://localhost:3000/api/users`\n\n## 📜 License\nThis project is licensed under the [GNU AGPLv3](https://choosealicense.com/licenses/agpl-3.0/).\n\n## 👥 Authors\n- **Author Name** - [Spectra.codes](https://spectra.codes)\n- **Creator Name** - [DRIX10](https://github.com/Drix10)\n\n\u003cp align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003e🌐 Spectra.Codes\u003c/h1\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eWhy only generate Code? When you can generate the whole Repository!\u003c/em\u003e\n\u003c/p\u003e\n\u003cdiv class=\"badges\" align=\"center\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Developer-Drix10-red\" alt=\"\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Website-Spectra.codes-blue\" alt=\"\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Backed_by-Google,_Microsoft_\u0026_Amazon_for_Startups-red\" alt=\"\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Finalist-Backdrop_Build_v4-black\" alt=\"\"\u003e\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoslynx%2Ffitness-tracker-app-mvp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoslynx%2Ffitness-tracker-app-mvp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoslynx%2Ffitness-tracker-app-mvp/lists"}