HabitForge AI

Transform motivation through AI visualization. See how your habits will change you over time using Gemini 2.5 Flash Image AI API, inspiring hope or healthy fear.

Comment

Inspiration

The idea came to me during another one of those moments when I was being incredibly lazy before a workout. I kept thinking, "What if I could see my future self, the version of me that either commits to this habit or gives up?" That thought sparked in my head, and it has remained with me for a really long time, and now, coz of the AI getting increasingly better- Gemini 2.5 Flash, for the visualization part, and this hackathon came up, so I decided to build my idea into a reality. I have sincerely wanted this for a long time.

Initially, it was just about fitness motivation. But then I realized, what about all the other habits that shape us? Reading, upskilling, meditation, journaling, goal-oriented actions. These "invisible" habits are harder to visualize but equally transformative. I wanted to show their cumulative impact over time. I played around with the various small and isolatingly seemingly insignificant things- user's aura, glow, environment, the brightness, color tones/theme/lightening and more, all of these unified, gave off the desired transformation result.

The project evolved when I thought about habit combinations, what happens when you stack multiple positive habits? Or worse, what if you let negative habits compound? I wanted users to feel both the hope of their best possible future and the healthy fear of their worst-case scenario.

What it does

HabitForge AI transforms abstract habit consequences into powerful visual reality. Users first input their profile picture, which is then virtualized, and made an avatar, for users' privacy, then they input their habits (good or bad), and the AI generates realistic visualizations showing their future self after months or years of those behaviors.

The platform handles everything from obvious physical changes (workout results) to subtle intellectual transformations (reading, learning, meditation). Users can combine multiple habits to see compound effects, create custom habit categories, and save their visualizations for ongoing motivation.

It's not just another habit tracker, but a time machine that shows you exactly where your daily choices are taking you.

How I built it

Frontend: React 18 with TypeScript for type safety and modern development experience. Used Vite for lightning-fast builds and Tailwind CSS for a responsive, beautiful UI design.

AI Integration: Google Gemini 2.5 Flash API for generating realistic future-self visualizations. The challenge was crafting prompts that could accurately represent both physical and mental habit transformations.

Backend: Express.js server handling API requests and serving static assets. Implemented secure environment variable management for API keys.

Deployment: Docker containerization with Google Cloud Run for scalable, serverless deployment. This was my first time using Docker, so there was definitely a significant learning curve.

Architecture: Built with mobile-first responsive design, gallery system for saving visualizations, and custom habit creation functionality.

Challenges I ran into

The Invisible Habits Problem: How to visually represent the impact of reading, meditation, or journaling? Unlike workouts where physical changes are obvious, intellectual habits needed creative visualization approaches. I spent hours crafting AI prompts that could show confidence, mental clarity, and knowledge growth in realistic ways.

Docker & Cloud Run Nightmare: Never touched Docker before this project. Had to spend way too many hours debugging configuration issues, API key injection problems, and deployment failures. The CLI commands for setting environment variables during Cloud Run deployment were particularly tricky, lots of trial and error with loading states and API connectivity.

AI Prompt Engineering: Getting Gemini to generate consistent, realistic transformations across different habit types and time periods required extensive prompt refinement. Balancing hope and fear in visualizations without being too extreme was an art form in itself.

Accomplishments that I'm proud of

Honestly? Everything. The design is clean and modern with perfect color contrast and theming. The UI/UX flows seamlessly from habit input to visualization to gallery management. The responsiveness works flawlessly across all devices.

But what I'm most proud of is the core functionality - the avatar creation works perfectly, the visualizations are genuinely motivating (and sometimes scary), the gallery feature lets users build their personal motivation library, and the custom habit system handles everything from "drink more water" to "learn quantum physics."

The technical implementation is solid too - fast loading, smooth interactions, and reliable Cloud Run deployment that scales automatically.

What I learned

Docker isn't as scary as it seems, once you understand the basics, containerization makes deployment so much cleaner.

AI prompt engineering is an art - small changes in wording can dramatically affect output quality. Spent countless hours perfecting prompts for different habit visualizations.

Visual motivation is incredibly powerful - seeing your future self, good or bad, creates strong emotional responses that traditional habit trackers can't ever match.

Cloud Run is amazing for rapid prototyping, serverless deployment with automatic scaling removed so much infrastructure complexity.

TypeScript saves time in the long run, it caught so many potential bugs during development that would've been runtime nightmares.

What's next for HabitForge AI

Wearable Integration: Connect with fitness trackers and smartwatches for automatic habit tracking and real-time progress updates.

Social Features: Share transformations with friends, create habit challenges, and build accountability communities.

Advanced AI Models: Experiment with newer AI models for even more realistic and nuanced visualizations.

Habit Recommendations: Use machine learning to suggest optimal habit combinations based on user goals and lifestyle.

Mobile App: Native iOS/Android apps with push notifications and offline visualization viewing.

The goal is making HabitForge the go-to platform for anyone serious about transforming their life through better habits.

Built With

Share this project:

Updates