Configure build and start for Astro · Ample Computer

Configure build and start for Astro

Configure build and start for a Astro app on Ample. A server-output Astro app runs its start script; a static build is published as a static site. Ample detects the runtime, installs dependencies, runs the build when present and starts the app on the node-22 template behind a public HTTPS URL.

What it runs on

You need

Exact tested configuration

build

npm run build --if-present

install

npm install

runtime

node

sizes

start

npm run start

template

Steps

  1. Make the start command bind correctly. A server-output Astro app runs its start script; a static build is published as a static site.

  2. Deploy. Run the existing synchronous deploy once from the project directory and read the result. Exit 0 is live, 1 is failed, 2 needs an answer first (a preflight question). Re-running with no change is a content-addressed no-op.

   $ ample deploy . --name <app-name> --public --format json
  1. Verify. Fetch the live URL and run the success checks below. On failure read the build log, then the runtime log, fix the cause and deploy again; do not blind-retry.
   $ ample logs <deployment_id> --kind build

How it was checked

✓ page or root route responds · http get/ → “ample canary astro basic”

Evidence

  1. November 5, 2026 · canary run
    Astro app built and started on node-22 and rendered the expected page.

  2. November 6, 2026 · canary run
    Astro static build output published as a static site.

Tested examples

What it doesn’t cover