---
title: "Runtime and deployment contract"
description: "Look up build artifacts, start behavior, static/API paths, health, SQLite, and container entrypoint."
canonical: "https://sapporta.com/docs/reference/operations/runtime-and-deployment-contract/"
---

> Documentation index: https://sapporta.com/llms.txt

## Identity

Generated workspace scripts, API boot, Vite output, and Dockerfile.

## Contract

- `pnpm build` builds shared, docs when present, API, and frontend packages in
  project-defined order.
- The production API starts from `packages/api/dist/boot.js` and listens on
  `SAPPORTA_API_PORT`, falls back to hosting-platform `PORT`, and defaults to
  3000 when neither is set.
- API routes live under `/api`; the default production process also serves the
  built SPA and fallback routes.
- SQLite storage must live on durable writable storage and be backed up by the
  deployment platform.
- The generated container command migrates once, then starts the API process.
- Health access follows `SAPPORTA_HEALTH_POLICY`; shutdown closes HTTP, mail,
  and database resources.

## Related documentation

- [Production builds and deployment](/docs/guides/operations/production-builds-and-deployment.md)