Inspiration

What inspired me to build EarthWell was my own experience while traveling and trying to live more sustainably. Whenever I visit a new city, I realize how difficult it is to find reliable, localized sustainability resources whether that’s eco-friendly transportation, ethical food options, recycling rules, or low-impact lifestyle choices.

Locals usually learn these things over time through research and experience, but as a traveler or newcomer, it feels overwhelming and fragmented. You have to search across multiple platforms, and sustainability information is rarely centralized or personalized to where you are.

That gap is what motivated me to create EarthWell: a simple tool where you just enter a city and immediately get actionable, sustainable guidance tailored to that location.

What it does

EarthWell is a web application that generates instant, city-specific sustainability guides. Users enter any city name and choose between Travel mode (for short-term visitors) or Move mode (for people relocating). The application then returns actionable recommendations including eco-friendly transport options with specific app names, local recycling rules with bin colors, carbon footprint estimates, and air quality data. Built with Python Flask on the backend and using Google Gemini API (with Groq as fallback), EarthWell caches responses to work within free tier limits and delivers a response. The goal is simple: make sustainability information accessible for any location without requiring users to research multiple sources.

How we built it

I built EarthWell as a web application with a Flask backend and a HTML/CSS/JavaScript frontend.

The backend handles user requests and communicates with Google's Gemini API (with Groq as a fallback). I added a persistent cache so responses are saved locally, reducing repeated API calls.

The frontend is a single page with a search input, mode toggle buttons, and a results area. I used a glassmorphism design with blurred backgrounds, rounded corners, and soft shadows.

The app returns transport options, recycling rules, carbon estimates, air quality, and local initiatives for any city the user enters.

What's next for EarthWell

I'd like to add live data APIs for accurate carbon and air quality readings, let users contribute and verify local tips, expand city coverage with more detailed information, and eventually build a mobile app and browser extension. The goal is to make EarthWell more accurate, more useful, and accessible anywhere.

Share this project:

Updates