Repository navigation
Build
github-actions[bot] edited this page Nov 22, 2026
·
4 revisions
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.
- The app contract: the environment, the database, migrations, the paths Spotcraft serves for the app, its users and its analytics.
-
Develop locally:
spotcraft devruns the same database, user pool and email on your machine, and fills in.env. - 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.
Published from docs/. Edit the files there; changes here are overwritten.