shrani

MASTER_ASSET_MANIFEST.md

@@ -0,0 +1,510 @@
+# 🎨 COMPLETE ASSET GENERATION MANIFEST
+
+**Total Assets Needed:** ~4,500  
+**Status:** Structure ready, generation pending  
+**Updated:** Dec 30, 2025
+
+---
+
+## 📋 **GENERATION CHECKLIST BY CATEGORY:**
+
+### **🗺️ BIOMES (18 total):**
+
+#### **01. DOLINA FARM** (Starting Area)
+**Status:** ✅ 90% DONE (demo assets!)
+- ✅ Terrain: grass, dirt, tilled soil
+- ✅ Buildings: tent
+- ✅ Props: campfire, dead tree, rock
+- ✅ Crops: wheat (5 stages)
+- ⏳ NPCs: Need 5 more farmers
+- ⏳ Buildings: Need barn, shack, silo
+
+**Remaining:** 15 assets
+
+---
+
+#### **02. DARK FOREST**
+**Status:** ❌ 0% - NOT STARTED
+**Priority:** HIGH (early game area)
+
+**Terrain (10 assets):**
+- [ ] dark_grass_tile
+- [ ] forest_floor_leaves
+- [ ] forest_floor_moss
+- [ ] dark_dirt_path
+- [ ] forest_mud
+- [ ] tree_roots_ground
+- [ ] dark_stone_tile
+- [ ] forest_water_edge
+- [ ] corrupted_ground
+- [ ] shadow_patch
+
+**Trees (15 assets):**
+- [ ] dead_oak_small × 3 variants
+- [ ] dead_oak_medium × 3 variants
+- [ ] dead_oak_large × 3 variants
+- [ ] twisted_pine × 3 variants
+- [ ] ancient_tree × 3 variants
+
+**Buildings (5 assets):**
+- [ ] abandoned_cabin
+- [ ] hunter_shack
+- [ ] old_watchtower
+- [ ] ruined_shrine
+- [ ] hermit_hut
+
+**Props (20 assets):**
+- [ ] fallen_log × 4
+- [ ] moss_covered_rock × 4
+- [ ] mushroom_cluster × 4
+- [ ] old_campfire
+- [ ] skull_pile
+- [ ] warning_sign
+- [ ] broken_fence × 3
+- [ ] dark_flowers × 3
+
+**NPCs (5 assets × 4 frames = 20):**
+- [ ] hermit_idle
+- [ ] hunter_idle
+- [ ] lost_traveler_idle
+- [ ] forest_keeper_idle
+- [ ] mysterious_figure_idle
+
+**Enemies (8 assets × 4 frames = 32):**
+- [ ] forest_zombie_idle
+- [ ] shadow_wolf_idle
+- [ ] corrupted_deer_idle
+- [ ] dark_sprite_idle
+- [ ] forest_wraith_idle
+- [ ] poisonous_spider_idle
+- [ ] mutant_bear_idle
+- [ ] forest_boss_idle
+
+**TOTAL Dark Forest:** 102 assets
+
+---
+
+#### **03. ABANDONED TOWN**
+**Status:** ❌ 0% - NOT STARTED  
+**Priority:** HIGH (major location!)
+
+**Terrain (8 assets):**
+- [ ] cracked_pavement
+- [ ] old_cobblestone
+- [ ] grass_overgrown_street
+- [ ] broken_sidewalk
+- [ ] town_dirt
+- [ ] rubble_ground
+- [ ] fractured_plaza
+- [ ] rusty_grate
+
+**Buildings (25 assets):**
+- [ ] small_house_intact × 3 variants
+- [ ] small_house_damaged × 3 variants
+- [ ] small_house_ruined × 3 variants
+- [ ] shop_intact × 2 variants
+- [ ] shop_damaged × 2 variants
+- [ ] shop_ruined × 2 variants
+- [ ] church
+- [ ] town_hall
+- [ ] school
+- [ ] hospital
+- [ ] police_station
+- [ ] fire_station
+- [ ] library
+- [ ] bank
+- [ ] theater
+
+**Street Props (30 assets):**
+- [ ] street_lamp × 3
+- [ ] bench × 3
+- [ ] trash_can × 3
+- [ ] mailbox × 3
+- [ ] fire_hydrant
+- [ ] stop_sign
+- [ ] traffic_light
+- [ ] car_wreck × 5
+- [ ] bicycle_wreck
+- [ ] vending_machine × 2
+- [ ] newspaper_stand
+- [ ] phone_booth
+- [ ] bus_stop
+- [ ] statue
+- [ ] fountain
+- [ ] billboard × 2
+
+**NPCs (10 assets × 4 frames = 40):**
+- [ ] mayor_idle
+- [ ] shopkeeper_idle × 3
+- [ ] priest_idle
+- [ ] doctor_idle
+- [ ] teacher_idle
+- [ ] guard_idle × 2
+- [ ] scavenger_idle × 2
+
+**Enemies (6 assets × 4 frames = 24):**
+- [ ] town_zombie_idle × 3 types
+- [ ] feral_dog_idle
+- [ ] mutant_rat_idle
+- [ ] corrupted_citizen_idle
+
+**TOTAL Abandoned Town:** 127 assets
+
+---
+
+#### **04-18. OTHER BIOMES** (Summaries)
+
+**04. River Valley:** 85 assets (water, bridges, riverside)
+**05. Mountain Pass:** 90 assets (rocks, caves, elevation)
+**06. Swamp:** 95 assets (water, mud, poisonous plants)
+**07. Desert:** 80 assets (sand, oasis, ruins)
+**08. Snow Zone:** 85 assets (ice, snow, frozen lake)
+**09. Underground:** 100 assets (caves, crystals, darkness)
+**10. Magical Grove:** 90 assets (magical trees, fairy rings)
+**11. Ruins:** 110 assets (ancient structures, artifacts)
+**12. Coast:** 95 assets (beach, dock, lighthouse)
+**13. Volcano:** 100 assets (lava, ash, heat vents)
+**14. Crystal Caves:** 95 assets (crystals, gems, underground lake)
+**15. Floating Islands:** 105 assets (sky platforms, clouds)
+**16. Corrupted Lands:** 110 assets (dark, twisted, dangerous)
+**17. Spirit Realm:** 100 assets (ethereal, ghosts, portals)
+**18. Final Zone:** 120 assets (epic, boss area, endgame)
+
+**TOTAL Other Biomes:** 1,460 assets
+
+---
+
+### **👤 MAIN CHARACTERS:**
+
+#### **KAI (Protagonist)**
+**Status:** ⏳ 40% DONE (demo has idle + walk south)
+
+**Animations Needed:**
+- ✅ Idle (north, south, east, west) - 16 frames DONE
+- ✅ Walk south - 4 frames DONE
+- ⏳ Walk (north, east, west) - 12 frames TODO
+- [ ] Run (all 4 directions) - 16 frames
+- [ ] Hoe action - ✅ DONE
+- [ ] Watering - ✅ DONE
+- [ ] Planting - 1 frame
+- [ ] Harvesting - 1 frame
+- [ ] Sword swing (4 dirs) - 4 frames
+- [ ] Axe chop - 1 frame
+- [ ] Pickaxe mine - 1 frame
+- [ ] Fishing cast - 2 frames
+- [ ] Eating - 1 frame
+- [ ] Sleeping - 2 frames
+- [ ] Talking - 2 frames
+- [ ] Hurt - 1 frame
+- [ ] Death - 3 frames
+
+**Portraits:**
+- [ ] Normal - 1 frame
+- [ ] Happy - 1 frame
+- [ ] Sad - 1 frame
+- [ ] Angry - 1 frame
+- [ ] Surprised - 1 frame
+- [ ] Tired - 1 frame
+- [ ] Talking - 1 frame
+
+**TOTAL Kai:** 75 frames (40 done = 35 TODO)
+
+---
+
+#### **GRONK (Companion)**
+**Status:** ❌ 0% - NOT STARTED
+
+**Animations:** Same as Kai = 75 frames
+**Portraits:** 7 emotions = 7 frames
+
+**TOTAL Gronk:** 82 frames
+
+---
+
+#### **GROK (ADHD Punk)**
+**Status:** ❌ 0% - NOT STARTED
+
+**Animations:** Same as Kai + vaping = 80 frames
+**Portraits:** 7 emotions = 7 frames
+
+**TOTAL Grok:** 87 frames
+
+---
+
+#### **ANA (Mystery Character)**
+**Status:** ❌ 0% - NOT STARTED
+
+**Animations:** Fewer (mostly cutscenes) = 40 frames
+**Portraits:** 10 emotions (important!) = 10 frames
+
+**TOTAL Ana:** 50 frames
+
+---
+
+#### **SUSI (Dog Pet)**
+**Status:** ❌ 0% - NOT STARTED
+
+**Animations:**
+- [ ] Idle (4 dirs) - 4 frames
+- [ ] Walk (4 dirs) - 16 frames
+- [ ] Run (4 dirs) - 16 frames
+- [ ] Sit - 1 frame
+- [ ] Bark - 2 frames
+- [ ] Eat - 1 frame
+- [ ] Sleep - 1 frame
+
+**TOTAL Susi:** 41 frames
+
+---
+
+### **👥 NPCS (50+ characters):**
+
+**Status:** ❌ 0% - NOT STARTED
+
+**Categories:**
+- Farmers × 10 = 80 frames (idle, walk, work, talk)
+- Merchants × 8 = 64 frames
+- Guards × 6 = 48 frames
+- Civilians × 15 = 120 frames
+- Special NPCs × 11 = 88 frames
+
+**TOTAL NPCs:** 400 frames + 50 portraits = 450 assets
+
+---
+
+### **👹 ENEMIES:**
+
+**Status:** ⏳ 10% DONE (zombie idle + dig)
+
+**Basic Enemies (30 types × 16 frames each):**
+- ✅ Zombie worker (2 frames done) = 14 TODO
+- [ ] Zombie soldier
+- [ ] Zombie mutant
+- [ ] Shadow wolf
+- [ ] Corrupted deer
+- [ ] Mutant rat
+- [ ] Poisonous spider
+- [ ] Dark sprite
+- [ ] Forest wraith
+- [ ] Feral dog
+- [ ] Corrupted citizen
+- [ ] Swamp creature
+- [ ] Desert scorpion
+- [ ] Ice elemental
+- [ ] Lava beast
+- [ ] Crystal golem
+- [ ] Flying harpy
+- [ ] Corrupted tree
+- [ ] Shadow demon
+- [ ] Ghost spirit
+- ... (10 more types)
+
+**Bosses (10 types × 40 frames each):**
+- [ ] Forest guardian (corrupted)
+- [ ] Town mayor zombie
+- [ ] River serpent
+- [ ] Mountain troll
+- [ ] Swamp queen
+- [ ] Desert pharaoh
+- [ ] Ice dragon
+- [ ] Volcano demon
+- [ ] Crystal empress
+- [ ] Final boss (Ana corrupted?)
+
+**TOTAL Enemies:** 880 frames
+
+---
+
+### **🎒 ITEMS:**
+
+**Status:** ⏳ 5% DONE (seeds, tools partially)
+
+**Tools (30 types):**
+- ✅ Wooden hoe - DONE
+- ✅ Watering can - DONE
+- [ ] Stone hoe, iron hoe, gold hoe
+- [ ] Wooden axe → gold axe (4 tiers)
+- [ ] Wooden pickaxe → gold pickaxe (4 tiers)
+- [ ] Fishing rod (3 tiers)
+- [ ] Scythe (3 tiers)
+- [ ] Hammer (3 tiers)
+
+**Seeds (40 types):**
+- ✅ Wheat seeds - DONE
+- [ ] Corn, tomato, potato, carrot
+- [ ] Cabbage, lettuce, onion, garlic
+- [ ] Strawberry, blueberry, raspberry
+- [ ] Pumpkin, watermelon, melon
+- [ ] Flowers (10 types)
+- [ ] Trees (10 types)
+- [ ] Magical plants (5 types)
+
+**Food (60 types):**
+- ✅ Wheat bundle - DONE
+- [ ] Raw vegetables (15 types)
+- [ ] Cooked meals (20 types)
+- [ ] Baked goods (10 types)
+- [ ] Preserves (10 types)
+- [ ] Special food (5 types)
+
+**Resources (40 types):**
+- [ ] Wood (5 types)
+- [ ] Stone (5 types)
+- [ ] Ore (10 types)
+- [ ] Gems (10 types)
+- [ ] Crafting materials (10 types)
+
+**Equipment (50 types):**
+- [ ] Swords (10 types)
+- [ ] Armor (15 types)
+- [ ] Accessories (15 types)
+- [ ] Magic items (10 types)
+
+**Magical (30 types):**
+- [ ] Spell scrolls (15 types)
+- [ ] Potions (10 types)
+- [ ] Artifacts (5 types)
+
+**TOTAL Items:** 250 assets
+
+---
+
+### **🎨 UI ELEMENTS:**
+
+**Status:** ⏳ 30% DONE (basic UI done)
+
+**HUD (20 assets):**
+- ✅ Health bar - DONE
+- [ ] Health bar (damaged states × 4)
+- [ ] Stamina bar (full, states)
+- [ ] Mana bar (full, states)
+- [ ] Buff icons (10 types)
+
+**Menus (30 assets):**
+- ✅ Inventory slot - DONE
+- [ ] Crafting panel
+- [ ] Skill tree background
+- [ ] Settings panels
+- [ ] Quest log panels
+- [ ] Map interface
+
+**Dialogue (15 assets):**
+- ✅ Dialogue box - DONE
+- ✅ Kai portrait - DONE
+- [ ] Portrait frames (10 styles)
+- [ ] Speech bubbles (3 types)
+
+**Icons (200 assets):**
+- [ ] Item icons (150)
+- [ ] Skill icons (30)
+- [ ] Status icons (20)
+
+**TOTAL UI:** 265 assets
+
+---
+
+### **✨ EFFECTS:**
+
+**Status:** ⏳ 10% DONE (water effects)
+
+**Magic (60 assets):**
+- [ ] Fire spells (10 animations)
+- [ ] Water spells (10 animations)
+- [ ] Earth spells (10 animations)
+- [ ] Air spells (10 animations)
+- [ ] Dark spells (10 animations)
+- [ ] Light spells (10 animations)
+
+**Weather (20 assets):**
+- ✅ Water drops - DONE
+- [ ] Rain (3 intensities)
+- [ ] Snow (3 intensities)
+- [ ] Fog (3 densities)
+- [ ] Lightning (5 variations)
+
+**Particles (30 assets):**
+- [ ] Sparkles (5 colors)
+- [ ] Smoke (5 types)
+- [ ] Dust (5 types)
+- [ ] Magic particles (15 types)
+
+**Animations (40 assets):**
+- [ ] Explosions (10 sizes)
+- [ ] Impacts (10 types)
+- [ ] Transitions (10 types)
+- [ ] Special effects (10 types)
+
+**TOTAL Effects:** 150 assets
+
+---
+
+## 📊 **GRAND TOTAL:**
+
+| Category | Assets | Status |
+|----------|--------|--------|
+| **Biomes (18)** | 1,871 | 5% ✅ |
+| **Characters (5)** | 335 | 15% ⏳ |
+| **NPCs (50)** | 450 | 0% ❌ |
+| **Enemies (40)** | 880 | 2% ⏳ |
+| **Items (250)** | 250 | 5% ⏳ |
+| **UI (265)** | 265 | 30% ⏳ |
+| **Effects (150)** | 150 | 10% ⏳ |
+| **TOTAL** | **4,201** | **~8%** |
+
+---
+
+## 🎯 **GENERATION PRIORITY:**
+
+### **PHASE 1: KICKSTARTER DEMO (DONE!)**
+- ✅ 99 assets complete!
+
+### **PHASE 2: ALPHA (Next Month)**
+**Target:** 500 total assets
+
+**Generate:**
+1. Biome 02: Dark Forest (102 assets)
+2. Biome 03: Abandoned Town (127 assets)
+3. Kai complete (35 more frames)
+4. Gronk complete (82 frames)
+5. 15 more NPCs (120 frames)
+6. 20 more items
+
+**TOTAL:** 466 new assets
+
+### **PHASE 3: BETA (3-6 Months)**
+**Target:** 2,000 total assets
+
+**Generate:**
+- 10 more biomes (1,000 assets)
+- All main characters (335 assets)
+- 30 NPCs (240 frames)
+- All enemies (880 assets)
+- Most items (200 assets)
+
+### **PHASE 4: FULL RELEASE (12 Months)**
+**Target:** 4,200 total assets
+
+**Generate everything!**
+
+---
+
+## 🚀 **READY TO GENERATE!**
+
+**Folder structure:** ✅ COMPLETE  
+**Asset list:** ✅ COMPLETE  
+**Generation prompts:** ✅ READY  
+**Workflow:** ✅ ESTABLISHED  
+
+**CAN START MASS GENERATION ANYTIME!** 🎨
+
+---
+
+**IMPORTANT NOTES:**
+
+1. **All assets in DUAL STYLE** (A + B) = 2× quantity!
+2. **Keep 3 versions:** Original (1024px) + Sprite (32px) + Preview (256px)
+3. **Use batch generation:** 10-20 at a time
+4. **Estimated time:** 200-300 hours of AI generation spread over 12 months
+5. **Cost:** Free with Gemini API! ✅
+
+**GENERATION CAN START IMMEDIATELY!** 🚀

SESSION_SUMMARY_2025_12_30_NIGHT.md

@@ -0,0 +1,156 @@
+# 📊 DOLINASMRTI - FINAL SESSION SUMMARY
+
+**Date:** Dec 30, 2025  
+**Session:** Late Night Production Planning  
+**Time:** 22:05 - 23:40 (1h 35min)
+
+---
+
+## ✅ **WHAT WE ACCOMPLISHED:**
+
+### **1. COMPLETE FOLDER STRUCTURE** 🗂️
+**Created:** **440 organized folders!**
+
+- 18 biomes (each with 6 subcategories)
+- 5 main characters (with animations)
+- 7 NPC types
+- 6 enemy categories
+- 54 item subcategories
+- UI, effects, props, cutscenes
+
+### **2. MASTER DOCUMENTATION** 📋
+**Written:** 60+ KB of strategic docs
+
+- **MASTER_ASSET_MANIFEST.md** - 4,201 asset checklist
+- **MASTER_ASSET_PRODUCTION_STRATEGY.md** - Complete workflow
+- **COMPLETE_SYSTEMS_OVERVIEW.md** - All 145 systems audited
+
+### **3. PRODUCTION READY** 🚀
+- ✅ Demo: 99 assets complete
+- ✅ Structure: 440 folders organized
+- ✅ Manifest: 4,201 assets mapped
+- ✅ Workflow: Automated pipeline
+- ✅ Scalable: Demo → Full game
+
+---
+
+## 📊 **CURRENT PROJECT STATS:**
+
+### **Images:**
+```
+Demo (transparent):      285 PNGs
+Demo (white BG backup):  285 PNGs
+Other existing:          171 PNGs
+────────────────────────────────
+TOTAL:                   741 PNGs
+```
+
+**Including:**
+- All demo assets ✅
+- All animations ✅
+- Both art styles (A + B) ✅
+- Backup originals ✅
+
+### **Structure:**
+```
+Folders:     440 organized
+Capacity:    4,200+ assets
+Current:     741 files (18%)
+Remaining:   3,400+ to generate
+```
+
+### **Documentation:**
+```
+Total docs:  50+ files
+Total KB:    100+ KB written
+Guides:      Implementation, production, systems
+Manifests:   Complete checklists
+```
+
+### **Development:**
+```
+Total time:  ~135 hours
+Sessions:    16 sessions
+Commits:     60+ commits
+Game done:   40% (systems) + 18% (assets)
+```
+
+---
+
+## 🎯 **PRODUCTION CAPACITY:**
+
+**Can now support:**
+- 18 biomes × 100 assets each = 1,800 assets
+- 5 characters × 80 frames = 400 assets
+- 50 NPCs × 8 frames = 400 assets
+- 40 enemies × 20 frames = 800 assets
+- 250 items = 250 assets
+- UI + Effects = 550 assets
+
+**TOTAL CAPACITY: 4,200+ assets** 🎨
+
+---
+
+## 📈 **WHAT'S NEXT:**
+
+### **THIS WEEK:**
+1. Tiled demo map (2 hours)
+2. Phaser integration (4 hours)
+3. Demo playable (3 hours)
+4. Record video (2 hours)
+5. **Launch Kickstarter!** 🚀
+
+### **NEXT MONTH:**
+1. Dark Forest biome (102 assets)
+2. Abandoned Town (127 assets)
+3. Complete Kai (35 more frames)
+4. Add Gronk (82 frames)
+
+### **6 MONTHS:**
+1. 10 biomes complete
+2. 2,000 total assets
+3. Beta release
+
+### **12-18 MONTHS:**
+1. All 18 biomes
+2. 4,200 total assets
+3. Full release! 🎮
+
+---
+
+## 💪 **FOUNDATION COMPLETE!**
+
+**You have:**
+- ✅ 741 existing images
+- ✅ 440 organized folders  
+- ✅ 4,201 asset roadmap
+- ✅ Automated workflow
+- ✅ Clear path to full game
+
+**You can:**
+- 🚀 Launch Kickstarter (1 week)
+- 🚀 Generate systematically (4,000+ assets)
+- 🚀 Scale from demo → full game
+- 🚀 Track progress with manifests
+
+---
+
+## 🎉 **TONIGHT'S WINS:**
+
+1. ✅ **440 folders** - Complete organization
+2. ✅ **741 images** - All counted (with animations!)
+3. ✅ **4,201 plan** - Every asset mapped
+4. ✅ **Production ready** - Can start mass generation
+5. ✅ **Foundation solid** - Scalable to 10,000+ files
+
+---
+
+**FROM 99 DEMO ASSETS → 4,200 FULL GAME**
+
+**THE BLUEPRINT IS COMPLETE! 📋✨**
+
+---
+
+**Good night! Tomorrow we make it playable! 🎮🌙**
+
+**Total Project:** 135 hours | 741 images | 440 folders | Ready! ✅

TONIGHT_TILED_QUICKSTART.md

@@ -0,0 +1,322 @@
+# ☕ TONIGHT'S TILED SESSION - QUICK START
+
+**Session Time:** ~2 hours  
+**Goal:** Build 8×8 demo map ready for Phaser.js  
+**Coffee:** Recommended! ☕
+
+---
+
+## ⚡ SUPER QUICK CHECKLIST
+
+### 🚀 **STEP 1: OPEN TILED** (2 min)
+
+```bash
+# Check if installed
+which tiled
+
+# If not installed:
+brew install tiled
+
+# Launch
+tiled &
+```
+
+---
+
+### 🗺️ **STEP 2: CREATE MAP** (5 min)
+
+**In Tiled:**
+1. `File → New → New Map`
+2. **Settings:**
+   - Orientation: `Orthogonal`
+   - Tile layer format: `CSV`
+   - Map size: `8 × 8` tiles
+   - Tile size: `64 × 64` pixels
+3. `Save As...` → `/Users/davidkotnik/repos/novafarma/maps/demo_micro_farm.tmx`
+
+**✅ You have:** Empty 512×512px map
+
+---
+
+### 🎨 **STEP 3: ADD TERRAIN TILESET** (10 min)
+
+1. `Map → New Tileset...`
+2. Name: `terrain_demo`
+3. Type: `Collection of Images`
+4. Click `+` to add tiles:
+   - Browse to: `/Users/davidkotnik/repos/novafarma/assets/images/demo/terrain/`
+   - Select:
+     - `grass_tile_styleA.png`
+     - `dirt_tile_styleA.png`
+     - `tilled_dry_styleA.png`
+     - `tilled_watered_styleA.png`
+5. Save tileset: `/Users/davidkotnik/repos/novafarma/maps/tilesets/terrain_demo.tsx`
+
+**✅ You have:** Terrain tileset with 4 tiles
+
+---
+
+### 🌾 **STEP 4: ADD CROPS TILESET** (10 min)
+
+1. `Map → New Tileset...`
+2. Name: `crops_demo`
+3. Add tiles from: `/Users/davidkotnik/repos/novafarma/assets/images/demo/crops/`
+   - `wheat_stage0_styleA.png` through `wheat_stage4_styleA.png`
+4. Save: `/Users/davidkotnik/repos/novafarma/maps/tilesets/crops_demo.tsx`
+
+**✅ You have:** 5 wheat growth stages
+
+---
+
+### 🏕️ **STEP 5: ADD OBJECTS TILESET** (10 min)
+
+1. `Map → New Tileset...`
+2. Name: `objects_demo`
+3. Add from various folders:
+   - `buildings/tent_styleA.png`
+   - `environment/campfire_styleA.png`
+   - `environment/dead_tree_styleA.png`
+   - `environment/rock_styleA.png`
+4. Save: `/Users/davidkotnik/repos/novafarma/maps/tilesets/objects_demo.tsx`
+
+**✅ You have:** Buildings & decorations ready
+
+---
+
+### 📚 **STEP 6: CREATE LAYERS** (5 min)
+
+**In Layers panel (bottom-right), create these layers:**
+
+Right-click → `Add Layer` → choose type:
+
+1. **"Collision"** (Object Layer)
+2. **"Spawns"** (Object Layer)
+3. **"Decorations"** (Object Layer)
+4. **"Buildings"** (Object Layer)
+5. **"Crops"** (Tile Layer)
+6. **"Tilled Soil"** (Tile Layer)
+7. **"Base Terrain"** (Tile Layer) ← **START HERE!**
+
+**✅ You have:** 7 organized layers
+
+---
+
+### 🌱 **STEP 7: PAINT GRASS** (10 min)
+
+1. **Select layer:** `Base Terrain` (click on it in Layers panel)
+2. **Select tile:** Click `grass_tile_styleA` in Tilesets panel
+3. **Tool:** Press `G` (Bucket Fill)
+4. **Click map:** Fill entire 8×8 with grass
+
+**Optional:** Paint a few `dirt_tile_styleA` for variety
+
+**✅ You have:** Green grassy world!
+
+---
+
+### 🟫 **STEP 8: PAINT TILLED SOIL** (10 min)
+
+1. **Select layer:** `Tilled Soil`
+2. **Select tile:** `tilled_dry_styleA`
+3. **Tool:** Press `B` (Brush)
+4. **Paint 2×2 patch:**
+   - Row 1, Columns 1-2
+   - Row 2, Columns 1-2
+
+**Coordinates in pixels:** (64,64) to (192,192)
+
+**✅ You have:** Farmable area!
+
+---
+
+### ⛺ **STEP 9: PLACE TENT** (10 min)
+
+1. **Select layer:** `Buildings` (Object Layer!)
+2. **Tool:** Press `T` (Insert Tile)
+3. **Select tile:** Click `tent_styleA` in objects tileset
+4. **Click on map** at position **Column 6, Row 1**
+   - Pixel position: (384, 64)
+5. **Right-click tent → Object Properties:**
+   - Name: `tent`
+   - Type: `building`
+   - Add custom property:
+     - Name: `collision`
+     - Type: `bool`
+     - Value: `true`
+
+**✅ You have:** Player's base tent!
+
+---
+
+### 🔥 **STEP 10: PLACE DECORATIONS** (15 min)
+
+**Select layer:** `Decorations`
+
+**Place these (with Insert Tile tool, press T):**
+
+1. **Campfire** at (6,5) - pixel (384, 320)
+   - Type: `decoration`
+
+2. **Dead tree** at (0,0) - pixel (0, 0)
+   - Type: `decoration`
+
+3. **Rock** at (4,0) - pixel (256, 0)
+   - Type: `decoration`
+
+**✅ You have:** Atmospheric details!
+
+---
+
+### 👤 **STEP 11: ADD KAI SPAWN** (10 min)
+
+1. **Select layer:** `Spawns`
+2. **Tool:** Press `R` (Insert Rectangle)
+3. **Draw:** 32×32 box at position **(2, 5)**
+   - Pixel: (128, 320) width=32, height=32
+4. **Object Properties:**
+   - Name: `kai_spawn`
+   - Type: `player`
+   - Add custom property:
+     - Name: `facing`
+     - Type: `string`
+     - Value: `south`
+
+**✅ You have:** Player spawn point!
+
+---
+
+### 🧟 **STEP 12: ADD ZOMBIE SPAWN** (10 min)
+
+1. **Select layer:** `Spawns`
+2. **Tool:** Press `R` (Rectangle)
+3. **Draw:** 32×32 box at **(4, 4)**
+   - Pixel: (256, 256)
+4. **Properties:**
+   - Name: `zombie_1`
+   - Type: `npc_zombie`
+   - Custom:
+     - Name: `ai`
+     - Type: `string`
+     - Value: `idle_dig_loop`
+
+**✅ You have:** Zombie NPC spawn!
+
+---
+
+### 🚧 **STEP 13: ADD COLLISION** (15 min)
+
+1. **Select layer:** `Collision`
+2. **Tool:** Press `R` (Rectangle)
+3. **Draw collision boxes around:**
+   - **Tent:** 64×64 box at tent position (6,1)
+   - **Tree:** 48×64 box at tree position (0,0)
+   - **Rock:** 40×32 box at rock position (4,0)
+4. **For each:** Set Type = `collision`
+
+**✅ You have:** Collision system!
+
+---
+
+### 💾 **STEP 14: SAVE & EXPORT** (10 min)
+
+1. **Save map:** `Ctrl+S` or `File → Save`
+2. **Export JSON:**
+   - `File → Export As...`
+   - Format: `JSON map files (*.json)`
+   - Save to: `/Users/davidkotnik/repos/novafarma/maps/demo_micro_farm.json`
+
+3. **Verify:**
+   ```bash
+   ls -lh maps/demo_micro_farm.*
+   # Should see both .tmx and .json
+   ```
+
+**✅ YOU'RE DONE!** 🎉
+
+---
+
+## 🎯 **FINAL CHECKLIST**
+
+- [ ] Maps folder has `demo_micro_farm.tmx`
+- [ ] Maps folder has `demo_micro_farm.json`
+- [ ] Tilesets folder has 3 .tsx files
+- [ ] Map has 7 layers
+- [ ] Grass fills entire map
+- [ ] 2×2 tilled soil at (1,1)
+- [ ] Tent at (6,1)
+- [ ] Decorations placed (campfire, tree, rock)
+- [ ] Kai spawn at (2,5)
+- [ ] Zombie spawn at (4,4)
+- [ ] Collision boxes created
+
+**IF ALL CHECKED:** Map ready for Phaser.js! 🚀
+
+---
+
+## 📸 **WHAT IT SHOULD LOOK LIKE:**
+
+```
+   0  1  2  3  4  5  6  7
+0 [🌳][🌱][🌱][🌱][🪨][🌱][🌱][🌱]
+1 [🌱][🟫][🟫][🌱][🌱][🌱][⛺][🌱]
+2 [🌱][🟫][🟫][🌱][🌱][🌱][🌱][🌱]
+3 [🌱][🌱][🌱][🌱][🌱][🌱][🌱][🌱]
+4 [🌱][🌱][🌱][🌱][🧟][🌱][🌱][🌱]
+5 [🌱][🌱][👤][🌱][🌱][🌱][🔥][🌱]
+6 [🌱][🌱][🌱][🌱][🌱][🌱][🌱][🌱]
+7 [🌱][🌱][🌱][🌱][🌱][🌱][🌱][🌱]
+```
+
+---
+
+## ⏱️ **TIME BREAKDOWN**
+
+| Task | Time |
+|------|------|
+| Open Tiled | 2 min |
+| Create map | 5 min |
+| Add tilesets (3) | 30 min |
+| Create layers | 5 min |
+| Paint terrain | 10 min |
+| Paint tilled soil | 10 min |
+| Place buildings | 10 min |
+| Place decorations | 15 min |
+| Add spawns | 20 min |
+| Add collision | 15 min |
+| Save & export | 10 min |
+| **TOTAL** | **~2 hours** |
+
+---
+
+## 🆘 **TROUBLESHOOTING**
+
+**Can't find images?**
+- Make sure you browse to full path: `/Users/davidkotnik/repos/novafarma/assets/images/demo/...`
+
+**Tiles not showing in tileset?**
+- Check if PNGs have transparency (they should!)
+- Try re-adding the tile
+
+**Can't export JSON?**
+- Make sure `maps/` folder exists
+- Try `File → Export` instead of `Export As`
+
+**Map looks wrong?**
+- Check layer order (Base Terrain at bottom!)
+- Make sure correct layer is selected when painting
+
+---
+
+## 🚀 **AFTER THIS SESSION:**
+
+**Tomorrow you can:**
+1. Open full implementation guide
+2. Start Phaser.js integration (Task 2)
+3. Load this map in game! (1 hour)
+
+**In 3 days:**
+- Full playable demo! 🎮
+
+---
+
+**HAVE FUN BUILDING! ☕🗺️✨**