"Build your potato empire from a single seed to an interdimensional tuber dynasty. One click at a time."
🎮 Overview
| Genre | Idle / Clicker |
| Platform | Web (HTML5 Canvas + Vanilla JavaScript) |
| Dev Time | 1-2 days (solo developer) |
| Inspiration | Cookie Clicker meets Stardew Valley meets... potatoes |
🔁 Core Loop (Every 30 Seconds)
- Click the big potato to earn potatoes
- Buy buildings that generate potatoes automatically (idle income)
- Purchase upgrades to multiply your clicking power and building output
- Watch numbers go brrr — the eternal satisfaction of exponential growth
- Prestige when you hit the ceiling, resetting for permanent bonuses
The beauty of idle clickers: even when you close the tab, your empire keeps growing. Come back to a mountain of potatoes.
⚙️ Key Mechanics
1. The Click
A massive, juicy, satisfying potato sits in the center of your screen. Click it. It squishes. Particles fly. Numbers tick up. It never gets old. The click must feel like popping bubble wrap — simple, primal, dopamine.
2. Buildings (8 Tiers)
Each building auto-generates potatoes per second. Cost increases 15% per purchase. The progression tells a story:
- 🌱 Potato Seed (15 potatoes) → 0.1/s — "Every empire starts with a single seed"
- 🌿 Garden Plot (100) → 1/s — "A modest patch of dirt with big dreams"
- 🚜 Potato Farm (1,100) → 8/s — "Rows and rows of beautiful spuds"
- 🚚 Tater Truck (12,000) → 47/s — "Mobile potato distribution network"
- 🍟 French Fry Factory (130,000) → 260/s — "Turning raw potential into golden profit"
- 🔬 Potato Research Lab (1,400,000) → 1,400/s — "Science has gone too far"
- 🛸 Spud Space Station (20,000,000) → 7,800/s — "Growing potatoes in zero gravity"
- 🌀 Interdimensional Tuber Portal (330,000,000) → 44,000/s — "Potatoes from infinite realities"
3. Upgrades
One-time purchases that double click power or building output. They unlock at milestones, giving you that sweet "just one more" motivation. Two upgrades per building = 16 total, plus click multipliers.
4. Prestige System
Once you've earned 1 trillion lifetime potatoes, you can Prestige — resetting everything for Golden Potatoes. Each Golden Potato permanently boosts ALL production by 1%. The formula: floor(sqrt(lifetime / 1e12)). This is the endgame loop that keeps players coming back for "one more run."
5. Offline Earnings
Close the tab, come back tomorrow, get a satisfying "Welcome back! You earned 47.3M potatoes while away!" popup. This is what separates idle games from clickers — your empire works while you sleep.
📈 Progression
The game has a natural S-curve:
- 0-5 min: Frantic clicking, buying first seeds and plots
- 5-30 min: Buildings take over, clicking becomes less important
- 30 min - 2 hr: Unlocking higher-tier buildings, chasing upgrades
- 2-8 hr: Approaching prestige territory, big number satisfaction
- 8+ hr: Prestige loops, Golden Potato collection, achievement hunting
The background evolves as you progress: dirt → garden → farm → cityscape → space. Your empire literally transforms the world around you.
🎨 Art Style
Warm, cozy, cartoon. Think hand-drawn potato characters with rosy cheeks and tiny limbs. Earthy brown and golden color palette with green accents. The UI uses wooden/parchment textures. Everything should feel like a cozy potato cottage — inviting, not overwhelming. Emoji can serve as placeholder art for the MVP.
🔊 Sound Design
All sounds generated via Web Audio API (zero external dependencies!):
- Click: Soft, satisfying "pop" — like squeezing a stress ball
- Purchase: Quick cash register ka-ching
- Achievement: Bright ascending 3-note chime
- Prestige: Dramatic whoosh with sparkle
- Ambient: Optional subtle warm hum
💰 Monetization Ideas (XRP Integration)
- Potato NFTs: Rare potato varieties as XRPL tokens — collect them across prestiges
- Leaderboards: Stake small XRP amounts to compete on weekly leaderboards
- Cosmetic Skins: Buy potato outfits with XRP micropayments
- Tip the Dev: Simple XRP tip jar integrated into the settings menu
🎯 MVP Scope
The minimum to be fun (buildable in 1-2 days by one developer):
- ✅ Clickable potato with satisfying animation + particles
- ✅ 8 buildings with cost scaling
- ✅ 5+ upgrades
- ✅ Prestige system
- ✅ Save/load (localStorage)
- ✅ Offline earnings
- ✅ Big number formatting
- ✅ Web Audio API sounds
- ✅ Mobile responsive
🛠️ Build It Yourself: The Prompt Chain
We've prepared a sequence of 5 prompts that, when given to a coding AI agent (like Claude, GPT-4, or Cursor), will build the entire game from scratch. Each prompt is self-contained and builds on the previous step.
Prompt 1: Project Setup + Core Game Loop
Build an idle clicker game called "Spud Empire" using vanilla JavaScript + HTML5 Canvas. Single index.html file. - 800x600 canvas, responsive scaling - Game state: potatoes, potatoesPerSecond, potatoesPerClick, prestigeLevel, upgrades[] - Big clickable potato center-screen - Squish animation on click (scale down → bounce back) - Particle effects: potato chunks fly outward on click - Number display with suffixes (K, M, B, T, Qa, Qi...) - Auto-save to localStorage every 30s + on page close - Offline earnings on load with "Welcome back!" popup - 60fps game loop Make the click feel SATISFYING. This is the whole game.
Prompt 2: Buildings + Upgrades
Add the building/upgrade system to Spud Empire: 8 BUILDINGS (cost scales 15% per purchase): 1. Potato Seed (15) → 0.1/s 2. Garden Plot (100) → 1/s 3. Potato Farm (1,100) → 8/s 4. Tater Truck (12,000) → 47/s 5. French Fry Factory (130,000) → 260/s 6. Potato Research Lab (1,400,000) → 1,400/s 7. Spud Space Station (20,000,000) → 7,800/s 8. Interdimensional Tuber Portal (330,000,000) → 44,000/s UPGRADES: 2 per building (double output each) + 2 click multipliers. Unlock when affordable. One-time purchase. UI: Right sidebar for buildings, top bar for upgrades.
Prompt 3: Prestige + Achievements
Add prestige and achievements to Spud Empire: PRESTIGE: Available at 1T lifetime potatoes. Resets everything except Golden Potatoes. Award: floor(sqrt(lifetime / 1e12)). Each Golden Potato = +1% ALL production. Show multiplier. ACHIEVEMENTS (15+ with toast notifications): - First Spud, Handful (100 clicks), Green Thumb (1 of each), Potato Baron (1M), Spud Lord (1B), The One True Tuber (first prestige), etc. Background evolves: dirt → garden → farm → city → space based on total production rate.
Prompt 4: Sound, Art Integration + Polish
Polish Spud Empire with sound and visual effects: SOUND (Web Audio API, no external files): - Click: soft pop (sine wave burst, 200Hz, 50ms) - Purchase: ka-ching (noise + sine, 800Hz) - Achievement: 3 ascending tones (C5, E5, G5) - Prestige: filtered noise sweep (0.5s) VISUALS: - Gradient backgrounds shifting warm→cool as you progress - Golden shimmer on prestige multiplier - Number counter "rolling" animation - Tooltip on building hover showing production stats - Particle color: potato-brown (#D4A574) and gold (#FFD700)
Prompt 5: Deploy-Ready
Finalize Spud Empire for deployment: - SEO meta tags + OG tags - Loading screen - Keyboard shortcuts: Space=click, 1-8=buy buildings - News ticker with rotating potato facts - PWA manifest for mobile install - Settings: sound toggle, hard reset, export/import save - Stats page: lifetime potatoes, clicks, time played - Mobile responsive (stack vertically on small screens) - Ensure 60fps with particle cap - Final save/load verification
🎨 Bonus: AI Art Prompts
Ready-to-paste DALL-E prompts for every visual asset:
- Main Potato: "Cute cartoon potato character with a happy face, rosy cheeks, small arms and legs, warm brown color with subtle 3D shading. Game sprite style, transparent background."
- Golden Potato: "Luxurious golden potato gleaming with sparkles and light rays, premium prestige currency icon. Metallic gold texture, transparent background."
- French Fry Factory: "Whimsical industrial factory with smokestacks shaped like french fries, steam rising. Cartoon game art, warm yellows and reds."
- Space Station: "Orbital space station shaped like a giant potato floating above Earth with solar panels. Cartoon game art, starry background."
- Tuber Portal: "Swirling interdimensional portal in purple and gold with cartoon potatoes flying through. Fantasy game art, magical energy effects."
Ready to build it? Grab the prompt chain above, feed it to your favorite AI coding assistant, and you'll have a playable Spud Empire by tomorrow. 🥔👑
— Hot Potato Games | hotpotatogames.com
