NeroFit

NeroFit is a Web3-powered fitness platform that leverages smart contracts, account abstraction (AA), and crypto-native incentives to gamify personal fitness. Users can participate in fitness challenges, authenticate using decentralized methods, and earn rewards in the form of the native FIT token. The platform prioritizes secure authentication, smooth frontend UX, and robust smart contract interaction through modular design.

The project is divided into three active branches:

frontend – for the UI/UX and Web3 integration

contract – for the Solidity-based smart contracts and deployment infrastructure

main – for merging, full-stack integration, and release management

🖥️ Frontend Branch
Purpose
The frontend branch houses the full Next.js interface for NeroFit, integrating Web3Auth, leaderboard displays, fitness challenges, wallet connections, and user profile management.

Key Milestones
✅ Overhaul UI with Next.js: A complete redesign for responsiveness and ease of integration.

✅ Add Leaderboard & Profiles: Display real-time participant stats and performance.

✅ Google & Social Login: Full integration of Google and wallet-based authentication for both Web2 and Web3 users.

✅ Web3Auth Modal & AA Login: Smooth Web3-native authentication using Web3Auth, compatible with account abstraction.

✅ Smart Contract Integration: Functional front-end logic tied into deployed smart contracts for challenge management.

✅ Dynamic Components & Dashboard Updates: Modular layout for dynamic display of fitness challenges and real-time stats.

✅ Token Contract Integration: The frontend communicates directly with the FIT token contract for interaction and balance updates.

✅ Bug Fixes & Cleanup: Removed node_modules from git tracking and fine-tuned build performance.

🛠️ Contract Branch
Purpose
The contract branch contains all smart contract logic written in Solidity, primarily handling fitness challenge logic, reward issuance, and interaction with the FIT token.

Key Milestones
✅ Forge Setup: Initialized with forge init, forge-std, and openzeppelin-contracts to ensure a secure and testable development stack.

✅ FIT Token & Challenge Contracts: Deployed smart contracts to support ERC-20 FIT tokens and modular challenge creation.

✅ Hardhat Deployment Script: Added full deployment tooling for local and live environments.

✅ Solidity Test Suite: Developed unit tests for challenge mechanics and reward distribution logic.

✅ Integration with Frontend: Contract endpoints and methods are structured to support the frontend's real-time requirements.

✅ Security Considerations: Contracts follow OpenZeppelin standards and include testable configurations to avoid exploits.

🧩 Main Branch
Purpose
The main branch represents the integrated full-stack version of NeroFit. It merges progress from both the frontend and contract branches and adds production-level stability.

Key Milestones
✅ Merge: new-frontend + contract: Unified codebase includes complete Web3 auth, UI, and contract integration.

✅ End-to-End Authentication: Finalized the AA-based login system with bug fixes for session persistence.

✅ Claim & Challenge Workflow: Users can now join, complete, and claim fitness challenge rewards.

✅ Dynamic Messaging & UX Cleanup: Improved user feedback during smart contract interactions.

✅ Backend Reconnection: Removed temp backend and reconnected to the live hosted version on Render.

✅ Clean Deployment: Removed unnecessary tracking (like node_modules) and updated README for clarity.

Quick Look
In a nutshell, NeroFit successfully implements:

• A fitness challenge engine using Solidity and ERC-20 tokens.
• Decentralized and Web2-friendly login via Web3Auth and social accounts.
• An interactive frontend for real-time user engagement and leaderboard dynamics.
• Modular and testable code across smart contracts and the frontend stack.
• Clean, branch-based structure for rapid development and team synergy.

The project is complete and functional with modular scalability options for future additions like wearable integration, mobile apps, or AI-powered fitness assessments.

Team Collaboration and Highlights
Branch-based division ensured independent parallel progress by specialists:

Serag – Frontend (UX/UI, Auth Integration)
Oscar – Backend (Server Routing, DB Ops)
Amityclev – Fullstack Blockchain (Smart Contracts, Web3 Integration)
Shelby – Project Manager

Account Abstraction (AA): Used throughout authentication and smart contract claim flow.

Hackathon-Ready: The entire architecture is deployable and ready for demo purposes or real-world pilot testing.

A loom link to the demo video for NeroFit: https://www.loom.com/share/84efb638bcb846259d1f03ea40884cb1?sid=d73d5977-dae1-45cc-8258-2bd112286224