Skip to content
Hails edited this page Jul 15, 2026 · 6 revisions

hailsDotGO

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.

Highlights

  • 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

Find your path

For players

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.

For self-hosters

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.

For contributors

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 main directly. main reflects active development and is not guaranteed to be stable.

Clone this wiki locally