Catalyst

Instance registry for tracking infrastructure. Built as a single-page app — no backend, no framework.

Stack

• sql.js — SQLite compiled to WebAssembly, runs entirely in the browser
• localStorage — persists the database between sessions
• nginx — serves the static files (via Docker)

Structure

index.html          Entry point
css/app.css         All styles
js/
  config.js         Service definitions and seed data
  db.js             Database layer (init, queries, mutations, persistence)
  ui.js             Rendering, modals, toast notifications
  app.js            Router and bootstrap
Dockerfile          nginx:alpine image
nginx.conf          SPA routing config (used by Dockerfile)

Running locally

Requires a local HTTP server — history.pushState routing won't work over file://.

npx serve . --single

Then open http://localhost:3000.

Building

Push to main. Gitea Actions builds and pushes two image tags to your registry:

Tag	Use
:latest	Always the current main
:<sha>	Pinned to a specific commit (use for rollbacks)

Requires two things set in Gitea repository settings:

Key	Type	Value
REGISTRY_HOST	Variable	your Gitea hostname
GITEA_TOKEN	Secret	token with package:write scope

Running the container

docker run -d -p 3000:80 <registry>/catalyst:latest