Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/coslynx/fitness-tracker-mvp-social-community
Project: Set fitness goals, track your progress, and share achievements with friends.. Created at https://coslynx.com
https://github.com/coslynx/fitness-tracker-mvp-social-community
api-integration code-generation data-visualization developer-tools devops fitness-tracker goal-setting machine-learning mvp nextjs postgresql prisma social-sharing software-development tailwindcss typescript user-authentication workout-tracking zustand
Last synced: 24 days ago
JSON representation
Project: Set fitness goals, track your progress, and share achievements with friends.. Created at https://coslynx.com
- Host: GitHub
- URL: https://github.com/coslynx/fitness-tracker-mvp-social-community
- Owner: coslynx
- Created: 2024-09-07T08:02:49.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-09-07T08:06:01.000Z (2 months ago)
- Last Synced: 2024-10-15T17:21:08.533Z (24 days ago)
- Topics: api-integration, code-generation, data-visualization, developer-tools, devops, fitness-tracker, goal-setting, machine-learning, mvp, nextjs, postgresql, prisma, social-sharing, software-development, tailwindcss, typescript, user-authentication, workout-tracking, zustand
- Language: TypeScript
- Size: 27.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Fitness-Tracker-MVP-Social-Community
A user-centric fitness platform for personalized goal setting, detailed progress tracking, and a thriving social community.
Developed with the software and tools below.
## 📑 Table of Contents
- 📍 Overview
- 📦 Features
- 📂 Structure
- 💻 Installation
- 🏗️ Usage
- 🌐 Hosting
- 📄 License
- 👏 Authors
## 📍 Overview
The repository contains a Minimum Viable Product (MVP) called "Fitness-Tracker-MVP-Social-Community" that provides a comprehensive solution for users to set personalized fitness goals, track their progress, and connect with a supportive community. The MVP is built using a robust technology stack, including:
* **Frontend:** React.js, Next.js, Tailwind CSS, Zustand
* **Backend:** Node.js, Express.js
* **Database:** PostgreSQL
* **ORM:** Prisma
* **Authentication:** NextAuth.js
* **Error Handling:** Sentry
## 📦 Features
| | Feature | Description |
|----|--------------------|--------------------------------------------------------------------------------------------------------------------|
| 🔐 | **User Authentication** | Users can register and log in securely using an email-based authentication system. |
| 🎯 | **Goal Setting** | Users can set personalized fitness goals tailored to their individual needs and preferences. |
| 📊 | **Progress Tracking** | Users can log their workouts, activities, and nutritional intake to track their progress towards their goals. |
| 💬 | **Social Engagement** | Users can share their progress, motivate each other, and connect with like-minded individuals in a supportive community. |
| 📈 | **Data Visualization** | The platform provides visually appealing charts and graphs to help users understand their progress and identify trends. |
## 📂 Structure
```text
└── src
├── components
│ ├── Button.tsx
│ ├── Header.tsx
│ ├── Layout.tsx
│ ├── GoalInput.tsx
│ ├── ProgressChart.tsx
│ └── SocialShareButton.tsx
├── pages
│ ├── api
│ │ ├── auth.ts
│ │ ├── goals.ts
│ │ └── progress.ts
│ ├── _app.tsx
│ ├── index.tsx
│ ├── dashboard.tsx
│ └── login.tsx
├── styles
│ └── global.css
├── utils
│ ├── helpers.ts
│ ├── api.ts
│ ├── auth.ts
│ └── validation.ts
├── config
│ └── next-auth.config.ts
└── middleware
└── authentication.ts
```
## 💻 Installation
### 🔧 Prerequisites
- Node.js
- npm
- Docker
### 🚀 Setup Instructions
1. Clone the repository:
- `git clone https://github.com/coslynx/Fitness-Tracker-MVP-Social-Community.git`
2. Navigate to the project directory:
- `cd Fitness-Tracker-MVP-Social-Community`
3. Install dependencies:
- `npm install`
## 🏗️ Usage
### 🏃♂️ Running the MVP
1. Start the development server:
- `npm run dev`
2. Open your browser and navigate to [http://localhost:3000](http://localhost:3000).
### ⚙️ Configuration
Adjust configuration settings in `next.config.js`, `tailwind.config.js`, and `.env`.
### 📚 Examples
- **Registering a new user:**
- Navigate to the login page.
- Click the "Sign Up" button.
- Fill in the required details (email, password) and submit the form.
- **Setting a fitness goal:**
- Log in to your account.
- Navigate to the dashboard page.
- Click the "Add Goal" button.
- Enter the goal details (name, target, deadline) and click "Save".
- **Tracking your progress:**
- Log in to your account.
- Navigate to the dashboard page.
- Select a goal from the list.
- Click the "Log Workout" button to record your activity.
- View your progress in the interactive chart.
- **Sharing your progress:**
- Log in to your account.
- Navigate to the dashboard page.
- Select a goal from the list.
- Click the "Share Progress" button.
- Choose a social media platform and share your progress.
## 🌐 Hosting
### 🚀 Deployment Instructions
1. **Create a Vercel account:**
- [https://vercel.com/](https://vercel.com/)
2. **Initialize Vercel:**
- `vercel init`
3. **Connect to your GitHub repository:**
- Follow the prompts to connect your repository.
4. **Deploy:**
- `vercel deploy`
### 🔑 Environment Variables
- `NEXT_PUBLIC_API_KEY`: API key for external services.
- `DATABASE_URL`: Database connection URL for PostgreSQL.
- `AUTH_SECRET`: Authentication secret for NextAuth.js.
## 📜 License
This MVP is licensed under the [MIT License](https://choosealicense.com/licenses/mit/).
## 👥 Authors
- **Author Name** - [CosLynx.com](https://coslynx.com)
- **Creator Name** - [CosLynxAI](https://github.com/coslynx)
🌐 CosLynx.com
Create Your Custom MVP in Minutes With CosLynxAI!
