Smart Deploy Documentation
User-facing guides for deploying and debugging apps on Smart Deploy. These docs focus on your deployments, not platform self-hosting.
Learn
| Guide | Summary |
|---|---|
| What is Smart Deploy | Why the platform exists and who it is for |
| How It Works | Scan → blueprint → deploy → monitor at a high level |
| Getting Started | Connect a repo and ship your first deployment |
| Glossary | Key terms used across the product |
Deploy
| Guide | Summary |
|---|---|
| Deployment Pipeline | Stages from clone to live URL (ECS and static S3) |
| Blueprint and Preview | Read and edit the deploy plan before you ship |
| Smart Analysis | Repo scan, deploy shapes, and build verification |
| Railpack | How apps are built, including Mise runtimes |
| Monorepos and Multi-Service | Multiple services per repo and package paths |
| Environment Variables | Build-time vs runtime configuration |
| Custom Domains | Deployment URLs, subdomains, DNS, and HTTPS |
Debug
| Guide | Summary |
|---|---|
| Debugging Deployments | Step-by-step runbook for failed or unhealthy deploys |
| Deployment Agent | AI inspector for status, history, and health |
| AI Assistance | When to use the agent, Analyze failure, and Improve scan |
| Deployment Logs | Live logs, history, and ECS CloudWatch |
| Health Checks | Post-deploy verification and app health endpoints |
| Runtime Health | Ongoing health signals and status meanings |
| Deployment History and Rollback | Past attempts and manual rollback |
| Build Failures | CodeBuild, Railpack, and Docker build errors |
| Startup and Runtime Failures | Crashes, ports, and 502/503 after deploy |
| Domain and TLS Issues | DNS propagation and certificate problems |
Reference
| Guide | Summary |
|---|---|
| FAQ | Common questions |
| Error Catalog | Symptom-first errors with checks and fixes |
| Deployment Status Reference | Status vocabulary, stages, and failure codes |
AI agents
- Index: /llms.txt
- Full snapshot: /llms-full.txt