Swansea Airport Website

Production-ready airfield website stack built with Astro, Directus, PostgreSQL, and Docker Compose.

Local setup

Copy .env.example to .env and fill in the values.
Start the stack with Docker Compose.
Point your external Caddy instance at the frontend and Directus ports defined in .env.

Services

Frontend: Astro dev server running in a bind-mounted container for live preview
CMS: Directus
Database: PostgreSQL
CMS bootstrap: one-shot schema initializer (directus-bootstrap)

Notes

All deploy-time variables live in .env.
PUBLIC_PPR_API_BASE controls the browser-side PPR API base URL; PPR and drone request endpoints are derived from it at build/dev-server startup.
DIRECTUS_HOMEPAGE_BANNER_FOLDER names the Directus file folder used for rotating homepage banner images. If the folder is missing or empty, the site falls back to /images/banner.png.
The frontend service bind-mounts the project into /app, keeps node_modules and .astro in named volumes, and serves the site with astro dev on the published frontend port.
Layout and page structure are controlled entirely by Astro.
Frontend source edits should appear without rebuilding the container image.
Cloudflare Pages deployment uses Direct Upload with Wrangler. See docs/cloudflare-pages.md for the test/prod URL workflow.

Cloudflare Pages deployment

Build static files with the test URL set:

npm run build:pages:test

Deploy the test build to the Cloudflare Pages test branch:

npm run deploy:pages:test

Deploy production with the production URL set:

npm run deploy:pages:prod

Copy .env.pages.test.example and .env.pages.prod.example before using these commands.

Programmatic Directus schema bootstrap

The schema bootstrap is automatic on docker compose up via the directus-bootstrap service. It creates collections, fields, and core tag relations idempotently.

If the frontend dependency graph changes, restart the frontend container to rerun npm install inside the container volume:

docker compose up --build -d web

You can still run the script manually if needed:

docker compose run --rm directus-bootstrap

The bootstrap script is idempotent, so reruns are safe.

Troubleshooting bootstrap permissions

If you see 403 FORBIDDEN during bootstrap:

Most commonly, the Directus database volume was initialized earlier with different admin credentials.
DIRECTUS_ADMIN_EMAIL and DIRECTUS_ADMIN_PASSWORD are only used when Directus initializes a new database.
For stable bootstrap auth across restarts, set DIRECTUS_ADMIN_TOKEN in .env and keep it constant.

To start from a clean Directus state (development only):

docker compose down -v
docker compose up -d

2.8 KiB Raw Blame History