https://github.com/devradheee/lunchspin.ai
LunchSpin.ai is a playful GenAI-powered meal decision app that helps users break food indecision. Whether you’re eating out or cooking at home, it gives 3 smart, quirky suggestions and lets you spin a slot-style picker to let fate choose your meal.
https://github.com/devradheee/lunchspin.ai
expressjs giminiapi html5 javascript nextjs14 nodejs reactjs tailwindcss typescript
Last synced: 2 months ago
JSON representation
LunchSpin.ai is a playful GenAI-powered meal decision app that helps users break food indecision. Whether you’re eating out or cooking at home, it gives 3 smart, quirky suggestions and lets you spin a slot-style picker to let fate choose your meal.
- Host: GitHub
- URL: https://github.com/devradheee/lunchspin.ai
- Owner: devradheee
- Created: 2025-08-27T21:07:37.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-04T19:16:34.000Z (10 months ago)
- Last Synced: 2025-09-04T21:22:42.746Z (10 months ago)
- Topics: expressjs, giminiapi, html5, javascript, nextjs14, nodejs, reactjs, tailwindcss, typescript
- Language: JavaScript
- Homepage: https://lunch-spin-ai.vercel.app
- Size: 873 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## 🍽️ LunchSpin.ai
**LunchSpin.ai** is a delightful GenAI-powered web application designed to help users decide what to eat or cook when they’re feeling indecisive. Powered by Google Gemini's LLM, it generates fun and quirky suggestions and lets you spin a slot-style animated picker for a gamified experience. Whether you're eating out or cooking at home, LunchSpin makes food choices feel spontaneous and joyful.
---
### 🚀 Features
* **Dual Modes:**
* *Eat Out:* Get 3 creative dish/restaurant ideas based on your cravings and location with ready-to-use Google Maps links.
* *Cook at Home:* Enter your ingredients and receive 3 unique recipe ideas with steps, commentary, and key ingredients.
* **Animated Spinner Wheel:** Gamify your decision-making with a smooth slot-style spinner that selects one suggestion for you.
* **Gemini AI Integration:** Prompts are crafted dynamically and sent to Google's Gemini API for rich, structured responses.
* **Responsive UI:** Built with Tailwind CSS and Framer Motion for a smooth, mobile-friendly experience.
* **Shareable Suggestions:** Share your spun result using the Web Share API or copy it to clipboard with one click.
---
### 🛠️ Tech Stack
* **Frontend:** Next.js (App Router), React, TypeScript
* **Styling:** Tailwind CSS
* **Animations:** Framer Motion
* **AI Integration:** Google Gemini API
---
### 📦 Dependencies
```json
"framer-motion": "^10.16.3",
"lucide-react": "^0.321.0",
"react": "^18.2.0",
"next": "^14.1.0",
"tailwindcss": "^3.4.1"
```
---
### 💻 Running the Project Locally
1. **Clone the Repository**
```bash
git clone https://github.com/devradheee/lunchspin-ai.git
cd lunchspin-ai
```
2. **Install Dependencies**
```bash
npm install
```
3. **Add Your API Key**
Create a `.env.local` file:
```
NEXT_PUBLIC_GOOGLE_API_KEY=your_gemini_api_key_here
```
4. **Run the Development Server**
```bash
npm run dev
```
Visit `http://localhost:3000` to use LunchSpin locally.
---
### 🌐 Live Demo
Experience it live at: [https://lunchspin-ai.vercel.app](https://lunch-spin-ai.vercel.app/)
---
### 🧠 Gemini API Prompt Design
Custom prompts are crafted dynamically based on user input:
* For **Eat Out**, prompts include location and preferences (e.g., "cheap, spicy, veg")
* For **Cook at Home**, prompts include ingredient list, and return structured recipe details
The response schema is strictly typed and validated for consistency across user sessions.
---
### ✨ UI & UX Highlights
* Clean dual-mode toggle for "Eat Out" or "Cook at Home"
* Reusable, animated suggestion cards
* Loading indicators and animations to enhance interactivity
* Visually appealing spinner UI with highlight zone and glow
* Adaptive layout with mobile responsiveness
---
### 📬 Contact
* GitHub: [@devradheee](https://github.com/devradheee)
* LinkedIn: [Radheshyam Kushawaha](https://www.linkedin.com/in/radheshyam-kumar/)
* Portfolio: [Radheshyam-portfolio](https://radheee.vercel.app/)