Skip to content
github-actions[bot] edited this page Nov 22, 2026 · 4 revisions

Build apps

For the developers of the apps that run on Spotcraft: what an app gets from it, what it must do, and how to work on it locally and ship it from CI. An app is a Docker image that answers HTTP on one port; it can be written in anything.

Starting from nothing? spotcraft new my-app copies Kodentuzo's starter: a private, local-first app with all of the below already wired.

  1. The app contract: the environment, the database, migrations, the paths Spotcraft serves for the app, its users and its analytics.
  2. Develop locally: spotcraft dev runs the same database, user pool and email on your machine, and fills in .env.
  3. Deploy from CI: deploy each new image from the app's own workflow and wait until it is live.

A site that is only files ships an image with them in /site: see Static sites.

Running the server? Run Spotcraft covers setting it up and the dashboard.

Clone this wiki locally