{"id":15104154,"url":"https://github.com/coslynx/fittrack-mvp","last_synced_at":"2026-01-20T16:01:39.951Z","repository":{"id":256802672,"uuid":"856477619","full_name":"coslynx/FitTrack-MVP","owner":"coslynx","description":"Set fitness goals, track progress, and share achievements with friends... Created at https://coslynx.com","archived":false,"fork":false,"pushed_at":"2024-09-12T16:37:56.000Z","size":29,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-10T23:51:32.121Z","etag":null,"topics":["api-integration","code-generation","data-analytics","developer-tools","devops","fitness-tracker","goal-setting","machine-learning","mvp","mvp-development","nextjs","postgresql","prisma","social-sharing","software-development","tailwindcss","typescript","user-authentication","workout-tracking","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-09-12T16:33:31.000Z","updated_at":"2024-09-12T16:37:59.000Z","dependencies_parsed_at":"2024-09-13T05:54:49.798Z","dependency_job_id":null,"html_url":"https://github.com/coslynx/FitTrack-MVP","commit_stats":null,"previous_names":["coslynx/fittrack-mvp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2FFitTrack-MVP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2FFitTrack-MVP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2FFitTrack-MVP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coslynx%2FFitTrack-MVP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coslynx","download_url":"https://codeload.github.com/coslynx/FitTrack-MVP/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247336146,"owners_count":20922581,"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":["api-integration","code-generation","data-analytics","developer-tools","devops","fitness-tracker","goal-setting","machine-learning","mvp","mvp-development","nextjs","postgresql","prisma","social-sharing","software-development","tailwindcss","typescript","user-authentication","workout-tracking","zustand"],"created_at":"2024-09-25T20:00:39.655Z","updated_at":"2026-01-20T16:01:39.915Z","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\n\u003c/h1\u003e\n\u003ch4 align=\"center\"\u003eA user-friendly fitness tracker MVP built with React, Next.js, and PostgreSQL.\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-blue\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Frontend-Javascript,_Html,_Css-red\" alt=\"Frontend-Javascript,_Html,_Css-red\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Backend-Node.js-blue\" alt=\"Backend-Node.js-blue\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Database-PostgreSQL-blue\" alt=\"Database-PostgreSQL-blue\" /\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?style=flat-square\u0026color=5D6D7E\" alt=\"git-last-commit\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/commit-activity/m/coslynx/FitTrack-MVP?style=flat-square\u0026color=5D6D7E\" alt=\"GitHub commit activity\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/languages/top/coslynx/FitTrack-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\nThis repository contains a Minimum Viable Product (MVP) called \"FitTrack-MVP\" that offers a streamlined and motivating experience to empower users to achieve their fitness aspirations. It provides a user-centric platform that combines personalized goal setting, detailed progress monitoring, and a thriving social community. Built on a secure and robust technical foundation, FitTrack-MVP differentiates itself through a user-friendly interface, personalized goal setting, detailed progress tracking, and social engagement features.\n\n## 📦 Features\n|    | Feature            | Description                                                                                                        |\n|----|--------------------|--------------------------------------------------------------------------------------------------------------------|\n| 🔐 | **Authentication**   | Users can register and login securely through an email-based authentication system.                                          |\n| 🎯 | **Goal Setting**     | Users can set personalized fitness goals tailored to their individual needs and preferences.                                          |\n| 📈 | **Progress Tracking** | Users can log their workouts, activities, and nutritional intake, and track their progress towards their goals.                |\n| 👥 | **Social Engagement** | Users can share their progress, motivate one another, and connect with like-minded individuals.                             |\n| 💻 | **Technology Stack** | FitTrack-MVP is built on a robust technology stack, including React, Next.js, TypeScript, PostgreSQL, and other essential libraries. |\n\n## 📂 Structure\n```text\nFitTrack-MVP\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\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.git`\n2. Navigate to the project directory:\n   - `cd FitTrack-MVP`\n3. Install dependencies:\n   - `npm install`\n\n## 🏗️ Usage\n### 🏃‍♂️ Running the Development Server\n1. Start the development server:\n   - `npm run dev`\n2. Open your browser and navigate to [http://localhost:3000](http://localhost:3000).\n\n### ⚙️ Configuration\nAdjust configuration settings in `.env` and `next-auth.config.ts`.\n\n### 📚 Examples\n- **Register \u0026 Login:** Users can register and log in using their email addresses and passwords. \n- **Set Goals:**  Users can define personalized fitness goals, including targets and deadlines.\n- **Track Progress:**  Users can log their workouts and activities, with the app automatically calculating their progress toward their goals.\n- **Engage Socially:**  Users can share their fitness achievements, motivate others, and connect with like-minded individuals through the social feed.\n\n## 🌐 Hosting\n### 🚀 Deployment Instructions\n#### Vercel\n1.  Install the Vercel CLI: \n    - `npm install -g vercel`\n2.  Log in to Vercel: \n    - `vercel login`\n3.  Initialize Vercel in your project directory:\n    - `vercel init`\n4.  Deploy your application:\n    - `vercel deploy`\n\n#### Netlify\n1.  Install the Netlify CLI:\n    - `npm install -g netlify-cli`\n2.  Log in to Netlify:\n    - `netlify login`\n3.  Initialize Netlify in your project directory:\n    - `netlify init`\n4.  Deploy your application:\n    - `netlify deploy`\n\n#### GitHub Pages\n1.  Update your project's settings on GitHub to enable GitHub Pages.\n2.  Configure the build settings and deploy directory (usually `out`) on GitHub.\n3.  Push your code to the `gh-pages` branch.\n\n#### AWS\n1.  Create an AWS account and set up an S3 bucket for hosting your static website.\n2.  Configure AWS CloudFront for content distribution.\n3.  Use a CI/CD pipeline to automate deployment to AWS.\n\n#### Google Cloud\n1.  Create a Google Cloud account and set up a Cloud Storage bucket for hosting.\n2.  Configure Google Cloud CDN for content distribution.\n3.  Use a CI/CD pipeline to automate deployment to Google Cloud.\n\n### 🔑 Environment Variables\n- **NEXT_PUBLIC_API_URL**: Your API URL (e.g., `http://localhost:3000`)\n- **NEXTAUTH_URL**: Your application's URL (e.g., `http://localhost:3000`)\n- **NEXTAUTH_SECRET**: A random secret key for signing tokens (generate using `openssl rand -base64 32`)\n- **DATABASE_URL**: Your PostgreSQL database connection string (e.g., `postgresql://user:password@host:port/database`)\n\n## 📜 API Documentation\n### 🔍 Endpoints\n- **POST /api/auth/register**: Register a new user.\n- **POST /api/auth/login**: Log in an existing user.\n- **POST /api/auth/logout**: Log out the current user.\n- **POST /api/goals**: Create a new fitness goal.\n- **GET /api/goals**: Retrieve a list of user goals.\n- **PUT /api/goals/:id**: Update a specific goal.\n- **DELETE /api/goals/:id**: Delete a specific goal.\n- **POST /api/workouts**: Log a new workout.\n- **GET /api/workouts**: Retrieve a list of user workouts.\n- **PUT /api/workouts/:id**: Update a specific workout.\n- **DELETE /api/workouts/:id**: Delete a specific workout.\n\n### 🔒 Authentication\nThe API utilizes JSON Web Tokens (JWT) for authentication. Users need to authenticate before accessing protected resources.\n\n### 📝 Examples\n- **Register a new user:**\n    - `curl -X POST http://localhost:3000/api/auth/register -H 'Content-Type: application/json' -d '{\"email\": \"example@email.com\", \"password\": \"yourpassword\"}'`\n- **Log in an existing user:**\n    - `curl -X POST http://localhost:3000/api/auth/login -H 'Content-Type: application/json' -d '{\"email\": \"example@email.com\", \"password\": \"yourpassword\"}'`\n\n## 📜 License \u0026 Attribution\n\n### 📄 License\nThis Minimum Viable Product (MVP) is licensed under the [GNU AGPLv3](https://choosealicense.com/licenses/agpl-3.0/) license.\n\n### 🤖 AI-Generated MVP\nThis MVP was entirely generated using artificial intelligence through [CosLynx.com](https://coslynx.com). No human was directly involved in the coding process.\n\n### 📞 Contact\nFor any questions or concerns regarding this AI-generated MVP, please contact CosLynx at:\n- Website: [CosLynx.com](https://coslynx.com)\n- Twitter: [@CosLynxAI](https://x.com/CosLynxAI)\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=\"Developers-Drix10,_Kais_Radwan-red\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Website-CosLynx.com-blue\" alt=\"Website-CosLynx.com-blue\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Backed_by-Google,_Microsoft_\u0026_Amazon_for_Startups-red\" alt=\"Backed_by-Google,_Microsoft_\u0026_Amazon_for_Startups-red\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Finalist-Backdrop_Build_v4,_v6-black\" alt=\"Finalist-Backdrop_Build_v4,_v6-black\" /\u003e\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoslynx%2Ffittrack-mvp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoslynx%2Ffittrack-mvp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoslynx%2Ffittrack-mvp/lists"}