Skip to main content

App playbooks

Examples by app shape. Each one shows the before/after diff for the input and explains every line.

For each playbook, the Reference section has a full skill file with the actual YAML. This page is an index — pick the playbook that matches your app and follow the link.

By app type

ShapePlaybook
nginx serving static HTML or an SPAplaybook-nginx-static
Node.js with hot reload (Vite, Next.js, nodemon)playbook-nodejs-dev
Generic web app + Postgresplaybook-postgres-app
Python web (FastAPI / Django / Flask)playbook-python-app
Rails (web + db + redis + jobs + websocket)playbook-rails-app
Wiki.jsplaybook-wikijs
WordPress + MariaDB / MySQLplaybook-wordpress
Multi-service with shared configplaybook-multi-service
Scheduled cron jobplaybook-cron-scheduled
Test runner on every push or PRplaybook-test-runner

How to use a playbook

  1. Find the closest match to what you're trying to launch.
  2. Read the before/after diff to see what changed.
  3. Adapt the variable names to your app — most playbooks ask for a subdomain, image tag, DB password, etc.
  4. Cross-check the relevant recipes at the end of each playbook for any extra patterns you need.
  5. Run a preview launch before publishing.

If none of the playbooks match exactly, find the closest one and combine it with recipes for the differences. Most real-world templates are 80% one playbook + 20% recipes.