No description
  • C 43.8%
  • TypeScript 30.6%
  • C# 9.9%
  • Python 8.6%
  • CSS 5.2%
  • Other 1.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
DPRsLegacy 233cf8587c small test
small test
2026-10-16 23:59:35 -04:00
clients Prioritize foreground HTTP over background art 2026-08-23 00:22:50 -04:00
deploy it works but small fix 2026-08-25 20:52:22 -04:00
server add egg 2026-08-25 21:51:56 -04:00
shared Add Switch UI and sprite cache pipeline 2026-08-22 23:23:29 -04:00
tests changed webserver to next.js 2026-08-25 20:35:58 -04:00
web add egg 2026-08-25 21:51:56 -04:00
.dockerignore changed webserver to next.js 2026-08-25 20:35:58 -04:00
.env.example changed webserver to next.js 2026-08-25 20:35:58 -04:00
.gitattributes first commit 2026-08-19 21:28:27 -04:00
.gitignore Add Switch UI and sprite cache pipeline 2026-08-22 23:23:29 -04:00
docker-compose.yml try 3 2026-08-25 20:46:35 -04:00
Dockerfile try 3 2026-08-25 20:46:35 -04:00
Dockerfile.pkhex changed webserver to next.js 2026-08-25 20:35:58 -04:00
install-devkitpro-pacman added many things 2026-08-19 23:41:44 -04:00
LICENSE second commit 2026-08-19 21:34:07 -04:00
Pockettransfer.slnx second commit 2026-08-19 21:34:07 -04:00
Program.cs Assign fake HOME tracker on PKM convert 2026-08-23 00:45:53 -04:00
README.md small test 2026-10-16 23:59:35 -04:00

Pockettransfer

A Self-hostable (I don't wish that upon you) Pokémon Bank / HOME-style storage for modded 3DS and Switch. A Next.js app owns the web UI, cookies, and console HTTP API. A private C# sidecar runs PKHeX.Core for save writes and legality. Banked Pokémon live in PostgreSQL.

My Site pockettransfer.net

Server: Proxmox Docker LXC + Nginx Proxy Manager

  1. Pockettransfer runs in the Docker LXC (./deploy/proxmox/up.sh → port 8080). Compose starts Postgres, the PKHeX sidecar (internal only), and the Next.js web app.
  2. Nginx Proxy Manager terminates HTTPS for https://your-website.com and proxies to the LXC.
Component Guide
Docker LXC deploy deploy/proxmox/README.md
NPM + your-website.com deploy/nginx-proxy-manager.md

Do not use docker compose --profile tls when NPM handles certificates.

Console config.json example: deploy/config.example.json

Health (on LXC): curl http://127.0.0.1:8080/health

After upgrading from the old ASP.NET cookie app, log in again in the browser. Paired consoles keep their device tokens.

Local dev (Postgres + Next.js + PKHeX sidecar)

cp .env.example .env          # set POSTGRES\_PASSWORD
docker compose up -d postgres
export PATH="$HOME/.dotnet:$PATH"
dotnet run --project server   # PKHeX sidecar on :8081

cd web
cp .env.example .env          # DATABASE\_URL + PKHEX\_URL
npm install
npx prisma db push
npm run dev                   # http://localhost:3000

Web UI

Open your NPM URL in a browser on PC or phone:

  1. Register with a username and password (3–32 chars, lowercase letters, numbers, underscore).
  2. Log in → My Bank to browse boxes, search Pokémon, and view PKHeX legality reports.
  3. Devices to pair 3DS/Switch · Saves to upload a save file from the browser.

The oldest account is an admin. Admins see Admin in the nav: manage users, inspect boxes, reset passwords, revoke devices. Set PT\_ADMIN\_USERNAMES (comma-separated) to always grant those usernames admin on startup.

Console clients

CFW required. First launch: create an account or log in with the console keyboard — the app stores the device token itself.

  • 3DS: clients/3ds (PKSM-style dual-screen UI)
  • Switch: clients/switch (Pokémon HOME-style 720p UI; high-res art from GET /sprites/home/{key}.png on this host)

Title IDs: shared/GAMES.md · TLS: shared/tls.md

License

The PKHeX sidecar uses PKHeX.Core (GPL-3.0-or-later). See LICENSE.

Small Test