StageX documentation

This repository contains the source for the StageX documentation site.

StageX is a minimal, fully bootstrapped, deterministic, multi-party-signed Linux distribution for verifiable infrastructure.

The site is built with Zensical.

Repository layout

• docs/ contains published documentation pages.
• overrides/ contains Zensical theme overrides.
• zensical.toml contains the site configuration.

Development

Prerequisites

• Docker

Run locally

make dev

The site will be available at http://localhost:5000. Changes to docs/, overrides/, and zensical.toml are mounted as volumes and will be reflected automatically.

Make commands

# Build the local development image
make build

# Start the local development server
make dev

# Stop the local development server
make down

# Build the production image
make build-prod

# Build the static site into _site/
make _site

# Remove generated local artifacts
make clean

# Remove generated artifacts and local Docker images
make fullclean