Random-access how-tos for single problems. Pick the one whose title matches what you're trying to do — each recipe is self-contained.
The learn/ ladder teaches you asd in sequence. The cookbook is for
when you already know the basics and have a specific problem. Each
page is a single scenario in the same six-block format
(SETUP → RECIPE → RESULT → WHY IT WORKS → WHAT'S NEXT), minus the
PREREQ box.
| Recipe | When you'd reach for it |
|---|---|
| Tunnel a dev server (Vite / Next / React) | "I want my dev server reachable from my phone, with HMR working." |
| Self-signed HTTPS for local-only services | "Corporate network, no public DNS — but I still need HTTPS in the browser." |
| Share via a public URL (for 30 minutes) | "I'm presenting in 30 minutes; I just need to share my laptop's app." |
| Put an API behind SSO | "I have an internal admin API; protect it with our OIDC provider, no auth code." |
| Debug a broken route | "My route returns 502 / 404 / hangs and I don't know which layer is wrong." |
| Migrate from Traefik | "I have a Traefik setup; show me the equivalent asd manifest side by side." |
| CI/CD with asd | "Deploy from CI without downtime, with a clean rollback." |
The cookbook grows as common questions land in the issue tracker.
If your problem isn't here, check:
learn/ ladder — the concept might be covered as a rung.reference/ pages — for "what does this field do?".asd help and asd actions — for "what command should I use?".If none of those answer your question, that's a missing recipe.
File an issue or PR against the docs.