- Overview
- Project Insights
- Live Demo
- Core Features
- Technology Stack
- Getting Started
- Acknowledgments
- Contact
- How to Contribute
- Contributing
- Code of Conduct
- Contribution Guidelines
- Suggestions & Feedback
- Show Your Support
- License
- Stargazers
- Forkers
- Project Admin
ThunderLean is a revolutionary web application that redefines your fitness journey. By harnessing the power of Artificial Intelligence, we provide you with smart, personalized insights into your meals, helping you to effortlessly manage your caloric intake and expenditure. Our goal is to make fitness tracking intuitive, accessible, and highly effective for everyone.
| 🌟 Stars | 🍴 Forks | 🐛 Issues | 🔔 Open PRs | 🔕 Closed PRs | 🛠 Languages | 👥 Contributors |
 |
 |
 |
 |
 |
 |
 |
Experience ThunderLean live here:
Our application is packed with a suite of features designed to support you every step of the way on your fitness journey:
- 🤖 AI Calorie Tracker: Simply describe your meal or snap a picture, and our Gemini-powered AI will provide an estimate of its nutritional content, including calories, protein, carbs, and fat.
- 🧮 TDEE Calculator: Determine your Total Daily Energy Expenditure (TDEE) to understand your body's needs. Get tailored calorie targets for maintaining, losing, or gaining weight.
- 📊 Interactive Dashboard: A beautifully designed dashboard to visualize your daily nutrition, track your progress with an interactive calendar, and monitor your goals at a glance.
- 💡 Personalized Tips: Receive customized advice to help you achieve your specific fitness goals, whether it's weight loss, weight gain, or muscle building.
🌟 Exciting News...
🚀 This project is now an official part of GirlScript Summer of Code – GSSoC'25! 💃🎉💻 We're thrilled to welcome contributors from all over India and beyond to collaborate, build, and grow ThunderLean! Let’s make learning and career development smarter – together! 🌟👨💻👩💻
👩💻 GSSoC is one of India’s largest 3-month-long open-source programs that encourages developers of all levels to contribute to real-world projects 🌍 while learning, collaborating, and growing together. 🌱
🌈 With *mentorship, community support, and *collaborative coding, it's the perfect platform for developers to:
- ✨ Improve their skills
- 🤝 Contribute to impactful projects
- 🏆 Get recognized for their work
- 📜 Receive certificates and swag!
🎉 I can’t wait to welcome new contributors from GSSoC 2025 to this ThunderLean project family! Let's build, learn, and grow together — one commit at a time. 🔥👨💻👩💻
This project is a monorepo that includes both the frontend and backend applications, built with a modern and robust technology stack:
- Framework: React
- Build Tool: Vite
- Routing: React Router
- Styling: Tailwind CSS
- Charts: Chart.js with react-chartjs-2
- HTTP Client: Axios
- Framework: Express.js
- Environment Variables: dotenv
- API Communication: Axios for requests to the Gemini API
- Middleware: CORS, Helmet
- Image Upload: Multer
To get a local copy of ThunderLean up and running, please follow these simple steps.
- Node.js (v18.0.0 or higher)
- npm or yarn
-
Clone the repository:
sh git clone https://github.com/bhavishyaplawat/thunderlean.git cd thunderlean
-
Setup the Backend:
-
-
Navigate to the backend directory: sh cd Backend
-
Install NPM packages:
sh npm install
-
Create a .env file in the Backend directory and add your Google Gemini API key:
GEMINI_API_KEY=YOUR_API_KEY_HERE PORT=8080
-
Start the backend server:
sh node app.js
The server will be running at http://localhost:8080.
-
-
Setup the Frontend:
-
In a new terminal, navigate to the frontend directory: sh cd frontend
-
Install NPM packages:
sh npm install
-
Start the frontend development server:
sh npm run dev
The application will be available at http://localhost:5173.
-
Report bugs and issues or propose improvements through our GitHub repository's "Issues" tab.
- Firstly Star (⭐) the Repository
- Fork the Repository and create a new branch for any updates/changes/issue you are working on.
- Start Coding and do changes.
- Commit your changes
- Create a Pull Request which will be reviewed and suggestions would be added to improve it.
- Add Screenshots and updated website links to help us understand what changes is all about.
We welcome all contributions and suggestions! Whether it's a new feature, design improvement, or a bug fix - your voice matters 💜
Your insights are invaluable to us. Reach out to us team for any inquiries, feedback, or concerns.
Contributions are the lifeblood of the open-source community and are greatly appreciated. Your contributions will help make ThunderLean an even better tool for everyone.
- Thanks to all contributors of this project
- Special shoutout to GirlScript Summer of Code (GSSoC’25) for the amazing community and support!
- Built with dedication, collaboration, and lots of chai
- Inspiration and motivation from the fitness and tech communities.
- GitHub Issues: Report bugs or request features
- Email: Contact the maintainers for collaboration opportunities
Feel free to reach out with any questions or feedback!
We love contributions from the community! Whether it's a bug report, a new feature, or a documentation improvement, we appreciate your help.
How to Contribute
- Fork the repository and create a new branch for your changes.
- Make your changes and ensure everything is working as expected.
- Submit a pull request with a clear description of your changes.
Found a Bug?
- Check the issue tracker to see if the bug has already been reported.
- If not, open a new issue and provide as much detail as possible.
Have a Feature Idea?
- We'd love to hear it! Open an issue to discuss your idea.
We welcome contributions from developers of all skill levels! Here are some ways you can contribute:
- 🐛 Bug fixes - Help us identify and fix bugs
- ✨ New features - Suggest and implement new functionality
- 📚 Documentation - Improve our docs and guides
- 🎨 UI/UX improvements - Make the platform more user-friendly
- 🔧 Performance optimizations - Help make ThunderLean faster and more efficient
- 📱 Mobile responsiveness - Improve the mobile experience
- 🔒 Security enhancements - Help keep user data safe
Thank you to everyone who has made ThunderLean better! 💚
Please refer to the Code of Conduct for details on contributing guidelines and community standards.
We love our contributors! If you'd like to help, please check out our CONTRIBUTE.md file for guidelines.
Thank you once again to all our contributors who has contributed to ThunderLean! Your efforts are truly appreciated. 💖👏
See the full list of contributors and their contributions on the GitHub Contributors Graph.
Feel free to open issues or discussions if you have any feedback, feature suggestions, or want to collaborate!
If you find ThunderLean project helpful, give it a star! ⭐ to support more such educational initiatives:
- ⭐ Starring the repository
- 🐦 Sharing on social media
- 💬 Telling your friends and colleagues
- 🤝 Contributing to the project
This project is licensed under the MIT License - see the License file for details.
 Bhavishya plawat 
|
| Role | Name | GitHub Profile | LinkedIn Profile |
|---|---|---|---|
| Mentor 1 | Nookala Rajesh | nrajesh1091 | rajesh-n |
Open an Issue | 🌟 Star on GitHub | 🚀 Live Demo
Ready to show off your coding achievements? Get started with ThunderLean today! 🚀