Skip to content

Decisions

github-actions[bot] edited this page Nov 22, 2026 · 8 revisions

Decisions

Architecture decision records, numbered in order. A changed decision gets a new record that supersedes the old one; old records are never rewritten.

# Decision Status
0001 Apps and ops on two servers superseded by 0026
0002 A small agent deploys apps accepted
0003 VictoriaMetrics and VictoriaLogs accepted
0004 Generic VPS bootstrap, optional Hetzner accepted, partly superseded by 0026
0005 One pnpm monorepo: SvelteKit and Fastify accepted
0006 Shared UI package with shadcn-svelte accepted, partly superseded by 0033
0007 App state lives on the apps server; agent API accepted
0008 Dashboard login with one admin password accepted, partly superseded by 0023
0009 Multi-arch images on Docker Hub, built by CI accepted, partly superseded by 0025, 0042
0010 Hetzner ARM servers, deploy user only, one first-boot template accepted, partly superseded by 0026
0011 Spotcraft deploys itself with a manual GitHub workflow over SSH accepted, partly superseded by 0026
0012 Hardening from the v0.1.0 audit accepted
0013 One Semantic Version for the whole project superseded by 0019
0014 The website is static and hosted on Spotcraft itself superseded by 0024, 0044
0015 One Postgres on the apps server, a database per app superseded by 0034
0016 A server-only backend kit, starting with guest accounts superseded by 0035
0017 A local stack that matches the server superseded by 0037
0018 The dashboard lists and deletes an app's users superseded by 0035
0019 One version for the project, including its npm packages accepted, partly superseded by 0027, 0051
0021 Apps get a default subdomain; Cloudflare can sit in front accepted, partly superseded by 0022 and 0023
0022 Taking over a custom domain's DNS records is an app setting accepted
0023 A Cloudflare Access sign-in also signs in to the dashboard accepted
0024 The website is plain Astro, published on GitHub Pages superseded by 0033, 0041, 0042, 0044
0025 One image runs the agent and the dashboard as two containers accepted
0026 Spotcraft runs on one server accepted
0027 The kit has its own version superseded by 0036
0028 Deploys start the new version next to the old one accepted
0029 An app's CI deploys a new tag through a deploy hook accepted
0030 Nightly dumps of every app to a bucket, and Hetzner backups of the server accepted, partly superseded by 0034
0031 The kit holds the server glue every app repeated superseded by 0036
0032 An older app starts on a database a newer one migrated accepted
0033 The theme and plain-CSS components come from spotstrap superseded by 0041
0034 Every app gets the same small contract, with no switches accepted, partly superseded by 0051
0035 Each instance runs one user pool, starting with guests accepted, partly superseded by 0051
0036 The kit becomes spotkit, outside this repository accepted, partly superseded by 0051
0037 Each repository gets its own local stack accepted
0038 Every app gets usage numbers, collected by the platform with Umami accepted, partly superseded by 0040, 0043, 0050
0039 Deploys are recorded, and the dashboard fetches app icons accepted
0040 The dashboard lists which users use an app accepted
0041 All UI is shadcn-svelte, with its own theme accepted
0042 One long-lived branch, main; a tag is a release accepted, partly superseded by 0051
0043 Apps own their UI; Spotcraft offers services, Spotstrap blocks accepted
0044 Spotcraft's web pages are a section of kodentuzo.com, and docs/ is the wiki accepted
0045 The agent's API is the one way into an instance accepted
0046 Apps send mail through the instance's relay, to one provider accepted
0047 Spotcraft ships a bundle per release and deploys nothing; kodentuzo/hetzner runs it accepted
0048 whoami, a test app for instances, lives in its own repository accepted
0049 The user pool is a contract in our own terms; Spotpass is its reference implementation accepted
0050 Analytics is our own contract; Spotless collects, Umami stores accepted
0051 The kit and apps with their own database are retired accepted
0052 Static sites are files-only images; redirects are an instance setting accepted

Clone this wiki locally