🏆 PokéMMO Compendium

Your Ultimate Interactive Guide to Mastering PokéMMO

Welcome to the PokéMMO Compendium — your comprehensive, step-by-step companion for conquering the most challenging battles and mastering essential game mechanics. Whether you're facing the Elite Four, breeding perfect Pokémon, calculating catch rates, or optimizing your farming strategies, this guide provides detailed, battle-tested approaches used by top players.

🎯 What This Guide Offers

⚔️ Battle Strategies & Walkthroughs

• 🏆 Elite Four: Complete walkthroughs for every region (Kanto, Johto, Hoenn, Sinnoh, Unova) with proven team compositions and turn-by-turn strategies.
• 💀 Boss Fights: Detailed guides for major boss encounters (Red, Ho-Oh, etc.), including enemy team analysis and optimal counters.
• ⚔️ Super Trainers: Strategies to defeat the toughest NPC trainers in the game.
• 🤝 Raids: Comprehensive raid guides with star-level filtering, role-based turn strategies, recommended builds, and mechanic breakdowns (HP thresholds, abilities).

🧰 Tools & Calculators

• 🧬 Breeding Planner: Advanced calculator to determine the most efficient path for breeding 2x31, 3x31, or 5x31 competitive Pokémon, complete with cost visualization.
• 🧮 Catch Calculator: Real-time probability calculator supporting all ball types, status conditions, HP percentages, and special ball mechanics (Dream, Nest, Timer Ball).
• 🔄 Trainer Reruns: Optimized routes for Gym Runs and Trainer Reruns to maximize money making, including requirements and tips.
• 📦 Pickup Guide: Searchable data on pickup items by region and location.
• 📚 Pokédex: Fast, filterable database of Pokémon with sprites and basic info.

⚡ Technical Features

• 📱 Mobile-First Design: Clean, responsive interface that works perfectly on any device.
• 🔐 User Data (Firebase): Features like "My Teams" allow authenticated users to create, save, and manage their own custom teams and strategies using Firebase Firestore. Data like Boss Fights and Pokédex are also managed via Firestore for easier updates.
• 🌐 Dynamic Base URL Handling: Supports different base URLs for local development and Firebase Hosting deployment.
• 🔄 Workflow & Versioning: Structured use of GitHub Labels and Semantic Versioning (see WORKFLOW.md).

---

⚡ Status

---

📸 Screenshots

🌐 Application Overview

🏠 Landing Page

⚔️ Battle Strategies & Walkthroughs

🏆 Elite Four Strategies

Interactive decision trees for every turn of the battle.

💀 Boss Fights

Detailed guides for major boss encounters.

⚔️ Super Trainers

Strategies to defeat the toughest NPC trainers.

🤝 Raids

Comprehensive raid guides with star-level filtering and role-based strategies.

🧰 Tools & Calculators

🧬 Breeding Planner

Advanced calculator for breeding competitive Pokémon.

🧮 Catch Calculator

Real-time probability calculator for catching Pokémon.

🔄 Trainer Reruns

Optimized routes for Gym Runs and Trainer Reruns.

📦 Pickup Guide

Searchable data on pickup items by region and location.

📚 Pokédex

Fast, filterable database of Pokémon with sprites and basic info.

✨ User-Specific Features & CMS

🔐 My Teams (User-Specific Team Builder)

Create, save, and manage your own custom teams and strategies. Advanced editor for building and refining user teams.

---

📁 Project Structure

/
├── dist/               # Production build output
├── public/             # Static assets (images, icons)
├── src/
│   ├── app/            # Core app logic
│   │   ├── App.tsx     # Root provider shell & Outlet container
│   │   ├── Providers.tsx # Composition of app context providers
│   │   ├── router.tsx  # Central routing logic & lazy loading
│   │   ├── index.css   # Global styles & Tailwind directives
│   │   └── main.tsx    # Application DOM entry point
│   ├── firebase/       # Firebase configuration and service layer
│   │   ├── config.ts   # App initialization
│   │   └── services/   # Domain-specific services (teams, pokedex, moves, etc.)
│   ├── pages/          # Feature-specific pages
│   │   ├── auth/       # Authentication (Login/Signup)
│   │   ├── boss-fights/      # Strategies for Bosses
│   │   ├── breeding/         # Breeding Calculator
│   │   ├── catch-calculator/ # Catch Rate Calculator
│   │   ├── elite-four/       # Elite Four Strategies
│   │   ├── my-teams/         # User-specific Team Builder
│   │   ├── pickup/           # Pickup Item Guide
│   │   ├── pokedex/          # Pokémon Database Viewer
│   │   ├── raids/            # Raid Battle Strategies
│   │   ├── super-trainers/   # Super Trainer Strategies
│   │   └── trainer-rerun/    # Gym Run / Money Making Routes
│   ├── components/     # UI components (Atomic Design)
│   ├── context/        # Global state and providers
│   ├── hooks/          # Custom React hooks
│   ├── types/          # Domain models & Zod schemas
│   ├── constants/      # App constants
│   └── utils/          # Helper functions
├── eslint.config.js    # ESLint configuration
├── package.json        # Dependencies and scripts
└── vite.config.ts      # Vite configuration

---

🚀 Getting Started

Prerequisites

• Node.js (>=22.22.2)
• pnpm (>=10.33.0)

Installation

1. Clone the repository:

   git clone https://github.com/SolaneHub/PokeMMO-Compendium.git
   cd PokeMMO-Compendium

2. Install dependencies:

   pnpm install

Running Development Environment

pnpm dev

• Frontend: http://localhost:5173

Building for Production

pnpm build

This compiles the application into the dist/ directory, ready for deployment.

Linting & Formatting

pnpm lint         # Check for code quality issues
pnpm lint:fix     # Auto-fix issues
pnpm format       # Format code with Prettier
pnpm validate     # Run full validation check

---

💡 Inspiration & Credits

This compendium is a community-driven effort to aggregate knowledge for PokéMMO players.

• Breeding & Pokédex: Inspired by concepts from PokéMMO Hub.
• Elite Four, Red & Ho-Oh: Strategies adapted from Team Porygon and PokeKing.
• Raids: Based on content from the caav YouTube Channel.
• Pickup: Data sourced from PokéMMO ShoutWiki.

---

©️ License

This project is released under the Unlicense. It is free and unencumbered software released into the public domain. You can copy, modify, publish, use, sell, or distribute this software for any purpose, commercial or non-commercial.