{"id":30901772,"url":"https://github.com/buzz-brain/nutritionadvisor","last_synced_at":"2026-05-03T10:33:42.269Z","repository":{"id":311044926,"uuid":"1042239190","full_name":"Buzz-brain/nutritionadvisor","owner":"Buzz-brain","description":"NutritionAdvisor is a beautiful, interactive, and fully rule-based expert system for personalized nutrition advice. Built with React, TailwindCSS, shadcn/ui, Framer Motion, and lucide-react, this app guides users through a multi-step questionnaire and delivers expert recommendations tailored to their health goals, lifestyle, and dietary preferences","archived":false,"fork":false,"pushed_at":"2025-08-22T10:35:40.000Z","size":1692,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-09T08:26:22.084Z","etag":null,"topics":["balanced-diet","diet","expert-system","framer-motion","frontend","health","healthy-lifestyle","lucide-react","nutrition","personalized-advice","quiz","react","rule-based-system","shadcn-ui","tailwindcss","typescript","webapp","wellness"],"latest_commit_sha":null,"homepage":"https://nutritionadvisor.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Buzz-brain.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-21T17:42:02.000Z","updated_at":"2025-08-22T10:35:43.000Z","dependencies_parsed_at":"2025-08-21T21:36:17.597Z","dependency_job_id":null,"html_url":"https://github.com/Buzz-brain/nutritionadvisor","commit_stats":null,"previous_names":["buzz-brain/nutritionadvisor"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Buzz-brain/nutritionadvisor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buzz-brain%2Fnutritionadvisor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buzz-brain%2Fnutritionadvisor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buzz-brain%2Fnutritionadvisor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buzz-brain%2Fnutritionadvisor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Buzz-brain","download_url":"https://codeload.github.com/Buzz-brain/nutritionadvisor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buzz-brain%2Fnutritionadvisor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276474077,"owners_count":25648816,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-22T02:00:08.972Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["balanced-diet","diet","expert-system","framer-motion","frontend","health","healthy-lifestyle","lucide-react","nutrition","personalized-advice","quiz","react","rule-based-system","shadcn-ui","tailwindcss","typescript","webapp","wellness"],"created_at":"2025-09-09T07:02:10.139Z","updated_at":"2025-09-22T21:06:03.994Z","avatar_url":"https://github.com/Buzz-brain.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/logo.png\" alt=\"NutritionAdvisor Logo\" width=\"120\" /\u003e\n\u003c/p\u003e\n\n# NutritionAdvisor\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://vercel.com/\"\u003e\u003cimg src=\"https://img.shields.io/badge/deployed-Vercel-green\" alt=\"Vercel\" /\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/frontend-React-blue\" alt=\"React\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-yellow\" alt=\"MIT License\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/UI-TailwindCSS%20%7C%20shadcn%2Fui%20%7C%20Framer%20Motion-lightgreen\" alt=\"UI Stack\" /\u003e\n\u003c/p\u003e\n\nNutritionAdvisor is a beautiful, interactive, and fully rule-based expert system for personalized nutrition advice. Built with React, TailwindCSS, shadcn/ui, Framer Motion, and lucide-react, this app guides users through a multi-step questionnaire and delivers expert recommendations tailored to their health goals, lifestyle, and dietary preferences.\n\n\n## 🚀 Features\n\n- **Step-by-step Nutrition Quiz:** Age, gender, activity level, health goals, dietary preferences, medical conditions, and eating habits\n- **Rule-Based Inference Engine:** 15+ clear, domain-specific rules for nutrition advice, implemented in TypeScript\n- **Personalized Results:**\n  - Daily calorie target range\n  - Balanced plate macro ratios\n  - Actionable recommendations\n  - Foods to avoid\n  - Simple meal ideas (breakfast, lunch, dinner, snacks)\n- **Modern UI/UX:**\n  - Soft, healthy color palette\n  - Animated transitions (Framer Motion)\n  - Progress bars, card flip effects, subtle hover states\n  - Responsive design for mobile and desktop\n  - Beautiful results cards with food icons (🥦 🥩 🍞 🍎)\n- **State Management:** React Context API\n- **Restart \u0026 Retake Quiz:** Users can retake the quiz anytime\n- **Ready for Deployment:** Easily host on Vercel or similar platforms\n\n\n## 🛠️ Tech Stack\n\n- **Frontend:** React, TypeScript, TailwindCSS, Framer Motion, shadcn/ui, lucide-react\n- **State Management:** React Context API\n- **Backend:** (Optional) Node.js/Express or Python/Flask/FastAPI for server-side inference or data persistence\n- **Deployment:** Vercel (recommended)\n\n\n\n## 📦 Getting Started\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/Buzz-brain/nutritionadvisor.git\ncd nutritionadvisor\n```\n\n### 2. Install Dependencies\n\n```bash\nnpm install\n```\n\n### 3. Run Locally\n\n```bash\nnpm start\n```\n\nOpen [http://localhost:5173](http://localhost:5173) to view the app in your browser.\n\n### 4. Deploy to Vercel\n\n- Push your code to GitHub\n- Go to [Vercel](https://vercel.com/) and import your repository\n- Follow the prompts to deploy (Vercel auto-detects React/Vite projects)\n\n\n## 📁 Project Structure\n\n```text\n├── src/\n│   ├── components/         # UI components (Landing, Quiz, Results, UI)\n│   ├── context/            # Nutrition context provider\n│   ├── lib/                # Utility functions\n│   ├── types/              # TypeScript types\n│   ├── utils/              # Rule-based expert system logic\n│   ├── App.tsx             # Main app component\n│   ├── main.tsx            # Entry point\n│   └── index.css           # Global styles\n├── public/\n├── assets/                 # Screenshots, logo, banners\n├── package.json\n├── tailwind.config.js\n├── postcss.config.js\n├── vite.config.ts\n└── README.md\n```\n\n\n\n## 🧠 Rule-Based Expert System\n\nAll nutrition logic is implemented in [`src/utils/nutritionRules.ts`](src/utils/nutritionRules.ts) as a set of clear, maintainable rules. The NutritionAdvisor inference engine applies forward chaining to generate advice based on user answers.\n\n\n## 🎨 UI Preview\n\n\n**Landing Page**\n![Landing Page 1](assets/screenshot-landing-one.png)\n![Landing Page 2](assets/screenshot-landing-two.png)\n![Landing Page 3](assets/screenshot-landing-three.png)\n\n**Quiz Flow**\n![Quiz Flow](assets/screenshot-quiz.png)\n\n**Results Card**\n![Results Cards 1](assets/screenshot-results-one.png)\n![Results Cards 2](assets/screenshot-results-two.png)\n![Results Cards 3](assets/screenshot-results-three.png)\n\n**Print Modal**\n![Results Cards 4](assets/screenshot-print-modal.png)\n\n## ✨ Customization\n\n- Add new rules or modify existing ones in `nutritionRules.ts`\n- Update UI components for new features or branding\n- Integrate a backend for user history or advanced analytics (optional)\n\n\n## 📄 License\n\nThis project is licensed under the MIT License.\n\n\n## 🙏 Credits\n\n- UI components: [shadcn/ui](https://ui.shadcn.com/)\n- Icons: [lucide-react](https://lucide.dev/)\n- Animations: [Framer Motion](https://www.framer.com/motion/)\n\n---\n\n## 🧑‍💻 Author\n\n**Nduoma Chinomso Christian**  \n_AKA Buzz brain_\n\n---\n\n**Impress your users and evaluators with NutritionAdvisor, a world-class, interactive nutrition expert system!**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuzz-brain%2Fnutritionadvisor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbuzz-brain%2Fnutritionadvisor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuzz-brain%2Fnutritionadvisor/lists"}