A Flutter-based idle game where you play as a minor deity collecting mythical cats to ascend to Mount Olympus.

Play now: https://atkins.github.io/mythical-cats/

For testing, debugging, or just having fun, the game includes a hidden Developer Mode with powerful tools.

1. Go to Settings tab (gear icon)
2. Scroll to the bottom of the screen
3. In the subtle text field, type: idkfa
4. Developer Tools section will appear with an orange header

Once activated, you'll have access to:

Developer mode state persists between sessions. Use the lock icon to hide the tools again.

Core Gameplay:

• Click to perform rituals and summon cats
• Buy buildings that auto-generate resources
• 20 building types (3 generic + 17 god-specific)
• First 6 gods unlocked (Hermes at start, Hestia at 1K, Demeter at 10K, Dionysus at 100K, Athena at 1M, Apollo at 10M cats)
• 6 resource types: Cats, Offerings, Prayers, Divine Essence, Ambrosia, Wisdom

Progression Systems:

• Auto-save every 30 seconds
• Offline progression (up to 24 hours, expandable to 72h with upgrades)
• Achievement system with 18 achievements granting permanent bonuses (2 hidden)
• Research/Tech Tree: 3 branches (Foundation, Resource, Knowledge) with 15 research nodes
• Conquest System: 11 conquerable territories with production bonuses
• Workshop Conversion: Transform offerings into Divine Essence
• Prophecy System: 10 divine prophecies with timed boost effects and cooldowns
• Reincarnation/Prestige System (unlocks at 1 billion cats):
  • Reset progress to earn Primordial Essence (PE) currency
  • 4 Primordial Forces with unique upgrade trees (20 upgrades total):
    • Chaos: Click power and active play bonuses
    • Gaia: Building production and cost reduction
    • Nyx: Offline progression bonuses
    • Erebus: Tier 2 resource generation bonuses
  • Patron System: Select one active force for enhanced temporary bonuses
  • Persistent Upgrades: Keep research, achievements, and purchased upgrades across runs
• Statistics tracking (total cats, buildings, gods, achievements, reincarnations, lifetime PE)

UI/UX:

• Mobile-first Material 3 design
• 8 tabs: Home, Buildings, Research, Conquest, Achievements, Prophecy, Reincarnation, Settings
• Number formatting for large values (K, M, B, T suffixes)
• Achievement progress tracking with hidden achievements
• Research node cards with prerequisites
• Territory conquest cards with bonuses
• Prophecy screen with 10 divine prophecy cards showing cooldowns and effects
• Wisdom display on home screen
• Reincarnation screen with patron selector and upgrade cards
• Prestige stats panel on home screen showing PE and active patron
• Confirmation dialogs with detailed reset/persist information

• Flutter SDK 3.x
• Chrome/Edge browser (for web) or iOS/Android device

# Get dependencies flutter pub get # Run on web flutter run -d chrome # Run tests flutter test

• State Management: Riverpod
• Game Loop: Flutter Ticker (60 FPS)
• Persistence: shared_preferences with JSON serialization
• UI: Material 3 with mobile-first design

lib/ models/ # 17 data models (GameState, Buildings, Resources, Gods, # Achievements, Research, Conquest, Prophecy, Reincarnation, # Primordial Forces & Upgrades) providers/ # 3 Riverpod providers (game, research, conquest logic) screens/ # 8 UI screens (Home, Buildings, Research, Conquest, # Achievements, Prophecy, Reincarnation, Settings) widgets/ # 14 reusable widgets (cards, converters, panels, # prophecy cards, primordial upgrade cards, patron selector) services/ # Save/load service utils/ # Number formatting utilities test/ # 39 test files (~7,400 lines) with comprehensive coverage models/ # Model definition and serialization tests providers/ # Game logic and state management tests e2e/ # End-to-end integration tests for all phases services/ # Save/load and persistence tests 

414 tests passing (100% pass rate) across 39 test files

Test Suite Breakdown:

• Provider Tests (game_provider, research_provider, conquest_provider)

  • Game logic, state transitions, production calculations
  • Research unlocking, prerequisites, and bonuses
  • Territory conquest, prerequisites, and bonus stacking
  • Reincarnation mechanics and primordial upgrades
  • Prophecy activation, cooldowns, and effects

• E2E Integration Tests

  • Phase 2-5 integration tests (complete gameplay flows)
  • Multi-reincarnation persistence (achievements, research, upgrades)
  • Cross-system bonus stacking (conquest + primordial + research)

• Model Tests

  • GameState serialization and JSON round-trips
  • Building definitions and cost formulas
  • Achievement definitions (all 18 achievements tested)
  • Research definitions (15 nodes across 3 branches)
  • Conquest definitions (11 territories with prerequisites)
  • Prophecy types and state management
  • Reincarnation state and primordial upgrades

• Service Tests

  • Save/load functionality with SharedPreferences
  • Complex state serialization (gods, research, territories, reincarnation)
  • Error handling for corrupt/invalid save data

Code Quality:

• 0 analyzer errors, 0 warnings
• Comprehensive coverage of all game systems
• Validates game balance, progression, and state persistence

Knowledge & Prophecy Systems:

• Athena (Goddess of Wisdom) - Unlocks at 1M cats, introduces Wisdom resource
• Apollo (God of Prophecy) - Unlocks at 10M cats, enhances prophecy system
• 8 new buildings: 4 for Athena (Hall of Wisdom, Academy of Athens, Strategy Chamber, Oracle's Archive), 4 for Apollo (Temple of Light, Oracle's Sanctum, Muse's Chamber, Delphic Treasury)
• Prophecy System: 10 unique prophecies with powerful timed boosts (production multipliers, instant resources, cost reductions)
• Knowledge Research Branch: 7 new research nodes enhancing Wisdom production and reducing costs
• 3 new territories: Athens, Delphi, Alexandria (with Wisdom production bonuses up to +50%)
• 10 new achievements with powerful rewards:
  • Flat production bonuses (+0.5 and +1.0 Wisdom/sec)
  • Percentage bonuses (+2% all resources, +5% Athena buildings, +10% Wisdom)
  • Cost reductions (-5% research, -10% conquest)
  • Cooldown reductions (-5% all prophecies, -30 minutes for Grand Vision)
  • Offline bonus (+25% offline cat production)

• Ares (God of War) - Unlocks at 100M cats
• Combat system with battles and victories
• War resources: Might, Glory
• Conquest enhancements with combat mechanics
• Competitive elements

• Gods 8-12: Artemis (Hunting), Hephaestus (Crafting), Aphrodite (Influence), Poseidon (Seas), Zeus (Thunder)
• Advanced systems: Breeding, Artifacts, Random Events
• Ascension to Olympus endgame
• Meta-progression beyond reincarnation

MIT