Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/coslynx/fitpulse-fitness-tracker-mvp
Track fitness goals share progress with friends. Simple goal setting and tracking MVP... Created at https://coslynx.com
https://github.com/coslynx/fitpulse-fitness-tracker-mvp
code-generation coslynx developer-tools devops expressjs fitness-tracker goal-setting health-tech javascript jwt machine-learning mongodb mvp nodejs progress-tracking reactjs social-sharing typescript web-application
Last synced: 25 days ago
JSON representation
Track fitness goals share progress with friends. Simple goal setting and tracking MVP... Created at https://coslynx.com
- Host: GitHub
- URL: https://github.com/coslynx/fitpulse-fitness-tracker-mvp
- Owner: coslynx
- Created: 2024-11-16T07:29:31.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-11-16T07:49:40.000Z (about 1 month ago)
- Last Synced: 2024-11-16T08:25:23.752Z (about 1 month ago)
- Topics: code-generation, coslynx, developer-tools, devops, expressjs, fitness-tracker, goal-setting, health-tech, javascript, jwt, machine-learning, mongodb, mvp, nodejs, progress-tracking, reactjs, social-sharing, typescript, web-application
- Language: TypeScript
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
FitPulse Fitness Tracker MVP
A simple, effective, and socially engaging fitness tracking web application
Developed with the software and tools below.
## 📑 Table of Contents
- 📍 Overview
- 📦 Features
- 📂 Structure
- 💻 Installation
- 🏗️ Usage
- 🌐 Hosting
- 📄 License
- 👏 Authors
## 📍 Overview
This repository contains the FitPulse Fitness Tracker MVP, a web application designed to help users set, track, and share their fitness goals. Built with a focus on simplicity and user engagement, it provides a streamlined experience for consistent fitness tracking. The core tech stack includes React for the frontend, Node.js with Express.js for the backend API, and MongoDB for data persistence.
## 📦 Features
| | Feature | Description |
|----|--------------------|--------------------------------------------------------------------------------------------------------------------|
| 🧑💻 | User Authentication | Secure user registration and login using email/password. Password hashing is done using bcrypt. JWTs are used for authentication.|
| 🎯 | Goal Setting | Users can define custom fitness goals with specific targets and deadlines. Supports various goal types (weight loss, distance, etc.).|
| 📈 | Progress Tracking | Users log their workouts, and the app calculates progress toward their goals. Progress is visualized using charts.|
| 🗣️ | Social Sharing | Users can share progress updates via a simple copy-to-clipboard feature (Direct social media integration is a future enhancement).|
| 📊 | Data Visualization | Progress toward goals is displayed using charts, providing clear visual feedback.|
| 📱 | Responsive Design | The application is responsive across different devices (desktop, tablet, mobile).|
## 📂 Structure
```text
fitness-tracker/
├── apps/
│ └── web/ // React frontend application
│ ├── package.json
│ ├── public/
│ │ └── index.html
│ ├── src/
│ │ ├── App.tsx
│ │ ├── index.tsx
│ │ ├── components/ ...
│ │ ├── pages/ ...
│ │ └── ...
│ └── ...
└── backend/ // Node.js/Express backend API
├── package.json
├── src/
│ └── server.ts
└── ...
```
## 💻 Installation
### 🔧 Prerequisites
- Node.js v18+
- npm 8+
- MongoDB 6.0+
### 🚀 Setup Instructions
1. Clone the repository:
```bash
git clone https://github.com/coslynx/FitPulse-Fitness-Tracker-MVP.git
cd FitPulse-Fitness-Tracker-MVP
```
2. Navigate to the frontend directory:
```bash
cd apps/web
```
Install frontend dependencies:
```bash
npm install
```
3. Navigate to the backend directory:
```bash
cd ../../backend
```
Install backend dependencies:
```bash
npm install
```
4. Set up the database (ensure MongoDB is running):
- You'll need to create a database named "fitness-tracker" in your MongoDB instance. No additional setup is required for this MVP.
5. Configure environment variables:
- Create a `.env` file in both the frontend (`apps/web`) and backend directories, using the `.env.example` files as templates, and fill in your `JWT_SECRET` and database connection string.
## 🏗️ Usage
### 🏃♂️ Running the MVP
1. Start the backend development server:
```bash
cd ../../backend
npm run dev
```
2. In a separate terminal, start the frontend development server:
```bash
cd ../../apps/web
npm run dev
```
3. Access the application:
- Web interface: `http://localhost:3000`
- API endpoint (for testing purposes): `http://localhost:3001/api`
### ⚙️ Configuration
- Environment variables are stored in `.env` files (frontend and backend).
- `JWT_SECRET` in `.env` is crucial for secure authentication. Make sure this is set to a strong, unique value.
### 📚 Examples
- **User Registration:** Use the web interface to create an account.
- **Setting a Fitness Goal:** Navigate to the Goals page, fill out the form, and create a goal.
- **Logging a Workout:** Navigate to the Workouts page, record your workout data, and save it.
## 🌐 Hosting
This MVP can be deployed to any platform that supports Node.js and React applications. Heroku is a suggested option. You'll need to configure the environment variables appropriately for your chosen platform.
## 📄 License & Attribution
### 📄 License
This Minimum Viable Product (MVP) is licensed under the [GNU AGPLv3](https://choosealicense.com/licenses/agpl-3.0/) license.
### 🤖 AI-Generated MVP
This MVP was entirely generated using artificial intelligence through [CosLynx.com](https://coslynx.com).
No human was directly involved in the coding process of the repository: FitPulse-Fitness-Tracker-MVP
### 📞 Contact
For any questions or concerns regarding this AI-generated MVP, please contact CosLynx at:
- Website: [CosLynx.com](https://coslynx.com)
- Twitter: [@CosLynxAI](https://x.com/CosLynxAI)
🌐 CosLynx.com
Create Your Custom MVP in Minutes With CosLynxAI!
```