WakaTime Plant Growth Game 🌱

A gamified coding tracker that grows virtual plants based on your WakaTime coding activity.

• User Authentication: Secure login with your WakaTime API key
• Multi-stage plant growth: 8 distinct growth stages from seed to full bloom
• Real-time WakaTime integration: Fetches your daily coding stats
• Complex growth mechanics: Growth depends on coding time, consistency, and language diversity
• Dark/Light mode: Responsive design with media query-based theming
• Progress tracking: Visual indicators for growth requirements
• Demo mode: Try the app without an API key using sample data
• Plant type selection: Choose from 4 different plant types (Tree, Flower, Cactus, Mushroom)
• Community Garden: View all users' plants in a shared garden space
• GitHub README Embeds: Show off your coding plant in your GitHub profile

Traditional tree growth from seed to mighty oak. Perfect for steady, consistent coders.

Beautiful flowering plants that bloom with vibrant colors. Ideal for creative coders.

Hardy desert plants that thrive in tough conditions. Great for resilient coders.

Mysterious fungi that grow in magical patterns. Perfect for innovative coders.

Each plant type has 8 unique growth stages:

1. Seed/Bulb/Cactus Seed/Spore (0 hours) - Just planted
2. Sprout/First Shoot/Tiny Cactus/Mycelium (1+ hours) - First signs of life
3. Seedling/Stem & Leaves/Growing Cactus/Tiny Mushroom (3+ hours) - Small growth appears
4. Young Plant/Bud Formation/Spiky Cactus/Toadstool (6+ hours) - Growing stronger
5. Mature Plant/First Bloom/Tall Cactus/Mushroom Cluster (12+ hours) - Well established
6. Flowering/Full Bloom/Flowering Cactus/Glowing Mushrooms (20+ hours) - Beautiful display
7. Fruit Bearing/Garden Bed/Cactus Family/Fairy Ring (30+ hours) - Producing results
8. Ancient/Paradise/Oasis/Mystical Forest (50+ hours) - Majestic mastery

1. Demo Mode: Visit the app to see it in action with sample data
2. Real Data: Click "Connect WakaTime" and enter your API key
3. Get API Key: Visit wakatime.com/api-key to get your key
4. Choose Plant: Select your preferred plant type from the dropdown
5. Watch Growth: Your plant grows based on your weekly coding activity!
6. Visit Garden: Check out the community garden to see other coders' plants

Track your coding plant growth directly from your Windows 11 desktop! This app includes a native Windows 11 PWA widget that displays your plant's progress right on the Widgets Board.

• Live plant display: See your current plant and growth stage
• Real-time stats: Total coding hours and today's progress
• Growth requirements: Visual progress bars for next stage
• Auto-refresh: Updates every 30 minutes with fresh data
• Native integration: Uses Windows 11 Adaptive Cards for seamless OS integration

1. Install the PWA:

   • Open the app in Microsoft Edge
   • Click the "Install" button in the address bar
   • Or use the menu: ... → Apps → Install this site as an app

2. Add the Widget:

   • Open Windows 11 Widgets Board (Win + W)
   • Click the "Add widgets" button (+)
   • Find "Plant Growth Tracker" in the widget picker
   • Click "Add widget" to add it to your board

3. Configure the Widget:

   • The widget will automatically use your WakaTime data if you're logged in
   • If not logged in, it will show demo data
   • Widget updates automatically every 30 minutes

• Windows 11 (version 22H2 or later)
• Microsoft Edge browser
• PWA installed locally
• Active internet connection for data updates

Show off your coding plant in your GitHub README!

![WakaTime Plant](https://your-domain.com/embed/your-username)

![WakaTime Plant](https://your-domain.com/embed/your-username?theme=dark&plant=flower-garden&key=YOUR_API_KEY)

• theme: light or dark
• plant: classic-tree, flower-garden, cactus-desert, or mushroom-forest
• key: Your WakaTime API key for real data (optional)

Visit /embed for full documentation and live examples.

Each stage requires different combinations of:

• Coding Hours: Total time spent coding this week
• Consistency: Percentage of days you coded
• Language Diversity: Number of different programming languages used

• Garden View: Browse all users' plants in a beautiful garden layout
• Garden Eligibility: Only users who reach Level 3+ appear in the community garden
• Plant Persistence: Your plant type choice is saved to your profile
• Public Profiles: Share your coding journey with the community
• Sorting Options: View gardens by recent activity, total hours, or growth stage
• Automatic Qualification: Users automatically appear in the garden once they meet the requirements

To appear in the community garden, you must reach Level 2 by achieving:

• 3+ hours of coding this week
• 30%+ consistency (coding on multiple days)
• 1+ programming language

Once you meet these requirements, your plant will automatically appear in the community garden for others to see!

• API keys are validated securely on the backend
• Keys are stored locally in your browser (localStorage)
• Database stores user preferences and plant types
• Users can logout to remove their data at any time

• Backend: Hono.js API with WakaTime integration
• Frontend: React with TypeScript
• Database: SQLite for user data and plant preferences
• Styling: TailwindCSS with dark mode support
• Authentication: Client-side storage with backend validation
• Data: WakaTime API integration
• Embeds: SVG-based GitHub README integration
• Widgets: Windows 11 PWA widgets with Adaptive Cards