Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/coslynx/fittrax-bl0ijq

Project: Streamlined User Feedback Gathering Platform. Created at https://spectra.codes, which is owned by @Drix10
https://github.com/coslynx/fittrax-bl0ijq

code-generation community-building data-visualization developer-tools devops expressjs fitness-tracker goal-setting javascript machine-learning mvp nextjs postgresql progress-tracking social-fitness software-development supabase tailwindcss typescript user-interface

Last synced: about 6 hours ago
JSON representation

Project: Streamlined User Feedback Gathering Platform. Created at https://spectra.codes, which is owned by @Drix10

Awesome Lists containing this project

README

        




FitTrax-bl0ijq


A web application for fitness enthusiasts to track their progress, set goals, and share their achievements with friends


Developed with the software and tools below.



Framework - Next.js
Frontend - Javascript, Html, Css
Backend - Node.js
LLMs - Custom, Gemini, OpenAI



git-last-commit
GitHub commit activity
GitHub top language

## ๐Ÿ“‘ Table of Contents
- ๐Ÿ“ Overview
- ๐Ÿ“ฆ Features
- ๐Ÿ“‚ Structure
- ๐Ÿ’ป Installation
- ๐Ÿ—๏ธ Usage
- ๐ŸŒ Hosting
- ๐Ÿ“„ License
- ๐Ÿ‘ Authors

## ๐Ÿ“ Overview
The repository contains a Minimum Viable Product (MVP) called "FitTrax-bl0ijq" that provides a comprehensive solution for fitness enthusiasts to track their progress, set goals, and share their achievements with friends. The application leverages a robust tech stack, including:

- **Frontend:** Next.js 14, React, Tailwind CSS 3.x
- **Backend:** Node.js, Express.js
- **Database:** PostgreSQL, Supabase
- **Authentication:** NextAuth.js
- **State Management:** Zustand
- **Error Handling:** Sentry
- **API Documentation:** Swagger

## ๐Ÿ“ฆ Features

| | Feature | Description |
|----|--------------------|--------------------------------------------------------------------------------------------------------------------|
| โš™๏ธ | **Goal Setting and Tracking** | Users can set personalized fitness goals (weight loss, muscle gain, running distance, etc.), define targets, deadlines, and track progress using various methods. |
| ๐Ÿ“„ | **Progress Visualization** | The app provides clear and visually appealing progress reports using charts and graphs, allowing users to understand their progress and stay motivated. |
| ๐Ÿ”— | **Social Sharing** | Users can share their achievements and progress updates with their friends, fostering a supportive and engaging community within the application. |
| ๐Ÿงฉ | **Customizable Features** | Users can personalize their profiles, track different fitness metrics, and select specific goals to tailor the experience to their individual needs. |
| ๐Ÿงช | **Real-Time Data** | The app utilizes real-time data from fitness trackers and wearable devices, ensuring accurate and up-to-date progress updates. |
| โšก๏ธ | **User-Friendly Interface** | The app offers a clean, intuitive, and visually appealing interface, making it easy for users to navigate and access its features. |
| ๐Ÿ” | **Secure Data Protection** | User data is securely stored and protected, ensuring privacy and confidentiality. |
| ๐Ÿ”€ | **Seamless Integration** | The app seamlessly integrates with popular fitness trackers and wearable devices, providing a centralized platform for data collection and analysis. |
| ๐Ÿ”Œ | **Community Building** | The app facilitates the creation of a supportive community, enabling users to connect, motivate each other, and share their fitness journeys. |
| ๐Ÿ“ถ | **Scalable Architecture** | The app is designed with a scalable architecture to handle a growing user base, ensuring a smooth and efficient experience for all users. |

## ๐Ÿ“‚ Structure

```
โ”œโ”€โ”€ pages
โ”‚ โ”œโ”€โ”€ _app.tsx
โ”‚ โ”œโ”€โ”€ dashboard
โ”‚ โ”‚ โ””โ”€โ”€ page.tsx
โ”‚ โ”œโ”€โ”€ goals
โ”‚ โ”‚ โ”œโ”€โ”€ create
โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ page.tsx
โ”‚ โ”‚ โ”œโ”€โ”€ list
โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ page.tsx
โ”‚ โ”‚ โ””โ”€โ”€ update
โ”‚ โ”‚ โ””โ”€โ”€ page.tsx
โ”‚ โ”œโ”€โ”€ profile
โ”‚ โ”‚ โ””โ”€โ”€ page.tsx
โ”‚ โ”œโ”€โ”€ api
โ”‚ โ”‚ โ”œโ”€โ”€ auth
โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ [...nextauth].js
โ”‚ โ”‚ โ”œโ”€โ”€ goals
โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ route.ts
โ”‚ โ”‚ โ”œโ”€โ”€ progress
โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ route.ts
โ”‚ โ”‚ โ””โ”€โ”€ activity
โ”‚ โ”‚ โ””โ”€โ”€ route.ts
โ”‚ โ””โ”€โ”€ login
โ”‚ โ””โ”€โ”€ page.tsx
โ”œโ”€โ”€ components
โ”‚ โ”œโ”€โ”€ Dashboard.tsx
โ”‚ โ”œโ”€โ”€ GoalCard.tsx
โ”‚ โ”œโ”€โ”€ GoalForm.tsx
โ”‚ โ”œโ”€โ”€ ProgressChart.tsx
โ”‚ โ”œโ”€โ”€ SocialFeed.tsx
โ”‚ โ”œโ”€โ”€ UserAvatar.tsx
โ”‚ โ”œโ”€โ”€ Navigation.tsx
โ”‚ โ””โ”€โ”€ Button.tsx
โ”œโ”€โ”€ styles
โ”‚ โ””โ”€โ”€ global.css
โ”œโ”€โ”€ utils
โ”‚ โ”œโ”€โ”€ helpers.ts
โ”‚ โ””โ”€โ”€ constants.ts
โ””โ”€โ”€ server
โ””โ”€โ”€ index.js

```

## ๐Ÿ’ป Installation

### ๐Ÿ”ง Prerequisites
- Node.js
- npm
- Docker

### ๐Ÿš€ Setup Instructions
1. Clone the repository:
- `git clone https://github.com/spectra-ai-codegen/FitTrax-bl0ijq.git`
2. Navigate to the project directory:
- `cd FitTrax-bl0ijq`
3. Install dependencies:
- `npm install`

## ๐Ÿ—๏ธ Usage

### ๐Ÿƒโ€โ™‚๏ธ Running the Application
1. Start the development server:
- `npm run dev`
2. Open your browser and navigate to [http://localhost:3000](http://localhost:3000).

## ๐ŸŒ Hosting

### ๐Ÿš€ Deployment Instructions
To deploy the application to a hosting platform like Vercel or Netlify, follow these steps:

#### Vercel Deployment
1. Login to Vercel and create a new project.
2. Connect your GitHub repository to Vercel.
3. Choose the correct branch and deployment settings.
4. Click on "Deploy" to start the deployment process.

#### Netlify Deployment
1. Login to Netlify and create a new site.
2. Connect your GitHub repository to Netlify.
3. Select the appropriate settings for your deployment.
4. Click on "Deploy" to start the deployment process.

## ๐Ÿ“„ License

This Minimum Viable Product (MVP) is licensed under the [GNU AGPLv3](https://choosealicense.com/licenses/agpl-3.0/).

## ๐Ÿ‘ฅ Authors

- **Author Name** - [Spectra.codes](https://spectra.codes)
- **Creator Name** - [DRIX10](https://github.com/Drix10)


๐ŸŒ Spectra.Codes


Why only generate Code? When you can generate the whole Repository!



Developer - Drix10
Website - Spectra.codes
Backed by - Google, Microsoft & Amazon for Startups
Finalist - Backdrop Build v4