Fuel your nutritional momentum with precision.
NutraFlux is a premium, local-first daily calorie and macro tracker built for those who demand speed, privacy, and technical excellence.
- 🌟 Overview
- ✨ Key Features
- 🛠️ Tech Stack
- 🚀 Getting Started
- 🏗️ Project Architecture
- 🔐 Privacy & Data Philosophy
- 🤝 Contributing
- ⚖️ License
- 🙏 Acknowledgements
NutraFlux is a high-performance nutritional tracking application designed for power users who value both their time and their data privacy. It eliminates the friction of traditional trackers by offering an instant, search-first logging experience combined with a stunning glassmorphism interface.
Unlike many modern trackers that rely on slow API calls and invasive data-sharing, NutraFlux is built with a local-first architecture. Your personal data never leaves your browser, ensuring zero-latency interactions and 100% offline capability.
| Feature | Description |
|---|---|
| ⚡ Nutra-Speed Logging | Instant, search-first interface for logging meals in seconds. |
| 🔍 Metri-Food Lookup | Advanced full-text search with wildcard support over a compact local catalog. |
| 🥗 Flux Categories | Smart categorization into Breakfast, Lunch, Dinner, and Snacks. |
| 📊 Precision Momentum | Real-time progress indicators and calorie budgeting visualizations. |
| ❤️ Smart Memory | One-tap logging for favorites and recently used foods. |
| 🌒 Technical Aesthetic | State-of-the-art glassmorphism UI with native Light/Dark/System support. |
| 📱 Adaptive Design | Optimized for mobile-first workflows without sacrificing desktop power. |
NutraFlux is engineered using the most resilient modern frontend standards:
- Core: React 19 + TypeScript (Strict Mode)
- Framework: Vite for ultra-fast HMR and optimized builds
- Styling: Tailwind CSS 4 (Leveraging OKLCH color space & container queries)
- Design System: Radix UI primitives + custom glassmorphic components
- Experience: Lucide React for iconography & Sonner for toast management
- Node.js:
v22.0.0or higher - pnpm:
v10.0.0or higher (Recommended)
-
Clone the repository:
git clone https://github.com/johnnylemonny/NutraFlux.git cd NutraFlux -
Install dependencies:
pnpm install
-
Spin up the development environment:
pnpm dev
-
Prepare for production:
pnpm build
src/
├── components/ # Atomic UI components & custom Design System
├── data/ # Optimized local nutritional catalogs
├── hooks/ # Reactive logic for tracking, theming, and persistence
├── lib/ # Utilities, math engines, and formatting helpers
├── types/ # Comprehensive TypeScript definitions
└── App.tsx # Root orchestrator and layout definition
NutraFlux strictly adheres to the local-first principle:
- Zero Cloud: No servers, no syncing, no data leaks.
- Client-Side Storage: All nutritional history and user preferences are stored in
localStorage. - Absolute Ownership: Your health data belongs to you, and you alone. It exists only on your device.
- Offline Integrity: The app is fully functional without an internet connection, ensuring your tracking isn't interrupted by network issues.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Please review our Contributing Guidelines before starting.
- Check the Projects and Issues for open tasks.
- Open a Pull Request using our Standard Template.
Distributed under the GNU Affero General Public License v3 (AGPL-3.0). See LICENSE for more information. This license was chosen to ensure the software remains free and that any improvements are contributed back to the public domain.
- Inspired by the App Ideas community.
- Icons by Lucide.
- Design inspiration from various glassmorphism case studies.
Built with technical passion as part of a public open-source health ecosystem.
_ _ _ ______ _ | \ | | | | | ____| | | \| |_ _| |_ _ __ __ _ | |__ | |_ ___ __ | . ` | | | | __| '__/ _` || __| | | | | \ \/ / | |\ | |_| | |_| | | (_| || | | | |_| |> < |_| \_|\__,_|\__|_| \__,_||_| |_|\__,_/_/\_\
