History

mithral b82090ed29 Phase 7: games — ROM scanning, platforms, cloud saves, EmulatorJS The RomM replacement. - registry: a games media type with ~35 ROM extensions across NES, SNES, GB/GBA, N64, NDS, Genesis/Master System/Game Gear, PC Engine, Neo Geo Pocket, WonderSwan, Atari, Coleco, Intellivision, and PlayStation. - games: platform detection from the file extension, mapping each to an EmulatorJS core. Platforms with no browser core are recognised but marked not-playable so the UI offers a download instead of a broken player. - migration 0005: game_saves keyed by (user, item, slot). Save states are user data, not media — two people playing the same ROM keep their own progress. - save endpoints with a 16 MiB cap and a validated slot name; the upload is read through a LimitReader so an unbounded body is refused rather than buffered. - igdb provider: Twitch client-credentials flow with the token cached for its ~2 month lifetime, Apicalypse query body, and cover URLs normalised from protocol-relative t_thumb to https t_cover_big. - searchTitle: strips "(USA)", "[!]", "(Rev 1)" and similar release tags before searching. "Sonic the Hedgehog (USA)" matched nothing; "Sonic the Hedgehog" matches immediately. Stored titles keep the original. - web: GamePlayer embeds EmulatorJS and adds Load/Save-to-server buttons. Verified live against IGDB: Sonic matched (id 316900) with real cover art; a 4 KB save uploaded, listed, downloaded byte-identical, and deleted.		2026-10-09 21:54:49 -04:00
..
src	Phase 7: games — ROM scanning, platforms, cloud saves, EmulatorJS	2026-10-09 21:54:49 -04:00
.gitignore	Web UI: Svelte app, embedded into the binary	2026-10-09 16:40:58 -04:00
embed.go	Web UI: Svelte app, embedded into the binary	2026-10-09 16:40:58 -04:00
index.html	Web UI: Svelte app, embedded into the binary	2026-10-09 16:40:58 -04:00
package.json	PDF reading via pdf.js	2026-10-09 21:43:43 -04:00
pnpm-lock.yaml	PDF reading via pdf.js	2026-10-09 21:43:43 -04:00
pnpm-workspace.yaml	Web UI: Svelte app, embedded into the binary	2026-10-09 16:40:58 -04:00
README.md	Web UI: Svelte app, embedded into the binary	2026-10-09 16:40:58 -04:00
svelte.config.js	Web UI: Svelte app, embedded into the binary	2026-10-09 16:40:58 -04:00
tsconfig.json	Web UI: Svelte app, embedded into the binary	2026-10-09 16:40:58 -04:00
vite.config.ts	Web UI: Svelte app, embedded into the binary	2026-10-09 16:40:58 -04:00

README.md

Vellum web

Svelte 5 + Vite + TypeScript single-page app. It is built to a static bundle in dist/ and embedded into the Go binary, so all asset paths are relative (base: './' in vite.config.ts).

Commands

pnpm install
pnpm dev      # dev server on :5173, proxying /api to :7788
pnpm build    # writes dist/
pnpm check    # svelte-check

Run the Go server on :7788 (make run from the repo root) and pnpm dev proxies API and health requests to it, so cookies and sessions behave exactly as they will in production.

Layout

src/
  main.ts                 entry point
  App.svelte              login gate -> shell
  app.css                 design tokens and base styles
  lib/
    api.ts                typed client; mirrors the Go handlers
    session.ts            auth + library stores
    nav.ts                view state
    components/
      Login.svelte
      Shell.svelte        nav + view switch
      Libraries.svelte    library list, create, scan, delete
      LibraryView.svelte  item grid with covers
      Reader.svelte       epub.js reader with progress sync
      Users.svelte        admin user management

The reader resumes from a spine index, which is why progress positions are integers: it round-trips through the polymorphic progress table without needing a text column.