VGC Reporter

Pokémon Champions competitive stats & team builder, as a native app for desktop and Android.

Public beta — first release! Built with pure, hardcore vibe-code. Expect rough edges; please report any issue you hit so we can iterate fast.

Download · Screenshots · Quick Start · Features · Known Issues · Data Sources · Architecture · Development

Pokémon Champions launched on 8-Apr-2026 and instantly became the official VGC 2026 / Worlds platform. Usage data is scattered across Pikalytics, Pokemon-Zone, Porygon Labs, Champions Lab, Smogon chaos JSON and Limitless VGC standings. None of these sites share a unified API, and there is no offline-friendly way to browse the meta and build a team in the same place.

VGC Reporter is the tool I wanted while team-building for Regulation M-A: one window, real tournament data, drill-down by Pokémon, and everything cached locally.

• Real tournament data, not just ladder — aggregates Limitless VGC standings into usage stats, with Smogon chaos as fallback when the format is too fresh. Recent Champions tournaments are listed with full decklists rendered inline.
• Format switcher with favorite — Regulation M-A (Champions doubles), Champions Singles, Regulation I, Gen 9 OU. Pin one as favorite so it opens first every time.
• Offline-friendly by design — SQLite-backed HTTP cache, all network I/O on the Rust side, zero CORS pain.

Dashboard — meta snapshot, top usage, recent tournaments	Pokédex — competitive sets, usage and type matchups
Team Builder — regulation-aware pickers and EV sliders	My Teams — local team library (rename / duplicate / delete)
Top Teams — tournament-winning teams from Limitless, with filters and Markdown export	Damage Calc — @smogon/calc Gen 9 with searchable inputs

Pre-built installers for the v0.4.1.20260921-beta release:

→ Download from the latest GitHub Release

First launch downloads ~10 MB of Pokédex / moves / items / abilities and caches them locally; subsequent launches work offline until caches expire.

bun install
bun run tauri:dev

First launch downloads and caches Pokédex, moves, items, abilities and usage stats. Subsequent launches are offline-capable until caches expire.

• Top Teams "Show all" can render 4000+ team cards in a single page. Performance is acceptable but expect 5–15s render on first display; the app shows progressive hints while loading.
• macOS bundles are unsigned. Gatekeeper will block the first launch — right-click the app → Open → Open Anyway. Code signing is on the post-beta roadmap.
• Linux: requires webkit2gtk-4.1 (Ubuntu 22.04+ / Fedora 38+ ship it). Older distros need to install it manually.
• Android APK is unsigned (sideload only). Play Store distribution is on the roadmap.
• Android auto-update: the app will notify you when a new version is available and guide you through the install. You still need "Install from unknown sources" enabled.
• First-run cache: first launch needs internet. If a data source is down (Labmaus, Limitless), partial data is still rendered with a warning banner.
• Pikalytics breakdown depends on Pikalytics being up; falls back to Showdown chaos data when unavailable.

Found something else? Open an issue — beta feedback is gold.

Not integrated (no public API): Pokemon-Zone, Porygon Labs, Champions Lab, Pokebase, Munchstats. Exposed as one-click external links — no scraping.

flowchart TD
    subgraph FE["React 19 · TS · Vite (webview)"]
        Pages[pages] --> Hooks[hooks]
        Hooks --> Stores[Zustand stores]
        Hooks --> IPC["ipc.ts (typed via ts-rs)"]
        I18n["i18next · 5 languages"] -.-> Pages
    end

    IPC -->|"invoke() · typed JSON"| CMD

    subgraph BE["Rust backend · clean architecture"]
        CMD["commands/  (thin IPC layer)"]
        CMD --> SVC["services/  (use cases)"]
        SVC --> DOM["domain/  (pure entities)"]
        SVC --> ADP["adapters/  (HTTP clients)"]
        SVC --> STO["storage/  (rusqlite + r2d2)"]
        ADP --> HTTP["HttpClient + SQLite cache"]
    end

    HTTP -.-> EXT["External APIs<br/>Labmaus · Limitless · Showdown<br/>PokéAPI · Pikalytics · Smogon · Pokepaste"]

    classDef ext fill:#1a1f2e,stroke:#2b86ff,color:#cdd6f4;
    class EXT ext;

Rule: dependencies always point inward. domain/ knows nothing about I/O, Tauri or SQLite. All network calls flow through adapters/http_client.rs which writes to the SQLite cache so the frontend never needs to handle rate limits or CORS.

# Dev mode (Vite HMR + Tauri window)
bun run tauri:dev

# Production bundle → src-tauri/target/release/bundle/msi/
bun run tauri:build

# Android — hot reload in emulator or USB device
bun run tauri android dev

# Android — build APK
bun run tauri android build --apk

# Rust tests + ts-rs bindings regeneration
cd src-tauri && cargo test

# Rust lint
cd src-tauri && cargo fmt && cargo clippy -- -D warnings

# Frontend type-check
bun run --cwd frontend build

Package manager: this project uses Bun exclusively. Do not use npm/npx/package-lock.json. See CLAUDE.md § Package manager for the npm→Bun mapping.

VGC-Reporter/
├── frontend/                 React 19 + TS + Vite
│   ├── src/
│   │   ├── pages/            one file per route
│   │   ├── components/       layout, pokemon, team, charts, tournament, dashboard, filters, info, ui
│   │   ├── stores/           Zustand (teamBuilder, dashboard, pokedex, filters, ui)
│   │   ├── lib/              ipc, queryKeys, types (ts-rs generated), formatDate, labels, typeChart
│   │   ├── hooks/            query + localization helpers
│   │   ├── locales/          es.json / en.json
│   │   └── i18n.ts
│   └── public/logo.png
├── src-tauri/                Rust backend (clean architecture)
│   ├── src/
│   │   ├── domain/           pure entities
│   │   ├── services/         use cases
│   │   ├── adapters/         HTTP clients
│   │   ├── storage/          SQLite pool, migrations, repos
│   │   └── commands/         Tauri IPC handlers
│   ├── icons/                generated by ImageMagick
│   └── tauri.conf.json
├── assets/logo.png
├── CLAUDE.md                 project-wide guide
└── README.md

• Node.js 20+
• Rust 1.80+ (stable)
• Desktop: Windows 10/11, macOS 12+, or Linux with webkit2gtk-4.1
• Android: Android Studio + SDK API 24+, NDK r25c, JDK 17–24, ANDROID_HOME / NDK_HOME set; run rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android first
• First run needs internet access to populate the cache

PumaSoft

MIT © 2026 PumaSoft — see LICENSE.