Skip to content

Project: Core Feature Implementation and User Feedback Testing. Created at https://spectra.codes, which is owned by @Drix10

Notifications You must be signed in to change notification settings

coslynx/FitStep-n8en4j

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

25 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

FitTrack

A web application designed to empower fitness enthusiasts to track their progress, stay motivated, and connect with a supportive community.

Developed with the software and tools below.

git-last-commit GitHub commit activity GitHub top language

πŸ“‘ Table of Contents

  • πŸ“ Overview
  • πŸ“¦ Features
  • πŸ“‚ Structure
  • πŸ’» Installation
  • πŸ—οΈ Usage
  • 🌐 Hosting
  • πŸ“„ License
  • πŸ‘ Authors

πŸ“ Overview

This repository contains the FitTrack MVP, a web application designed to empower fitness enthusiasts to track their progress, stay motivated, and connect with a supportive community.

πŸ“¦ Features

Feature Description
πŸ” User Authentication Secure sign-up and login using email/password or social media accounts like Google or Facebook. This ensures user privacy and data security.
🎯 Personalized Goal Setting Empowering users to define individual fitness goals with specific targets and timelines, allowing for a customized approach to fitness.
πŸ“ˆ Progress Tracking and Visualization Providing tools to log workouts, dietary information, and track progress towards set goals in a clear and engaging manner.
🀝 Social Sharing and Community Building Facilitating the sharing of progress updates, achievements, and motivational messages with friends and followers, fostering a supportive community.
🎨 User-Friendly Interface Developing an intuitive and easy-to-navigate interface that ensures a seamless user experience.
πŸš€ Scalability The application is designed to handle a growing user base and increasing data volume.
πŸ›‘οΈ Security Robust security measures are implemented to protect user data and ensure a safe and secure experience.

πŸ“‚ Structure

FitTrack
β”œβ”€β”€ 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
β”œβ”€β”€ .env
β”œβ”€β”€ package.json
β”œβ”€β”€ README.md
β”œβ”€β”€ tailwind.config.ts
└── tsconfig.json

πŸ’» Installation

πŸ”§ Prerequisites

  • Node.js
  • npm
  • Docker

πŸš€ Setup Instructions

  1. Clone the repository:
    • git clone https://github.com/<github account username>/FitTrack.git
  2. Navigate to the project directory:
    • cd FitTrack
  3. Install dependencies:
    • npm install

πŸ—οΈ Usage

πŸƒβ€β™‚οΈ Running the FitTrack MVP

  1. Start the development server:
    • npm run dev
  2. Open your browser and navigate to http://localhost:3000.

βš™οΈ Configuration

Adjust configuration settings in .env and next.config.js.

πŸ“š Examples

  • πŸ“ Example 1: How to set a new fitness goal.
  • πŸ“ Example 2: How to log a workout and track progress.
  • πŸ“ Example 3: How to connect with friends and share progress updates.

🌐 Hosting

πŸš€ Deployment Instructions

Vercel Deployment

  1. Sign up for a Vercel account.
  2. Install the Vercel CLI: npm install -g vercel
  3. Initialize Vercel in your project: vercel init
  4. Deploy your project: vercel deploy

Heroku Deployment

  1. Install the Heroku CLI: npm install -g heroku
  2. Log in to Heroku: heroku login
  3. Create a new Heroku app: heroku create <app-name>
  4. Set environment variables: heroku config:set DB_HOST=<your_db_host> DB_USER=<your_db_user> DB_PASS=<your_db_password>
  5. Deploy your project: git push heroku main

πŸ“œ API Documentation

πŸ” Endpoints

  • GET /api/goals: Retrieves a list of user goals.
  • POST /api/goals: Creates a new goal.
  • PUT /api/goals/:id: Updates a goal.
  • DELETE /api/goals/:id: Deletes a goal.
  • POST /api/progress: Logs a new workout.
  • GET /api/progress/:goalId: Retrieves progress data for a specific goal.

πŸ”’ Authentication

Use JSON Web Tokens (JWT) for authentication.

πŸ“ Examples

  • curl -X GET http://localhost:3000/api/goals

πŸ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ‘₯ Authors

🌐 Spectra.Codes

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