Smart Deploy

<img src="public/icons/icon.svg" alt="Smart Deploy logo" width="96" height="96" /> Smart Deploy is a preview-driven deployment platform for solo developers. <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="Apache 2.0 license" /></a> <a href="https://github.com/anirudh-makuluri/smart-deploy/actions/workflows/ci.yml"><img src="https://github.com/anirudh-makuluri/smart-deploy/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI status" /></a> <a href="https://github.com/anirudh-makuluri/smart-deploy/issues"><img src="https://img.shields.io/github/issues/anirudh-makuluri/smart-deploy" alt="Open issues" /></a> <a href="https://github.com/anirudh-makuluri/smart-deploy/pulls"><img src="https://img.shields.io/github/issues-pr/anirudh-makuluri/smart-deploy" alt="Open pull requests" /></a> <a href="https://github.com/anirudh-makuluri/smart-deploy/commits/main"><img src="https://img.shields.io/github/last-commit/anirudh-makuluri/smart-deploy/main" alt="Last commit" /></a> Scan a repo, review a live blueprint of what will run, edit infrastructure files in context, and deploy only after the plan makes sense. Preview the deploy. Then ship it.

Highlights

What you get	Why it matters
Preview-first workflow	See services, routing, and artifacts before anything runs
Blueprint view	One place to understand build steps, containers, and traffic flow
Smart Analysis	Railpack build plans with optional build verification
Multi-target deploys	ECS Fargate for containers, S3 for static sites
Live deploy feedback	Stream logs, track run history, and watch health status update in place
Queued deploy execution	Each deploy runs as an isolated ECS task, ordered per service via SQS
Deployment Agent	Ask about your deployments, history, and runtime health

Workflow

Scan and define — Connect a repo and run Smart Analysis to resolve deploy units and target shape.
Preview — Open the blueprint, review the deployment path, and adjust config before anything runs.
Deploy — Start the deploy when the preview looks right, then follow live logs, run history, and health updates.

flowchart LR
  A[Repo scan] --> B[Blueprint preview]
  B --> C{Plan looks right?}
  C -->|Edit| B
  C -->|Yes| D[Deploy]
  D --> E[Logs and health]

Deploy targets

Target	Best for	What Smart Deploy provisions
ECS Fargate	Server apps, Railpack builds, existing Docker images	CodeBuild → ECR → Fargate task behind a shared ALB
Static sites	SPAs and static builds (no runtime)	CodeBuild → S3, optional CloudFront invalidation

Deployment execution

When you start a deploy, Smart Deploy enqueues the run and executes it on AWS — not on the WebSocket host.

flowchart LR
  UI[Dashboard] --> WS[WebSocket worker]
  WS --> SQS[SQS FIFO queue]
  SQS --> Lambda[Lambda handler]
  Lambda --> ECS[ECS Fargate task]
  ECS --> AWS[CodeBuild / ECR / ECS / S3]
  ECS -->|live logs| WS
  WS --> UI

The WebSocket worker records the run and sends a message to an SQS FIFO queue (one in-flight deploy per user/repo/service).
A Lambda function consumes the queue and launches a one-off ECS Fargate task (deployment-runner.js).
That task runs the pipeline (CodeBuild, ECR, ECS rollout, S3 sync, verification).
Live step logs stream back to the UI through the WebSocket worker via an HTTP event bridge.

Provision the queue, Lambda, and deployment worker task with infra/smart-deploy-platform and set DEPLOYMENT_QUEUE_URL in .env. Roll out worker and Lambda images with ./scripts/update.sh.

Documentation

User-facing guides for deploying and debugging your apps:

Documentation home — full index
Getting Started — first deployment
Debugging Deployments — production issues runbook
Deployment Agent — AI inspector for your deploys
FAQ · Error Catalog

Browse all docs in the app at /docs. For AI agents: /llms.txt and /llms-full.txt.

CLI beta

The Smart Deploy CLI currently supports browser-based account login and local project selection. Smart Analysis and deployment commands are still in development.

npx @arm8tron/smart-deploy@beta login

See the CLI guide for the available commands and local-development setup.

Tech stack

Next.js 16, React 19, TypeScript
Tailwind CSS 4, shadcn/ui
Better Auth, Supabase
GraphQL (Yoga) + REST API routes
WebSocket worker for real-time UI, Deployment Agent, and runtime health
SQS + Lambda + ECS Fargate for queued deployment execution
AWS SDK (SQS, Lambda, CodeBuild, ECR, ECS, ALB, Route 53, S3, CloudFront, Secrets Manager)
Railpack + Mise for container builds
Vitest, Playwright

License

Smart Deploy is licensed under the Apache License 2.0. See LICENSE.

Smart Deploy was created and is maintained by Anirudh Raghavendra Makuluri.

Forks and derivative projects should preserve the required license and attribution notices, and should not imply that they are the official Smart Deploy project unless explicitly authorized.

Repository docs

Rendered document