On this page

Defined in cli/commands/run.ts, delegating to cli/commands/sst/run.ts. Three subcommands: two for the AWS-bound personal stage, one for the fully-local Docker stack.

ds run backend#

Starts the backend: an SST live-lambda dev session against the Hono API.

ds run backend

Runs, in order: pnpm install, then deleteOrphanStacks() (cleans up orphaned CloudFormation stacks left behind by earlier sst.config.ts changes), then pnpm exec sst dev.

It refuses to start when a pool checkout is already running against the same stage through ds pool cloud — two sst dev sessions on one stage take each other's requests. Unbind that checkout first with ds pool cloud <checkout> --off.

No Docker required

ds run backend does not start Docker or any local services. In normal (non-test) code, DynamoDB access always points at real AWS — local Docker DynamoDB is only used when NODE_ENV=test, and only the backend test suite spins those containers up (in its own setup code, independent of ds run backend). Docker is not part of the everyday local-dev loop.

ds run ui#

Starts the Vite frontend dev server.

ds run ui

Spawns pnpm run dev inside frontend/, injecting VITE_* environment variables derived from the bound stage (API/auth/media/importer root URLs, Pusher key/cluster, Stripe public key, GitHub app name, Giphy key, SMTP settings, plugin host allowlist, etc.). The dev server is pinned to VITE_DEV_SERVER_PORT (default 8080) so it cannot silently move off the origin registered with Cognito and API CORS.

ds run local#

ds run local [--rebuild]

Brings up the fully-local, no-AWS Docker stack: the shared core (Postgres, DynamoDB, MinIO, cognito-local) plus the primary main instance, in the foreground. It skips the SSO gate and the stage bind entirely. --rebuild rebuilds the shared devstride-local image first (after a dependency change). Everything else about this stack is on Dockerized Worktree Development.


Powered by DevStride