Skip to content
MartzcodePublic

About

Dexorium is an offline-first Pokemon Pokedex desktop app for players, collectors and competitive trainers. Native, fast and private: Tauri 2, Rust, Angular 20 and SQLite FTS5.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

64 Commits

Folders and files

Repository files navigation

Dexorium, offline PokΓ©mon desktop encyclopedia

Dexorium

A fast, fully offline PokΓ©mon desktop encyclopedia for players, collectors and competitive trainers.

Tauri 2 Rust Angular 20 SQLite FTS5 License: AGPL-3.0 Status: early development CI Platforms

Why Dexorium Β· Features Β· Tech stack Β· Architecture Β· Getting started Β· Roadmap Β· Contributing


🌐 What is Dexorium?

Dexorium is a native desktop PokΓ©dex and PokΓ©mon reference application that works with zero internet connection. Species, forms, base stats, types, abilities, moves, items, evolution chains, learnsets and competitive tools are bundled locally and queried through an embedded SQLite database: no account, no ads, no telemetry and no silent network calls.

It is built for people who need reliable data right now: at a tournament with unreliable Wi-Fi, on a plane, in a venue basement, or simply when the major reference wikis are slow. The interface targets professional-tool ergonomics: instant search, full keyboard navigation, a command palette, cross-linked pages and a light/dark theme that follows the OS.

Project status: offline PokΓ©dex MVP (v1.0). The Tauri shell, layered Rust workspace, embedded SQLite reference database (1,025 species, 1,351 forms, 919 moves, 374 abilities, 638k learnset rows), typed IPC bridge and Angular interface are in place. Favourites, type chart, command palette and settings are implemented; unsigned packaging is automated, while E2E coverage and code signing remain. See the roadmap.


πŸ’‘ Why Dexorium?

Problem Dexorium's answer
Reference wikis need a connection and are slow Complete local dataset, indexed SQLite queries
Mobile PokΓ©dex apps are ad-supported or abandoned Native desktop app, no ads, versioned data
Data is scattered across five different sources One unified, cross-linked data model
Competitive tools live outside the PokΓ©dex Damage calculator, team builder and type coverage built in
Serious living-dex tracking is an afterthought Collection profiles, filters and export

Design goals

  • Offline absolute. The full database ships with the binary. No network dependency at runtime.
  • Native performance. Cold start below 1.5 s, search over 1,000+ species and 900+ moves in under 50 ms.
  • Data depth. Moves, abilities, items, encounters, evolution conditions, learnsets per version group and competitive calculators.
  • Accessibility. WCAG 2.1 AA target, full keyboard navigation, visible focus and reduced-motion support.
  • Auditability. Every dataset field can be traced back to its source and game version.
  • Privacy first. Local user data only. No account, no analytics, no telemetry.

✨ Features

Available now: foundation

  • Native Tauri 2 window with a strict Content Security Policy and a minimal ACL
  • Angular 20 standalone shell, signals, zoneless change detection, lazy routes
  • Transloco internationalization with runtime FR/EN switching
  • Light / dark / system theme with persistence
  • Typed IPC facade over the Tauri bridge
  • Layered Rust workspace: pdx-domain, pdx-app, pdx-infra
  • Domain smoke tests and a clean dependency direction

Offline PokΓ©dex MVP (v1.0)

  • Embedded SQLite reference database with FTS5 search
  • National PokΓ©dex with virtual scrolling, list and table views
  • Complete species pages: stats, types, abilities, forms, flavor text and placeholders
  • Evolution chains with readable conditions
  • Move and ability catalogues with detail pages and holders/learners
  • Learnsets filterable by version group and learn method
  • Instant fuzzy search across French and English names (FTS5 + Levenshtein fallback)
  • Multi-criteria filters: type, generation, stat ranges, flags and favourites
  • Global command palette (Ctrl/Cmd + K)
  • Favourites persisted in user.db, with a SQL-level favourites filter
  • Interactive 18Γ—18 type effectiveness chart per generation
  • Settings page with theme, language, dataset provenance and licences
  • Packaging/signing of the three platforms, E2E campaign and release checklist

Planned

  • Damage and stat calculators, speed tiers, type coverage (v1.2)
  • Team builder with legality checks and Showdown import/export (v1.2)
  • Encounter locations, items, abilities catalogues (v1.1 β†’ v1.2)
  • Collection profiles and living-dex tracking (v1.3)
  • Signed data packs, custom themes and local API (v1.4 β†’ v2.0)

πŸ—ƒοΈ Data sources

The reference dataset is built from a pinned snapshot of PokeAPI/api-data (commit 447bd5c378bf87da964bfe4dd7487a7bf1d97cbd, BSD-3-Clause). The commit and lock file are recorded in dataset_meta and shown in the application settings, so every shipped database can be traced back to its source.

  • 18 battle types (Gen I–IX), with per-generation effectiveness matrices.
  • French and English localizations for species, forms, moves, abilities, types, egg groups and stats.
  • No official PokΓ©mon sprites or artwork are bundled. Thumbnails are original placeholders; an optional media pack can be installed separately.
  • reference.db is read-only and replaced on dataset upgrades. Favourites and future user data live in a separate user.db, which survives upgrades.

🧰 Tech stack

Layer Technology Role
Desktop shell Tauri 2 Native window, IPC, capabilities, signed installers
Backend Rust (stable, edition 2024) Native performance, predictable latency, memory safety
Frontend Angular 20 Standalone components, signals, zoneless, CDK
State NgRx Signals Reactive domain stores
UI primitives Angular CDK + custom design tokens Virtual scroll, overlays, accessibility without Material lock-in
Styling SCSS + CSS custom properties Instant theming, no CSS-in-JS runtime
i18n Transloco Hot language switching and lazy dictionaries
Database SQLite 3 + FTS5 Embedded reference data and full-text search
IPC contract Tauri commands + typed TypeScript facade One thin command per use case
Testing cargo test, Vitest, Testing Library, WebdriverIO Unit, component and E2E coverage

πŸ— Architecture

flowchart TB
    subgraph WebView["Angular 20 WebView"]
        UI["Standalone components<br/>+ signals"]
        STORE["Domain stores"]
        FACADE["Feature facades"]
        IPC["Typed IPC facade"]
    end

    subgraph Bridge["Tauri 2 IPC"]
        CMD["#[tauri::command]"]
        ACL["Capabilities / ACL"]
    end

    subgraph Core["Rust workspace"]
        APP["pdx-app<br/>use cases + ports"]
        DOM["pdx-domain<br/>pure business rules"]
        INFRA["pdx-infra<br/>SQLite Β· search Β· cache"]
    end

    subgraph Data["Local storage"]
        REF[("reference.db<br/>read-only")]
        USER[("user.db<br/>read/write")]
    end

    UI --> STORE --> FACADE --> IPC --> CMD
    CMD --> APP --> DOM
    APP --> INFRA
    INFRA --> REF
    INFRA --> USER
    ACL -.->|scopes| CMD
Loading

Dependency rule: pdx-domain ← pdx-app ← pdx-infra ← Tauri binary. The domain layer knows nothing about SQLite, Tauri or the file system.

Storage split: reference.db is replaced on dataset upgrades; user.db holds favourites, teams, notes and settings and is never touched by a dataset update. Cross-database references use stable slugs, not technical IDs.


πŸ“ Project structure

Dexorium/
β”œβ”€β”€ assets/branding/               # README banner and brand assets
β”œβ”€β”€ public/i18n/                   # en.json, fr.json
β”œβ”€β”€ src/                           # Angular application
β”‚   β”œβ”€β”€ app/
β”‚   β”‚   β”œβ”€β”€ core/                  # IPC, app info, i18n, theme
β”‚   β”‚   β”œβ”€β”€ features/              # Lazy-loaded feature areas
β”‚   β”‚   β”œβ”€β”€ layout/                # App shell, sidebar, top bar
β”‚   β”‚   β”œβ”€β”€ app.config.ts
β”‚   β”‚   └── app.routes.ts
β”‚   └── styles/                    # Design tokens and global styles
β”œβ”€β”€ src-tauri/                     # Rust workspace + Tauri configuration
β”‚   β”œβ”€β”€ crates/
β”‚   β”‚   β”œβ”€β”€ pdx-domain/            # Entities and pure rules
β”‚   β”‚   β”œβ”€β”€ pdx-app/               # Use cases and ports
β”‚   β”‚   └── pdx-infra/             # SQLite, search, cache adapters
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ commands/              # Thin Tauri commands
β”‚   β”‚   └── lib.rs
β”‚   β”œβ”€β”€ capabilities/              # Tauri v2 ACL
β”‚   └── tauri.conf.json
β”œβ”€β”€ package.json
└── README.md

🏁 Getting started

Prerequisites

  • Node.js 20+ and npm
  • Rust stable with Cargo
  • Tauri system dependencies: see the official prerequisites
    • Windows: WebView2 (bundled with Windows 10/11) and MSVC Build Tools
    • macOS: Xcode Command Line Tools
    • Linux: libwebkit2gtk-4.1-dev, build-essential, libssl-dev, libayatana-appindicator3-dev, librsvg2-dev

Install

git clone https://github.com/Martzcode/Dexorium.git
cd Dexorium
npm install

Run the Angular interface in a browser

npm run start

Useful for UI work. The Tauri IPC bridge is disabled in this mode, so the shell shows a browser preview status instead of the desktop runtime.

Run the native desktop app

npm run desktop:dev

Build the reference dataset

The SQLite reference database is not committed to the repository. It is produced by the pdx-dataset crate from a pinned source snapshot (see tools/dataset/sources.lock.toml):

# Fetch the pinned source snapshot (cached in ~/.cache/pdx-dataset)
cargo run --manifest-path src-tauri/Cargo.toml -p pdx-dataset --release -- fetch

# Build, validate the 14 rules, then install src-tauri/resources/reference.db
cargo run --manifest-path src-tauri/Cargo.toml -p pdx-dataset --release -- \
  release --version 2026.11.0 --install-resource

The application opens reference.db at startup (resource directory, then src-tauri/resources/, then DEXORIUM_REFERENCE_DB). When the file is absent it falls back to the small bundled fixture so the interface remains usable. reference.db is read-only and replaced wholesale on dataset upgrades; user data lives in a separate user.db.

Build a production desktop bundle

npm run desktop:build

The installer is written to src-tauri/target/release/bundle/ (MSI/NSIS on Windows, DMG on macOS, deb/rpm/AppImage on Linux).

Releases

Releases are automated on every push to main, once the CI workflow succeeds:

  • version and tag: YYYY.MM.XX, with XX starting at 01 each month (for example v2026.11.01);
  • the bundled PokΓ©dex is rebuilt from the pinned dataset lockfile and validated as part of the pipeline;
  • release assets only contain installers: NSIS .exe, .msi, .msix (Microsoft Store), .deb and .rpm. Dataset reports, checksums and the reference database are kept as workflow artifacts instead.

Microsoft Store identity

The MSIX identity must match the reservation in Microsoft Partner Center. These values are public, so they are stored as repository variables (not secrets):

Variable Value used by Dexorium
MS_STORE_IDENTITY_NAME Martzcode.Dexorium
MS_STORE_PUBLISHER CN=7D2188A8-E979-4CC7-B4CA-0B3ADA615D01
MS_STORE_PUBLISHER_DISPLAY Martzcode

Configure them in Settings β†’ Secrets and variables β†’ Actions β†’ Variables, or with the GitHub CLI:

gh variable set MS_STORE_IDENTITY_NAME --body "Martzcode.Dexorium"
gh variable set MS_STORE_PUBLISHER --body "CN=7D2188A8-E979-4CC7-B4CA-0B3ADA615D01"
gh variable set MS_STORE_PUBLISHER_DISPLAY --body "Martzcode"

The workflow also accepts the same names as secrets, which makes the switch from an earlier setup seamless. With these values, Partner Center derives the expected package family name Martzcode.Dexorium_4hz7d9j9njen8.

Signing is separate and always optional: the Store re-signs submitted packages, so nothing is needed unless the MSIX must also be sideloaded.

Secret Purpose
MSIX_SIGN_PFX_BASE64 Optional base64 PFX to sign the MSIX (sideloading)
MSIX_SIGN_PASSWORD Optional password of that PFX

When the variables are unset, the script falls back to the reserved Martzcode identity and publishes an unsigned MSIX, which Partner Center re-signs on submission.

Useful scripts

Command Description
npm run start Angular dev server on http://localhost:4200
npm run build Production Angular build
npm run desktop:dev Tauri development app with hot reload
npm run desktop:build Production desktop bundle
npm run check:rust cargo check for the whole Rust workspace
npm run check:fmt cargo fmt --check for the Rust workspace
npm run test:rust Rust unit tests
npm run format Format the repository with Prettier
npm run check Format check + Angular build + Rust check/tests

πŸ–₯ Platforms

Platform Targets
Windows Windows 10+ x64 / ARM64 (MSI + NSIS)
macOS macOS 12+ Intel / Apple Silicon (notarized DMG)
Linux deb, rpm, AppImage

The Tauri 2 foundation also keeps a native mobile build possible in a later phase, but mobile is not a current priority.


πŸ—Ί Roadmap

Milestone Scope Status
Phase 0: Foundation Tauri shell, Rust workspace, IPC, Angular shell, themes, i18n βœ… Done
v1.0: Offline Pokédex MVP Dataset, species pages, evolution, learnsets, search, filters, favourites, type chart, command palette, settings 🚧 Feature-complete, release pending
v1.1: Data & comfort Abilities, items, saved filters, comparison, exports, shortcuts Planned
v1.2: Competitive toolkit Damage/stat calculators, team builder, coverage, encounters, Showdown I/O Planned
v1.3: Collection Profiles, living dex, tags, notes, dashboard Planned
v1.4: Extensibility Signed data packs, custom themes, diagnostics Planned
v2.0: Platform Plugin system, local read-only API, companion CLI Backlog

Detailed product specifications and the data-source annex are maintained privately during development and will be published alongside the first public release.


πŸ”’ Privacy and offline guarantees

  • No account, sign-up or cloud sync.
  • No analytics, crash reporting or telemetry by default.
  • No runtime network calls: the application is fully functional offline.
  • User data stays in the local application data directory.
  • Update checks, when added, will be opt-in only.

βš–οΈ Legal notice

Dexorium is an unofficial, non-commercial reference tool. It is not affiliated with, endorsed by or sponsored by Nintendo, Creatures Inc., GAME FREAK Inc. or The PokΓ©mon Company.

PokΓ©mon and PokΓ©mon character names are trademarks of their respective owners. Official sprites and artwork are not distributed in the base binary; media packs are optional and user-provided where required by the applicable rights. The source code is licensed under the GNU Affero General Public License v3.0. See LICENSE and NOTICE.


🀝 Contributing

If Dexorium is useful to you, star the repository; it helps the project reach other players and trainers.


πŸ“„ License

AGPL-3.0-or-later Β© 2026 Martzcode

Built for trainers who play offline.

About

Dexorium is an offline-first Pokemon Pokedex desktop app for players, collectors and competitive trainers. Native, fast and private: Tauri 2, Rust, Angular 20 and SQLite FTS5.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages