[Stagex] Website

Setting up

This site needs three resources to build:

• GNU Make
• Docker
• git (to clone recursively - don't use an archive!)

Note

Make sure to clone the repo with --recursive!

Running make dev will produce a locally available dev container based on images provided by [Stagex].

You can run make dev-server which will run make dev to build the dev image first, then run the astro dev server in it, exposing the appropriate port.

You can run make dev-shell to drop into a shell of a container based on the dev image

git clone https://codeberg.org/stagex/website.git --recursive
cd website
make dev
make dev-server # Happy dev time!

Updating stagex digests

To update the digests and build the latest version of the site:

git -C stagex switch --detach <release>
git add stagex
git commit -m "Bump website to release <release>"
git push
make APP_ENV=production dist

To upload the latest version of the site:

# Assume we have a `website` and a `pages` repository.
rsync -vr --delete website/dist/* pages/
git -C pages add .
git -C pages commit -m "Bump pages to release 2026010"
git -C pages push