A fast, fully offline PokΓ©mon desktop encyclopedia for players, collectors and competitive trainers.
Why Dexorium Β· Features Β· Tech stack Β· Architecture Β· Getting started Β· Roadmap Β· Contributing
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.
| 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.
- 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
- 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
- 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)
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.dbis read-only and replaced on dataset upgrades. Favourites and future user data live in a separateuser.db, which survives upgrades.
| 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 |
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
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.
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
- 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
git clone https://github.com/Martzcode/Dexorium.git
cd Dexorium
npm installnpm run startUseful 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.
npm run desktop:devThe 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-resourceThe 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.
npm run desktop:buildThe installer is written to src-tauri/target/release/bundle/ (MSI/NSIS on Windows, DMG on macOS, deb/rpm/AppImage on Linux).
Releases are automated on every push to main, once the CI workflow succeeds:
- version and tag:
YYYY.MM.XX, withXXstarting at01each month (for examplev2026.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),.deband.rpm. Dataset reports, checksums and the reference database are kept as workflow artifacts instead.
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.
| 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 |
| 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.
| 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.
- 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.
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.
If Dexorium is useful to you, star the repository; it helps the project reach other players and trainers.
AGPL-3.0-or-later Β© 2026 Martzcode
Built for trainers who play offline.