-
Notifications
You must be signed in to change notification settings - Fork 0
Home
hailsDotGO is a fan-made Pokemon GO companion web app built in Go, with a TypeScript frontend compiled by esbuild and a MySQL database behind it. It bundles raid listings, battle math, event tracking, shiny collecting, and a full community layer (trainer directory, raid matchmaking, trust and awards) into one self-hostable site. A free public instance runs at pogo.hails.live.
- Live raid bosses and Max Battles with counter recommendations
- DPS calculator, PvP IV ranker, and a full events page sourced from LeekDuck, with a subscribable calendar feed that keeps every subscriber's local time correct
- Personal shiny collection tracker with costume, event, and duplicate tracking
- Regional shiny forms (Alolan, Galarian, Hisuian, Paldean) tracked as their own collection cards, plus per-pattern Vivillon and per-letter Unown tracking
- Data-driven costume system that renders costumed shinies on public trainer profiles
- IV Calculator screenshot scanning that reads the level arc and identifies nicknamed Pokemon by their candy
- Raid Finder with matchmaking queues, lobbies, and a behavioral trust system
- In-app bug reports and player (bad-actor) reports with a threaded reporter and staff messenger
- Multi-language UI with a built-in translator workspace and GitHub sync
- Public JSON API with rate limits and an unthrottled private mirror
Curious what each feature does? Start with Raids and Counters, DPS Calculator, IV Calculator, PvP IV Ranker, Events, Shiny Tracking, Trainer Directory, Raid Finder, Trust and Awards, Bug Reports, Player Reports, and the Store.
Run your own instance: Releases and Upgrading is the recommended starting point for installing a stable tagged version (and for moving an existing install up), Getting Started walks through the first install in detail, Configuration covers every environment variable, the Database Guide explains the schema and migrations, Deployment covers putting it on a Linux server, and Operations covers day-2 upkeep.
Hack on the code: Building and Development for the build pipeline and dev loop, the Frontend Guide for the TypeScript side, Localization and the Translator Workspace for translations, and Architecture for how it all fits together.
Prefer tagged releases over cloning
maindirectly.mainreflects active development and is not guaranteed to be stable.
Repository | Live site | hailsDotGO is a fan-made project, not affiliated with, endorsed by, or connected to Niantic or The Pokémon Company. Game data comes from community sources credited on the Data Sources page.
Start Here
Features
- Raids and Counters
- DPS Calculator
- IV Calculator
- PvP IV Ranker
- Events
- Shiny Tracking
- Trainer Directory
- Raid Finder
- Social Features
- Trust and Awards
- Bug Reports
- Player Reports
- Store
- Accounts and Roles
- Admin Guide
Self-Hosting
Development
Translations