Skip to content

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

🏋️‍♂️ FitNest – Train Hard. Earn Tokens. Stay Fit.

A smart fitness tracker and gym companion that helps you log workouts, track progress, and crush your fitness goals—all in one place.

Welcome to FitNest, a Web3 Fitness Rewards Platform where your workouts don’t just make you stronger — they make you richer 💪💰.

We combine fitness tracking + Solana blockchain rewards to keep you motivated, consistent, and part of a global fitness community.


✨ Key Features

  • 🔐 Wallet Login → Sign in with Solana wallet (Phantom / Solflare).
  • 🎯 Set & Track Goals → Steps, calories, workouts, or distance.
  • 💎 Earn FITCOIN → Get rewarded with our token for completing goals.
  • 🏆 Leaderboards & Streaks → Compete with friends, stay motivated.
  • 🖼️ NFT Badges → Unlock achievements & collect unique digital rewards.
  • 🔄 Stake & Boost → Stake FITCOIN to multiply your rewards.

🪙 Tokenomics (FITCOIN)

  • Total Supply: 1,000,000,000 FITCOIN (fixed cap).
  • Reward Model: Daily goals, weekly streaks, challenges.
  • Utility: Unlock premium features, buy NFTs, stake for boosts.
  • Deflationary: NFT mints, challenge fees, and premium burns reduce supply.

🛠️ Tech Stack

  • Frontend: Next.js + TailwindCSS + shadcn/ui + Framer Motion
  • Backend: Node.js / Express + MongoDB (or Postgres) + Redis
  • Blockchain: Solana (SPL Token, Wallet Adapter)
  • Deployment: Vercel + VPS

🖼️ System Overview

flowchart TD
  A[Frontend: Next.js + Tailwind] -->|Connects| B[Auth Backend]
  A --> C[Dashboard UI]
  B -->|pubId| D[Database (Mongo/Postgres)]
  D --> E[Redis Cache]
  C -->|Goal Events| F[Goal Backend]
  F -->|Verify & Reward| G[Solana Wallet + FITCOIN]
  G --> H[User Wallet]
  C --> I[Leaderboard + NFT Badges]
Loading

🚀 Getting Started

1. Clone the Repo

git clone https://github.com/yourusername/fit2earn.git
cd fit2earn

2. Install Dependencies

npm install

3. Setup Environment

Create a .env.local file with:

NEXT_PUBLIC_SOLANA_NETWORK=devnet
MONGODB_URI=your_mongo_connection
REDIS_URL=your_redis_url
TOKEN_MINT_ADDRESS=your_fitcoin_token_address

4. Run the Dev Server

npm run dev

App runs on http://localhost:3000 🎉


📱 App Walkthrough

🔑 Landing & Wallet Connect

  • Clean hero section.
  • CTA → Connect Wallet.
  • Login happens with Solana wallet.

🏠 Dashboard

  • Daily Goal Card → progress bar (e.g., 7km/10km).
  • Streak Counter 🔥 → track your consistency.
  • FITCOIN Balance → live wallet integration.
  • Leaderboard Preview → see top 5 users.

🎯 Goals

  • Set custom fitness goals.
  • Mark them complete.
  • Verified → reward issued automatically.

💎 Rewards

  • Claim FITCOIN.
  • Unlock NFT badges.
  • Stake tokens to boost future earnings.

👤 Profile

  • View stats (total workouts, streaks, FITCOIN earned).
  • Manage preferences (dark/light theme).

🌍 Roadmap

Phase 1 – MVP

  • Wallet login, set goals, claim FITCOIN.

Phase 2 – Growth

  • Auto-verification with Google Fit / Apple Health.
  • Leaderboards, NFT badges, anti-cheat measures.

Phase 3 – Scale

  • Marketplace for fitness goods/services.
  • DAO governance.
  • Partnerships with gyms & brands.

👥 Community

Join our global fitness tribe:

  • 🏃 Share streaks.
  • 🏆 Compete in challenges.
  • 💬 Vote on new features via DAO.

🤝 Contributing

  1. Fork this repo.
  2. Create a feature branch.
  3. Commit & push changes.
  4. Open a PR 🚀.

📜 License

MIT © 2025 – FitNest Project Team.


🔥 Train Hard. Earn Tokens. Stay Fit.
That’s the FitNest way.

About

FitNest is a smart fitness tracker and gym companion that helps you log workouts, track progress, and crush your fitness goals—all in one place.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages