Skip to content

๐ŸŒฑ A gamified, AI-powered Web3 app designed to make recycling intuitive, engaging, and rewarding ๐ŸŒฑ

Notifications You must be signed in to change notification settings

Zburgers/WasteWise

Repository files navigation

โ™ป๏ธ๐Ÿง  WasteWise

โ–ˆโ–ˆโ•—    โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•—    โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—
โ–ˆโ–ˆโ•‘    โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•โ•šโ•โ•โ–ˆโ–ˆโ•”โ•โ•โ•โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•โ–ˆโ–ˆโ•‘    โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•
โ–ˆโ–ˆโ•‘ โ–ˆโ•— โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—   โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—  โ–ˆโ–ˆโ•‘ โ–ˆโ•— โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—  
โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•‘โ•šโ•โ•โ•โ•โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•”โ•โ•โ•  โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ•šโ•โ•โ•โ•โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ•  
โ•šโ–ˆโ–ˆโ–ˆโ•”โ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•‘  โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ•šโ–ˆโ–ˆโ–ˆโ•”โ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—
 โ•šโ•โ•โ•โ•šโ•โ•โ• โ•šโ•โ•  โ•šโ•โ•โ•šโ•โ•โ•โ•โ•โ•โ•   โ•šโ•โ•   โ•šโ•โ•โ•โ•โ•โ•โ• โ•šโ•โ•โ•โ•šโ•โ•โ• โ•šโ•โ•โ•šโ•โ•โ•โ•โ•โ•โ•โ•šโ•โ•โ•โ•โ•โ•โ•
WasteWise Logo

Next.js Firebase TypeScript

Stars Forks Issues License

๐ŸŒฑ A gamified, AI-powered Web3 app designed to make recycling intuitive, engaging, and rewarding ๐ŸŒฑ

Created by Nakshatra (Zburgers) for the Apex Hacks II Hackathon

๐Ÿ“‹ Inspiration

Ever stared at trash, wondering "Where does this even go?"

We did too. That simple question sparked WasteWise โ€” a gamified, AI-powered Web3 app designed to make recycling intuitive, engaging, and rewarding.

We were inspired by:

  • The sheer confusion around waste classification
  • The massive environmental impact of improper recycling
  • The missed opportunity to teach people โ€” especially kids โ€” about sustainable living

Tackling this serious challenge through something fun and intelligent was our moonshot.

WasteWise is more than an app. It's a movement. A playful entry point into the world of eco-responsibility, blending AI + Web3 + gamification into a solution we actually want to use.

In a world full of complex climate problems, WasteWise is our way of starting with one simple act: sorting trash smarter.

๐Ÿ”„ What It Does

WasteWise helps users identify and sort waste correctly using AI image classification, while earning points, completing challenges, and competing on leaderboards.

It turns sustainability into a social, gamified, and educational experience โ€” powered by modern tech.


Upload Photo
โžก๏ธ
AI Classification
โžก๏ธ
Earn Points
โžก๏ธ
Compete Globally

๐Ÿงฉ Core Features

AI Waste Classifier

Upload a photo, get instant classification + region-specific disposal tips

Chat with WasteWizard

AI chatbot answers recycling queries with local awareness

Community Challenges

Missions + social sharing for bonus points

Global Leaderboards

Compete weekly, monthly, and all-time

Levels + Badges

XP-driven levels + achievement-based badge system

Mintable NFT Badges

On-chain proof of eco-effort

Web3 Auth

Sign in with MetaMask, Google, or Apple (WIP)

Sustainability First

Learn while taking action

It's not just a tool โ€” it's a game, a classroom, and a movement.

๐Ÿ”๏ธ How We Built It

This project started as a curious experiment and scaled into an ambitious Web3 MVP.

We started prototyping in Firebase Studio, brainstorming with Gemini + ChatGPT, then transitioned to a full-stack modern dev environment for polish and control.

๐Ÿ”ง Build Phases

๐Ÿง  AI Core

  • Built the image classification module for waste detection
  • Integrated WasteWizard chatbot via Genkit + Google AI

๐ŸŽฎ Gamification

  • MVP point system, leveling, and badge logic (memory state)
  • Community challenge flow added

๐ŸŒ Web3 Auth & NFTs

  • MetaMask integration via Web3Auth + Ethers.js
  • Badge-to-NFT minting for bragging rights

๐ŸŽจ UI/UX

  • Tailwind + Radix UI for clean design
  • Framer Motion for animations
  • Component render optimization for speed

๐Ÿ—ƒ๏ธ Backend (WIP)

  • Partial PostgreSQL + Prisma setup
  • Mocked in-memory state for fast prototyping

๐Ÿงฐ Tech Stack

Layer Technologies Used
Frontend Next.js, React, TypeScript, Tailwind CSS, Radix UI, Framer Motion
State/Forms React Hook Form, Tanstack React Query
Data Viz Recharts (Leaflet dropped)
Backend Next.js API Routes, Prisma, PostgreSQL (partial), Firebase
AI Genkit, Google AI
Auth/Web3 Firebase Auth, Web3Auth, WalletConnect, MetaMask, Ethers.js
Tooling ESLint, dotenv, Turbopack, Patch-package, TSX

๐Ÿšง Challenges We Ran Into

  • ๐Ÿ—บ๏ธ Map module bugs (Leaflet): Dropped to prioritize core functionality
  • โš™๏ธ Backend bottlenecks: Time constraints limited DB implementation
  • ๐ŸŽž๏ธ Framer Motion: Performance impact required animation cuts
  • ๐Ÿ” Apple OAuth: Needed credentials we couldn't fetch in time
  • โฑ๏ธ Time pressure: Building AI + Web3 + gamification in 48 hrs was intense

โœ… Accomplishments We're Proud Of

  • ๐ŸŽฏ Shipped a fully functional MVP with real UX
  • ๐Ÿš€ Integrated Web3: Wallet auth + NFT badge minting
  • ๐ŸŽฎ Built a gamified platform that's fun and educational
  • ๐Ÿ’ก Made something we'd actually use
  • โ™ป๏ธ Built a tool that blends sustainability, tech, and behavior change

๐Ÿง  What We Learned

  • ๐Ÿ” Polished solutions require tough trade-offs
  • ๐Ÿค Gamification can drive real change
  • ๐Ÿง  Firebase Studio + Gemini = MVP prototyping superpower
  • ๐Ÿ’ก Web3 isn't scary โ€” it enables trust + ownership
  • ๐ŸŒฑ Recycling in Delhi is broken โ€” we built a starting point

๐Ÿš€ Quick Start

graph LR
    A[Install] --> B[Configure]
    B --> C[Run]
    C --> D[Develop]
    style A fill:#4d94ff,stroke:#333,stroke-width:2px
    style B fill:#4db8ff,stroke:#333,stroke-width:2px
    style C fill:#4dffb8,stroke:#333,stroke-width:2px
    style D fill:#4dff94,stroke:#333,stroke-width:2px
Loading
# Clone repository
git clone https://github.com/Zburgers/WasteWise.git

# Install dependencies
npm install

# Run development server
npm run dev

Prerequisites

  • Node.js (v16+)
  • npm or yarn
  • Firebase account

Installation

  1. Clone the repository:

    git clone https://github.com/Zburgers/WasteWise.git
    cd WasteWise
  2. Install dependencies:

    npm install
    # or
    yarn install
  3. Set up environment variables: Create a .env.local file with your Firebase configuration:

    NEXT_PUBLIC_FIREBASE_API_KEY=your-api-key
    NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your-auth-domain
    NEXT_PUBLIC_FIREBASE_PROJECT_ID=your-project-id
    NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your-storage-bucket
    NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your-messaging-sender-id
    NEXT_PUBLIC_FIREBASE_APP_ID=your-app-id
    
  4. Start the development server:

    npm run dev
    # or
    yarn dev
  5. Open http://localhost:3000 in your browser to see the application.

๐Ÿ“ฑ App Screenshots

๐Ÿ’š Final Note

WasteWise is more than a hackathon project. It's a bold, beautiful step toward a cleaner, smarter world โ€” powered by AI, Web3, and people like you.

๐Ÿงช Testing

Run the test suite:

npm test
# or
yarn test

๐Ÿ‘ฅ Contributors

๐Ÿค Contributing

We welcome contributions to WasteWise! Please see our Contributing Guidelines for details on how to get involved.

๐Ÿ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ‘จโ€๐Ÿ’ป About the Creator

Nakshatra Kundlas (Zburgers)

WasteWise was developed by Nakshatra Kundlas for the Apex Hacks II Hackathon. The project aims to leverage technology to promote sustainable waste management practices and environmental consciousness.

๐Ÿ† Apex Hacks II Hackathon

This project was created as part of the Apex Hacks II Hackathon, showcasing innovative solutions to environmental challenges through technology.

๐Ÿ“ž Support

GitHub Issues Email Support Discord

Made with โค๏ธ for a cleaner planet by Nakshatra (Zburgers)

โญ Star this project โญ

About

๐ŸŒฑ A gamified, AI-powered Web3 app designed to make recycling intuitive, engaging, and rewarding ๐ŸŒฑ

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published