{"id":15157917,"url":"https://github.com/coslynx/fittrack-mvp-web-app","last_synced_at":"2026-02-09T23:01:51.829Z","repository":{"id":255792508,"uuid":"853624998","full_name":"coslynx/FitTrack-MVP-Web-App","owner":"coslynx","description":"Project: Track fitness goals, log workouts, and share progress with friends. Created at https://coslynx.com","archived":false,"fork":false,"pushed_at":"2024-09-07T04:19:53.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-08T17:54:05.690Z","etag":null,"topics":["code-generation","community-building","developer-tools","devops","expressjs","fitness-tracking","goal-setting","javascript","machine-learning","mvp","nextjs","postgresql","prisma","progress-visualization","react","social-sharing","software-development","tailwindcss","user-authentication","workout-logging"],"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-09-07T04:17:01.000Z","updated_at":"2024-09-07T04:19:56.000Z","dependencies_parsed_at":"2024-09-07T05:36:22.417Z","dependency_job_id":"a2666d2c-2c97-4d68-8dc2-f1d2e21dad7e","html_url":"https://github.com/coslynx/FitTrack-MVP-Web-App","commit_stats":null,"previous_names":["coslynx/fittrack-mvp-web-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/coslynx/FitTrack-MVP-Web-App","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2FFitTrack-MVP-Web-App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2FFitTrack-MVP-Web-App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2FFitTrack-MVP-Web-App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2FFitTrack-MVP-Web-App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coslynx","download_url":"https://codeload.github.com/coslynx/FitTrack-MVP-Web-App/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2FFitTrack-MVP-Web-App/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29284739,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T21:57:15.303Z","status":"ssl_error","status_checked_at":"2026-02-09T21:57:11.537Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["code-generation","community-building","developer-tools","devops","expressjs","fitness-tracking","goal-setting","javascript","machine-learning","mvp","nextjs","postgresql","prisma","progress-visualization","react","social-sharing","software-development","tailwindcss","user-authentication","workout-logging"],"created_at":"2024-09-26T20:20:34.706Z","updated_at":"2026-02-09T23:01:51.794Z","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\nFitTrack-MVP-Web-App\n\u003c/h1\u003e\n\u003ch4 align=\"center\"\u003eA web-based fitness tracker to help users achieve their goals.\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-Next.js-blue\" alt=\"Framework used for the application\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Frontend-Javascript,_Html,_Css-red\" alt=\"Frontend technologies used\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Backend-Node.js-blue\" alt=\"Backend technology used\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/LLMs-Custom,_Gemini,_OpenAI-black\" alt=\"Large language models used\"\u003e\n\u003c/div\u003e\n\u003cdiv class=\"badges\" align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/last-commit/coslynx/FitTrack-MVP-Web-App?style=flat-square\u0026color=5D6D7E\" alt=\"git-last-commit\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/commit-activity/m/coslynx/FitTrack-MVP-Web-App?style=flat-square\u0026color=5D6D7E\" alt=\"GitHub commit activity\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/languages/top/coslynx/FitTrack-MVP-Web-App?style=flat-square\u0026color=5D6D7E\" alt=\"GitHub top language\" /\u003e\n\u003c/div\u003e\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 \"FitTrack-MVP-Web-App\" that provides a user-friendly platform for fitness tracking, goal setting, and progress visualization. It combines the power of React, Next.js, and a robust backend built with Node.js, leveraging custom Large Language Models (LLMs) like Gemini and OpenAI for enhanced user experience and functionality. \n\n## 📦 Features\n|    | Feature            | Description                                                                                                        |\n|----|--------------------|--------------------------------------------------------------------------------------------------------------------|\n| ⚙️ | **Architecture**   | The codebase follows a modular architectural pattern with separate directories for different functionalities, ensuring easier maintenance and scalability.             |\n| 📄 | **Documentation**  | The repository includes a README file that provides a detailed overview of the MVP, its dependencies, and usage instructions.|\n| 🔗 | **Dependencies**   | The codebase relies on various external libraries and packages such as React, Next.js, Zustand, Prisma, and Tailwind CSS, which are essential for building and styling the UI components, and handling external services.|\n| 🧩 | **Modularity**     | The modular structure allows for easier maintenance and reusability of the code, with separate directories and files for different functionalities such as components, pages, styles, and utilities.|\n| 🧪 | **Testing**        | Implement unit tests using frameworks like Jest or React Testing Library to ensure the reliability and robustness of the codebase.       |\n| ⚡️  | **Performance**    | The performance of the system can be optimized based on factors such as the browser and hardware being used. Consider implementing performance optimizations for better efficiency.|\n| 🔐 | **Security**       | Enhance security by implementing measures such as input validation, data encryption, and secure communication protocols.|\n| 🔀 | **Version Control**| Utilizes Git for version control with GitHub Actions workflow files for automated build and release processes.|\n| 🔌 | **Integrations**   | Interacts with browser APIs, external services through HTTP requests, and includes integrations with popular fitness trackers like Fitbit, Garmin, and Apple Health.|\n| 📶 | **Scalability**    | Design the system to handle increased user load and data volume, utilizing caching strategies and cloud-based solutions for better scalability.           |\n\n## 📂 Structure\n```text\n├── components\n│   ├── Button.tsx\n│   ├── Header.tsx\n│   ├── Layout.tsx\n│   ├── GoalInput.tsx\n│   ├── ProgressChart.tsx\n│   └── SocialShareButton.tsx\n├── pages\n│   ├── api\n│   │   ├── auth.ts\n│   │   ├── goals.ts\n│   │   └── progress.ts\n│   ├── _app.tsx\n│   ├── index.tsx\n│   ├── dashboard.tsx\n│   └── login.tsx\n├── styles\n│   └── global.css\n├── utils\n│   ├── helpers.ts\n│   ├── api.ts\n│   ├── auth.ts\n│   └── validation.ts\n├── config\n│   └── next-auth.config.ts\n├── middleware\n│   └── authentication.ts\n├── .env\n├── package.json\n├── README.md\n├── tailwind.config.ts\n└── tsconfig.json\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/coslynx/FitTrack-MVP-Web-App.git`\n2. Navigate to the MVP directory:\n   - `cd FitTrack-MVP-Web-App`\n3. Install dependencies:\n   - `npm install`\n\n## 🏗️ Usage\n### 🏃‍♂️ Running the MVP\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 up a new fitness goal:  \n    - Navigate to the 'Goals' section.\n    - Click on the 'Add Goal' button.\n    - Fill in the goal details (type, target, timeframe).\n    - Submit the goal.\n- 📝 **Example 2**: Tracking workout progress: \n    - Log in to your account.\n    - Navigate to the 'Progress' section.\n    - Click on 'Log Workout' to record workout details (date, type, duration, metrics).\n    - View your progress visualized on the 'Progress Chart'.\n- 📝 **Example 3**: Integrating with fitness trackers:\n    - Log in to your account.\n    - Navigate to 'Settings' and connect your fitness tracker (Fitbit, Garmin, Apple Health).\n    - Automatically sync your workout data from your tracker to FitTrack for a seamless experience.\n\n## 🌐 Hosting\n### 🚀 Deployment Instructions\nIf applicable, provide details on how to host the MVP using various services, such as:\n\nVercel\nNetlify\nGitHub Pages\nAWS\nGoogle Cloud\n\n#### Heroku\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- `DATABASE_URL`: PostgreSQL database connection URL.\n- `NEXTAUTH_SECRET`: A secret used for signing tokens.\n\n## 📜 API Documentation\n### 🔍 Endpoints\n- **GET /api/auth/[...nextauth].js**: Handles authentication requests (sign in, sign up, password reset).\n- **GET /api/goals**: Retrieves a list of goals for the current user.\n- **POST /api/goals**: Creates a new goal for the current user.\n- **GET /api/progress**: Retrieves workout data and progress for the current user.\n- **POST /api/progress**: Logs a new workout for the current user.\n\n### 🔒 Authentication\nAuthentication is handled by NextAuth.js, which provides secure JWT token-based authentication.\n\n### 📝 Examples\n```bash\n# Get goals\ncurl -X GET http://localhost:3000/api/goals -H \"Authorization: Bearer YOUR_JWT_TOKEN\"\n\n# Create a new goal\ncurl -X POST http://localhost:3000/api/goals -H \"Authorization: Bearer YOUR_JWT_TOKEN\" -H \"Content-Type: application/json\" -d '{\"type\": \"weight loss\", \"target\": 10, \"timeframe\": 30}'\n\n# Get progress data\ncurl -X GET http://localhost:3000/api/progress -H \"Authorization: Bearer YOUR_JWT_TOKEN\"\n\n# Log a new workout\ncurl -X POST http://localhost:3000/api/progress -H \"Authorization: Bearer YOUR_JWT_TOKEN\" -H \"Content-Type: application/json\" -d '{\"date\": \"2024-03-10\", \"type\": \"running\", \"duration\": 30, \"distance\": 5, \"calories\": 300}'\n```\n\n## 📜 License\nThis MVP is licensed under the [MIT](https://choosealicense.com/licenses/mit/).\n\n## 👥 Authors\n- **CosLynxAI** - [CosLynx.com](https://coslynx.com)\n- **Drix10** - [GitHub](https://github.com/coslynx)\n- **Kais Radwan** - [GitHub](https://github.com/KaisRadwan)\n\n\n\u003cp align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003e🌐 CosLynx.com\u003c/h1\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eCreate Your Custom MVP in Minutes With CosLynxAI!\u003c/em\u003e\n\u003c/p\u003e\n\u003cdiv class=\"badges\" align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Developers-Drix10,_Kais_Radwan-red\" alt=\"\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Website-CosLynx.com-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%2Ffittrack-mvp-web-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoslynx%2Ffittrack-mvp-web-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoslynx%2Ffittrack-mvp-web-app/lists"}