Skip to content

bitpixi2/lemonomics

Repository files navigation

🍋 Lemonomics - Lemonade Stand

    ╔══════════════════════════════════════════════════════════════╗
    ║                                                              ║
    ║    🍋🍋🍋  L E M O N O M I C S  🍋🍋🍋                         ║
    ║                                                              ║
    ║         ┌─────────────────────────────────────┐              ║
    ║         │  💰 Turn Lemons Into PROFIT! 💰    │                ║
    ║         │                                     │              ║
    ║         │    🏪 Build Your Lemonade Empire    │              ║
    ║         │    📈 Master Supply & Demand        │              ║
    ║         │    🎯 Reddit Karma = Sales Boost!   │              ║
    ║         └─────────────────────────────────────┘              ║
    ║                                                              ║
    ╚══════════════════════════════════════════════════════════════╝

🎮 The Classic 1973→1979 Game, Reimagined for Reddit

Remember the legendary Apple II lemonade stand game? We've brought it back with a modern twist and AI-powered community features!

         🍋                    🏪                    💰
      ┌─────────┐           ┌─────────┐           ┌─────────┐
      │ LEMONS  │    ──►    │  STAND  │    ──►    │ PROFIT  │
      │ + SUGAR │           │ + SIGNS │           │ + KARMA │
      └─────────┘           └─────────┘           └─────────┘
         Input                Business              Output

🏗️ Technical Architecture

    📱 CLIENT (React)     🔄 API LAYER      🗄️ SERVER (Node.js)
    ┌─────────────────┐   ┌─────────────┐   ┌──────────────────┐
    │ 🎮 Game Logic   │◄──┤ /api/karma  │──►│ 🎯 Reddit API    │
    │ 🎨 UI Components│   │ /api/health │   │ 📊 Redis Cache   │
    │ 📱 Mobile First │   │ /api/...    │   │ 🔧 Game Engine   │
    └─────────────────┘   └─────────────┘   └──────────────────┘
           │                      │                     │
           ▼                      ▼                     ▼
    🌈 Tailwind CSS      ⚡ Express.js        🏪 Devvit Platform

🌟 What Makes This Special?

  • 🎯 Reddit Integration: Your karma = sales multiplier!
  • 📱 Mobile-First: Perfect for phones and desktops
  • 🌤️ Dynamic Weather: Affects customer demand
  • 📊 Real Economics: Supply, demand, and pricing strategy
  • 🏆 30-Day Challenge: Can you become a Lemonade Tycoon?

🚀 Getting Started

Ready to build your lemonade empire? Join the community and start playing:

🍋 Play on r/Lemonomics

When life gives you lemons, make a profitable business! 🍋💰✨

� Game Features & Mechanics

╭─────────────────────────────────────────────────────────────╮
│                    🎮 GAME MECHANICS 🎮                     │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  🍋 INGREDIENTS     📢 MARKETING      💵 PRICING           │
│  ├─ Lemon Mix       ├─ Signs ($0.15)  ├─ Customer Psychology│
│  ├─ Sugar (free!)   ├─ Advertising    ├─ Price Elasticity  │
│  └─ Cups & Labor    └─ Foot Traffic   └─ Profit Margins    │
│                                                             │
│  🌤️ WEATHER SYSTEM  🎯 KARMA BOOSTS   📈 PROGRESSION       │
│  ├─ ☀️ Sunny (Good)  ├─ 300+ = 1.15x   ├─ Day 1-30        │
│  ├─ ☁️ Cloudy (OK)   ├─ 1K+ = 1.5x     ├─ Rising Costs    │
│  ├─ 🌧️ Rainy (Bad)   ├─ 5K+ = 2.0x     ├─ Special Events  │
│  └─ � Hot D(Great!)  └─ Reddit Power!  └─ Victory/Defeat   │
│                                                             │
╰─────────────────────────────────────────────────────────────╯

🏆 Victory Conditions & Rewards

� <Performance Rankings

    💰 LEMONADE TYCOON RANKINGS 💰

    � $10i0+  = "🏆 Lemonade Tycoon!"
    💰 $50+   = "💰 Business Success!"
    📈 $20+   = "📈 Good Entrepreneur!"
    👍 $10+   = "👍 Not Bad!"
    😐 $5+    = "😐 Could Be Better"
    😅 <$5    = "😅 Better Luck Next Time"

    💸 $0 or Day 30 = GAME OVER

🎖️ Exclusive Achievement Flair

Reach these milestones to earn exclusive user flair in r/Lemonomics:

    🏆 EXCLUSIVE FLAIR REWARDS 🏆

    ┌─────────────┬─────────────────────────┬─────────────────────┐
    │    DAY      │         FLAIR           │     DESCRIPTION     │
    ├─────────────┼─────────────────────────┼─────────────────────┤
    │   Day 10    │  🍋 Lemon Apprentice    │ Mastered the basics │
    │   Day 20    │  🤑 Citrus Tycoon       │ True entrepreneur   │
    │   Day 30    │  🌍 Global Lemonade Hero│ Conquered the world │
    └─────────────┴─────────────────────────┴─────────────────────┘

    Flair automatically awarded when you reach each milestone! 🎉

🎯 Reddit Karma Integration

Your Reddit reputation directly impacts your lemonade business!

    🎯 KARMA BOOST SYSTEM �

    ┌─────────────┬──────────────┬─────────────────┐
    │   KARMA     │   MULTIPLIER │   DESCRIPTION   │
    ├─────────────┼──────────────┼─────────────────┤
    │   5,000+    │    2.0x      │ 🏆 Legendary    │
    │   1,000+    │    1.5x      │ ⭐ Veteran      │
    │     300+    │    1.15x     │ 👍 Active       │
    │     <300    │    1.0x      │ 😐 Newbie       │
    └─────────────┴──────────────┴─────────────────┘

    More karma = More customers trust your lemonade! 🍋

🎮 How to Play

    🎯 THE LEMONADE BUSINESS CYCLE 🎯

    Day Briefing ──► Business Setup ──► Sales Results ──► Next Day
         │               │                    │              │
         ▼               ▼                    ▼              ▼
    🌤️ Weather      🍋 Ingredients      📊 Report      💰 Profit
    📢 Events       📢 Marketing       🏆 Rankings     📈 Growth
    💰 Assets       💵 Pricing         💸 Expenses     🔄 Repeat

� Step-by-Step Guide

  1. 🌅 Day Briefing: Check weather, assets, and special events
  2. 🏪 Setup Stand: Choose ingredients, signs, and pricing
  3. 📊 View Results: See sales, profit, and customer feedback
  4. 🔄 Repeat: Survive 30 days to become a Lemonade Tycoon!

🛠️ Development Story

💖 Built with Kiro:

    ╔════════════════════════════════════════════════════╗
    ║  "With Kiro, less is more. Specs feel godly,       ║
    ║   but can bloat the build if done wrong."          ║
    ║                                    - The Developer ║
    ╚════════════════════════════════════════════════════╝

🔧 The Kiro Dev Environment That Made It Possible

  • 🎯 Devvit Hooks: For Reddit integration magic
  • 🔌 MCP Server: Model Context Protocol goodness
  • 📚 Reddit Start Docs: The foundation that saved me, after I had to nuke and restart the day before
  • Hacker Sounds by mattogodoy - The click click tap tap that kept me motivated!
  • Amethyst Kiss Themes Pack by MahdiBehkar - Those gorgeous purple vibes!

I love this about Kiro - they have extensions that transform your development environment into whatever aesthetic inspires you! That and Kiro's little ghost face made up for all the really frustrating bugs like the play button not working to accept, spec tasks getting stuck, and documents ignored (Who could be mad at that little ghosty face?) ✨

🤖 FEATURED: Advanced Kiro Hook Automation System

🏆 Hackathon Showcase: Community Recipe Sharing with AI Automation

This game demonstrates cutting-edge Kiro developer experience through an automated community management system:

    🍋 RECIPE SHARING WORKFLOW 🍋

    Player sees Recipe Break ──► "Submit Recipe" button ──► ModMail opens
                                        │
                                        ▼
    🤖 Kiro Hook (runs hourly) ──► AI Content Moderation ──► Auto-flair award
                                        │
                                        ▼
    Community growth ◄──── Personalized responses ◄──── Archive conversation

🎯 Key Innovation: Players can share their own lemon recipes through ModMail, and Kiro automatically processes submissions within an hour, awarding "Recipe Contributor" flair and sending personalized responses - zero manual moderation required! When a player rates your recipe 5-stars, then you get "5-Star Recipe Chef" flair.

📁 Implementation: See .kiro/hooks/ directory for the complete automation system including:

  • recipe-modmail-processor.md - Kiro hook configuration
  • process-recipes.sh - Automated processing script
  • Smart content moderation with lemon-theme relevance checking
  • Automatic flair awarding and community management

This showcases how Kiro transforms simple game features into sophisticated community platforms that scale effortlessly! 🚀

🎬 The Ambitious Vision That Almost Was

Originally, this game was much more ambitious! The initial vision included:

    🎵 AUDIO & IMMERSION 🎵
    ├─ Rich soundscapes and festival music
    ├─ Dynamic audio feedback for every action
    └─ Custom ElevenLabs sound effects for weather changes

    🎪 FESTIVAL EVENTS & CUSTOMIZATION 🎪
    ├─ Seasonal festivals with special bonuses
    ├─ Customizable booth designs and themes
    └─ Trade resources with friends across Reddit

    🤖 AI-POWERED INTERACTIONS 🤖
    ├─ Unique character conversations each playthrough
    ├─ Dynamic customer personalities and stories
    └─ Procedurally generated events and scenarios

    🎥 CINEMATIC EXPERIENCE 🎥
    ├─ Cut scenes with video content
    ├─ Story-driven progression system
    └─ Rich visual storytelling elements

    💰 REDDIT GOLD INTEGRATION 💰
    ├─ "Sugar Boosts" for premium multipliers
    ├─ Alternative to karma-based progression
    └─ Special rewards for Reddit Gold supporters

But it was all too ambitious and ultimately wouldn't run. 😅

The complexity became overwhelming, so I stripped it back to the essential lemonade stand experience - and started expanding again from there!

🎧 The Coding Playlist

  • Severance — Music To Refine To feat. ODESZA | Apple TV - The perfect focus music for deep coding sessions for business simulators, on loop
  • I also listened to that when making Bizniz Quest at the last hackathon. Something about being unemployed... has me loving to pretend that I have a job.

---

### 🎮 Ready to Build Your Lemonade Empire?

**[🍋 Play on r/Lemonomics](https://reddit.com/r/Lemonomics)** | **[📚 View Source](https://github.com/bitpixi2/lemonomics)** | **[🐛 Report Issues, because there are many](https://github.com/bitpixi2/lemonomics/issues)**

_When life gives you lemons, make a profitable business!_ 🍋💰✨

About

Reddit Hackathon #2 with Kiro

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 5