☕ Brew Intelligence

Brew Intelligence, your personal coffee brewing companion. Whether you’re pulling a perfect espresso, dialing in a V60, or experimenting with your coffee setup, Brew Intelligence is here to help you brew better.

• View Project
• View API Documentation
• Report Bug

(back to top)

Features

• Browse a curated coffee bean library featuring origins, roast profiles, tasting notes, and processing methods.
• Add your own recipes and fine-tune them over time.
• Track your personal coffee beans, log roast dates, origin details, and freshness reminders to keep every cup fresh.
• Chat with Brew Intelligence to get real-time support guidance, from dialing in espresso to troubleshooting your pour-over.

(back to top)

Tech Stack

• Java Spring Boot
• PostgreSQL
• Redis
• React
• Tailwind CSS
• AWS EC2
• AWS RDS
• AWS Amplify
• Gemini API
• Swagger UI (API Documentation)

(back to top)

Getting Started

1. Clone the project

   git clone https://github.com/joshydavid/brew-intelligence.git
   

2. Install dependencies

   # frontend
   cd frontend
   bun install
   
   # backend
   cd backend
   mvn clean install -U
   

3. Set up environment variables

   # frontend
   cp .env.sample .env
   
   # backend
   cp .env.sample .env.local
   

4. Ensure you have PostgreSQL running locally (or accessible via network) with a database configured that matches the .env.local settings.

5. Run the project in development environment

   # frontend
   bun run dev
   
   # backend
   mvn spring-boot:run
   

(back to top)

Acknowledgement

Developed by Joshua David