Skip to content

StickerDex v0.1.0

Latest
Latest

Choose a tag to compare

View all tags
@ChristianAbele02 ChristianAbele02 released this 23 Jun 16:27
v0.1.0
7b6158b

StickerDex v0.1.0 — Standalone Windows app 🎉

The first packaged release of StickerDex, your World Cup 2026 sticker-album companion. This release turns StickerDex into a standalone Windows desktop app — no Docker, no terminal, no localhost juggling — while keeping everything that makes it a full tournament companion.

⬇️ Download & install

File | Use it for -- | -- StickerDex-Setup-0.1.0.exe | Normal install — a per-user installer (no admin rights), adds Start-menu & desktop shortcuts. StickerDex-0.1.0-portable.exe | No-install — run it from anywhere (USB stick, Downloads folder).

Your data lives in %APPDATA%\StickerDex (collection DB + backups), separate from the program and never touched by upgrades or uninstall. Open it any time from File ▸ Open data folder.

⚠️ SmartScreen note: these builds are currently unsigned, so Windows may show "Windows protected your PC." Click More info ▸ Run anyway. (CI signs automatically once a code-signing certificate is configured.)

🖥️ What's inside

Standalone desktop app (new)

  • A hardened Chromium window wrapping the same Fastify backend, embedded in-process and bound to 127.0.0.1 on a random port. The React UI is served from that origin — single-origin, no CORS, no setup.
  • Security-hardened shell: contextIsolation + sandbox on, nodeIntegration off, strict CSP, navigation pinned to loopback (external links open in your real browser), single-instance lock, minimal read-only preload bridge, and a random per-install cookie-signing secret.

The full album & tournament companion

  • 📒 Real WC2026 album — the 48 actual qualifiers in their true groups, correct player↔sticker-number alignment from the real Panini checklist, real squads (shirt number, club, caps, goals), authentic SVG national flags, foil shimmer, duplicates/swap tracking, and CSV/JSON export.
  • 📊 Smart stats — live completion (overall + per team) and a coupon-collector pack estimate (best-case, expected, and 90%-confidence packs to finish).
  • ⚽ Live results — scores auto-refresh at startup from the public openfootball dataset (CC0); your manually entered scores are never overwritten. Standings, Elo predictions and the simulator all update live.
  • 🔮 Predict — a Monte Carlo forecaster (Elo → Poisson goals → thousands of full simulated tournaments) giving each team's odds to advance, reach each round, and win the cup. ~10k runs in under a second.
  • 🌍 Teams hub — all 48 nations with squad dashboards, group standings, next fixture, and inline-collectable player cards.
  • ⚙️ Settings & backups — automatic startup backups (never auto-deleted), back up / restore / download / import / export, appearance, stickers-per-pack, default simulation count, and favorite team.

🛟 Plan B — still fully self-hostable

The desktop app is purely additive. Everything still runs the classic way:

  • npm run dev — API + Vite dev servers
  • docker compose up — nginx-served SPA + API container with a persistent SQLite volume

All desktop-related backend changes are env-gated (STICKERDEX_DATA_DIR, STICKERDEX_PUBLIC_DIR) and are no-ops when unset.

✅ Verified

Lint clean · 39 tests passing (31 backend + 8 frontend) · desktop typecheck clean · icon embedded in the exe, installer and portable.

📚 Docs

  • docs/DESKTOP.md — architecture, security model, build-from-source, troubleshooting & code-signing
  • docs/DESKTOP_BUILD_LOG.md — every build step + debugging

🤖 Desktop packaging & icon assisted by Claude Code. See AI_USAGE.md.

StickerDex v0.1.0 — Standalone Windows app 🎉 The first packaged release of StickerDex, your World Cup 2026 sticker-album companion. This release turns StickerDex into a standalone Windows desktop app — no Docker, no terminal, no localhost juggling — while keeping everything that makes it a full tournament companion.

⬇️ Download & install
File Use it for
StickerDex-Setup-0.1.0.exe Normal install — a per-user installer (no admin rights), adds Start-menu & desktop shortcuts.
StickerDex-0.1.0-portable.exe No-install — run it from anywhere (USB stick, Downloads folder).
Your data lives in %APPDATA%\StickerDex (collection DB + backups), separate from the program and never touched by upgrades or uninstall. Open it any time from File ▸ Open data folder.

⚠️ SmartScreen note: these builds are currently unsigned, so Windows may show "Windows protected your PC." Click More info ▸ Run anyway. (CI signs automatically once a code-signing certificate is configured.)

🖥️ What's inside
Standalone desktop app (new)

A hardened Chromium window wrapping the same Fastify backend, embedded in-process and bound to 127.0.0.1 on a random port. The React UI is served from that origin — single-origin, no CORS, no setup.
Security-hardened shell: contextIsolation + sandbox on, nodeIntegration off, strict CSP, navigation pinned to loopback (external links open in your real browser), single-instance lock, minimal read-only preload bridge, and a random per-install cookie-signing secret.
The full album & tournament companion

📒 Real WC2026 album — the 48 actual qualifiers in their true groups, correct player↔sticker-number alignment from the real Panini checklist, real squads (shirt number, club, caps, goals), authentic SVG national flags, foil shimmer, duplicates/swap tracking, and CSV/JSON export.
📊 Smart stats — live completion (overall + per team) and a coupon-collector pack estimate (best-case, expected, and 90%-confidence packs to finish).
⚽ Live results — scores auto-refresh at startup from the public openfootball dataset (CC0); your manually entered scores are never overwritten. Standings, Elo predictions and the simulator all update live.
🔮 Predict — a Monte Carlo forecaster (Elo → Poisson goals → thousands of full simulated tournaments) giving each team's odds to advance, reach each round, and win the cup. ~10k runs in under a second.
🌍 Teams hub — all 48 nations with squad dashboards, group standings, next fixture, and inline-collectable player cards.
⚙️ Settings & backups — automatic startup backups (never auto-deleted), back up / restore / download / import / export, appearance, stickers-per-pack, default simulation count, and favorite team.
🛟 Plan B — still fully self-hostable
The desktop app is purely additive. Everything still runs the classic way:

npm run dev — API + Vite dev servers
docker compose up — nginx-served SPA + API container with a persistent SQLite volume
All desktop-related backend changes are env-gated (STICKERDEX_DATA_DIR, STICKERDEX_PUBLIC_DIR) and are no-ops when unset.

✅ Verified
Lint clean · 39 tests passing (31 backend + 8 frontend) · desktop typecheck clean · icon embedded in the exe, installer and portable.

📚 Docs
docs/DESKTOP.md — architecture, security model, build-from-source, troubleshooting & code-signing
docs/DESKTOP_BUILD_LOG.md — every build step + debugging
🤖 Desktop packaging & icon assisted by Claude Code. See AI_USAGE.md.

Assets 5
Loading