🏆 1st Place Overall & AI/ML Track Winner @ HackHounds 2025
Personalized bucket lists powered by AI. Designed to help you explore your passions, one curated list at a time.
Note
This project is still in development. Check out the Live Demo.
Bucket is an AI-powered bucket list generator built for people exploring new places, starting internships, or just trying to discover new passions. Based on your location, interests, budget, availability, and more, it generates a list of unique experiences for you to explore.
Whether you're solo, social, outdoorsy, or a foodie, Bucket has something for everyone.
- 🌐 AI-generated activities powered by the Gemini API
- 📍 Location-aware suggestions
- 💸 Personalized to your budget and availability
- 🧭 Perfect for interns and explorers in unfamiliar cities
- ✨ Smooth animated word transitions using Framer Motion
- 🧠 Dynamic sparkles and branding visuals for delight
Tip
Bucket learns your preferences to give you ideas you didn’t even know you were looking for.
- Next.js (App Router)
- JavaScript
- Tailwind CSS
- Framer Motion
- Material UI
- Gemini API
- FontSource – Poppins, Inter, Inria Serif
📦 bucket
├── .next
├── bucket
├── node_modules
├── public
│ ├── images & assets
├── src
│ ├── app
│ │ ├── api
│ │ │ └── generate
│ │ │ └── page.js
│ │ ├── layout.js
│ │ └── page.js
│ ├── components
│ │ ├── animated.js
│ │ ├── bucket_item.jsx
│ │ ├── navbar.js
│ │ ├── summerLoader.js
│ │ ├── trusted.js
│ │ └── trusted2.js
│ └── globals.css
To run Bucket locally:
- Clone the repository
git clone https://github.com/kelechi055/bucket.git
cd bucket- Install dependencies
npm install- Set up environment variables
Note
You’ll need access to the Gemini API to use the generation feature.
Create a .env.local file:
GEMINI_API_KEY=your_gemini_api_key- Run the development server
npm run devOpen http://localhost:3000 to view the app.
| Script | Description |
|---|---|
dev |
Starts the local development server |
build |
Builds the app for production |
start |
Starts the production server |
lint |
Runs ESLint |
Got ideas or improvements? Feel free to fork the repo, submit issues, or open a PR. All contributions are welcome.
MIT License © 2025
Tip
This project was built with a focus on real-world usability. Whether you're a summer intern or just exploring a new city — Bucket makes planning adventures fun, personalized, and effortless.
Note
Bucket is not fully responsive on mobile due to time constraints; it's best used on desktop.
Caution
Still polishing things! Expect frequent changes as we work toward the full release.