A Pokémon-inspired creature battling game built entirely with Phaser 3, TypeScript, and Vite. All visuals are generated with Phaser's graphics primitives — no external images required.

npm install
npm run dev        # start dev server on http://localhost:3000

Other commands:

npm run build      # type-check + production build → dist/
npm run preview    # preview the production build
npm test           # run tests once
npm run test:watch # run tests in watch mode

1. New Game — pick a starter creature (Fire, Water, or Grass).
2. Explore — move with WASD or Arrow keys. Walk through dark-green tall grass for wild encounters. Pick up the Fishing Rod if it appears on the map; from the menu, open Items and use the rod while standing next to water to fish for Water-type wild battles.
3. Battle — choose from four actions:
   • ⚔ Fight — pick one of your creature's four moves.
   • 🎯 Catch — throw a capture orb (unlimited supply). Lower the wild creature's HP first for a better chance.
   • 🔄 Switch — swap to another party member (the enemy gets a free hit).
   • 🏃 Run — attempt to flee.
4. Level up — defeating wild creatures awards XP. Stats recalculate on each level up.
5. Catch 'em all — your party holds up to 6 creatures; extras go to the box.

Progress is saved to localStorage automatically after every battle.

Multipliers show damage when the row type attacks the column type (src/core/types.ts).

• Individual Values (IVs) — each caught creature gets random 0–15 bonuses to HP, Attack, Defense, and Speed, making every individual unique.
• Randomized Moves — creatures learn 4 random moves from their species' pool upon creation.
• Stat Formula — floor(((2 × base + iv) × level) / 100) + 5 (HP adds + level + 10 instead).
• Damage Formula — ((2L/5 + 2) × Power × A/D) / 50 + 2) × effectiveness × random(0.85–1.0).
• Catch Rate — (1 − currentHP/maxHP) × 0.65 + 0.3 per shake (3 shakes needed). Ranges from ~2.7% at full HP to ~86% at 1 HP.
• Wild Level Scaling — when you have a single creature, wild encounters are always a lower level. With 2+ creatures, wilds spawn at party average ± 2.
• XP Curve — cubic: floor(level³ × 0.8).

src/
├── main.ts                       # Phaser game config & entry point
├── core/
│   ├── types.ts                  # Interfaces, enums, type chart
│   ├── creatureFactory.ts        # Creature instantiation, IVs, leveling
│   ├── battleEngine.ts           # Damage calc, turns, catching, XP
│   ├── saveManager.ts            # localStorage save / load / delete
│   ├── eventBus.ts               # Typed events between scenes/systems
│   ├── random.ts                 # Injectable RNG (tests + gameplay)
│   └── *.test.ts                 # Unit tests for core modules
├── data/
│   ├── attacks.ts                # Move definitions + ALL_ATTACKS list
│   └── creatures.ts              # CREATURE_DEX species definitions
├── utils/
│   └── creatureRenderer.ts       # Procedural creature drawing
└── scenes/
    ├── BootScene.ts              # Title screen
    ├── StarterSelectScene.ts     # Starter picker
    ├── OverworldScene.ts         # Tile map exploration + encounters
    ├── BattleScene.ts            # Battle UI + animations
    ├── SettingsScene.ts          # Settings + Fresh Start
    ├── PartyScene.ts             # Party management
    ├── CreatureDexScene.ts       # Dex list
    ├── CreatureDetailScene.ts    # Single species view
    └── systems/                  # Overworld/battle subsystems + tests
        ├── EncounterSystem.ts
        ├── BattleStateMachine.ts
        ├── OverworldHub.ts
        ├── OverworldMenuController.ts
        ├── TouchInputController.ts
        ├── MapItemSystem.ts
        └── index.ts

See AGENTS.md for an agent-oriented map of how gameplay code fits together. For adding moves, species, or types, see .cursor/skills/tiny-creatures-content/SKILL.md (Cursor skill).

Open ⚙ Settings from the title screen or the in-game menu bar. The Fresh Start button wipes all localStorage data after a confirmation prompt — handy for starting over.

• Phaser 3 — game framework (rendering, input, tweens, scenes)
• TypeScript — type-safe game logic
• Vite — dev server & bundler
• Vitest — unit tests (npm test; 12 test files in src/)