Hosting docs.diasantos.com

This documentation is built with MkDocs (Material theme). Output is static HTML under apps/docs/site/ after mkdocs build. With i18n, English is at / and Portuguese at /pt/ under the same site/ tree — nginx root stays apps/docs/site.

Same server as the app

Typical layout:

Path	Purpose
App clone	e.g. /var/www/coaching — Next.js + pm2
Docs build	e.g. /var/www/coaching/apps/docs/site — nginx root

Build after git pull

Either run manually or add a small script / CI step:

cd /var/www/coaching/apps/docs
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
mkdocs build

Nginx

Use the full example (HTTP→HTTPS, TLS paths, optional asset cache) in Nginx — Coaching app and documentation and copy the template from apps/docs/examples/nginx/docs.diasantos.com.conf.example on the server.

Obtain certificates with certbot (or your usual ACME workflow) for docs.diasantos.com.

Optional: separate deploy

You can rsync only apps/docs/site/ to a static host or CDN if you prefer not to serve docs from the application server.

Admin Deploy (MkDocs)

The same Deploy page that runs git pull and npm run build --workspace @coach-studio/web also runs apps/docs/build-from-deploy.sh. That script creates/updates apps/docs/.venv and then runs mkdocs build. See Deploy user permissions for what the coaching Unix user must be allowed to do.