BeanVoyage ☕️✨

BeanVoyage is an AI-powered cafe ecosystem designed to take the guesswork out of your morning brew. Whether you're feeling adventurous or need a caffeine kick that respects your dietary restrictions, BeanVoyage acts as your personal digital barista.

---

🌟 The Vision

Choosing from a massive menu can be overwhelming. BeanVoyage solves this by using AI to bridge the gap between a customer's current state and their perfect order.

Key Features

• Mood & Health Profiling: The AI suggests items based on how you feel (stressed, tired, happy) while strictly adhering to your allergy preferences.
• The "Perfect Match": No more scrolling; get a curated recommendation that fits your flavor profile.
• Smart Bundling:
  • Bespoke Bundles: AI analyzes your history to suggest a complete meal (e.g., your favorite latte paired with a specific pastry).
  • Surprise Bundles: Let the AI surprise you with a mystery combination based on what's trending and what you love.

---

🛠 Project Status: Proof of Concept

Development Note: The AI engine and Backend are currently under construction. 🏗️

The Frontend is ready to play with! To provide a functional experience immediately, this version uses Local Storage to simulate the database and user persistence. You can test the UI, add items to your cart, and navigate the flow as a proof of concept.

---

🚀 Getting Started

Experience the interface right now by running the frontend locally.

Installation

1. Clone the repo:

   git clone [https://github.com/YOUR_USERNAME/BeanVoyage.git](https://github.com/YOUR_USERNAME/BeanVoyage.git)

2. Navigate to the folder:

   cd BeanVoyage

3. Launch:
   • Simply open index.html in your browser, or:

   # If using npm
   npm install
   npm start

---

🛣 Roadmap

• Phase 1: High-fidelity Frontend UI & Local Storage logic.
• Phase 2: Python/Node.js Backend & Database integration.
• Phase 3: AI Recommendation Engine (LLM implementation).
• Phase 4: Smart Bundle generation (Bespoke & Surprise).

---

🤝 Contributing

Since the AI and Backend are still in the works, contributions are welcome!

1. Fork the Project.
2. Create your Feature Branch (git checkout -b feature/NewFeature).
3. Commit your Changes (git commit -m 'Add some NewFeature').
4. Push to the Branch (git push origin feature/NewFeature).
5. Open a Pull Request.

---

📄 License

Distributed under the MIT License.

---

Created with ❤️ for coffee lovers and tech enthusiasts.