How to deploy a React Router app · Ample Computer
How to deploy a React Router app
Deploy a React Router app to Ample with your coding agent, the CLI or MCP, using build and start commands verified on November 6, 2026.
the short version
To deploy a React Router app on Ample, run ample deploy . --name <app-name> --public in the project directory, or ask your coding agent to deploy it to Ample. Ample builds it on the node-22 template, starts it with npm run start, and returns a public HTTPS URL.
Deploy React Router
- Ask your coding agent. Install the Ample CLI and create an account, then ask your agent: "Deploy this React Router app to Ample".
$ curl -fsSL https://get.ample.computer/install.sh | sh
$ ample auth signup
- Or deploy from the CLI. It waits until the app is live or failed and prints the URL.
$ ample deploy . --name <app-name> --public
Or use MCP. Call
ample_deployonhttps://api.ample.computer/mcp(orample mcpover stdio).Verify. On failure read
ample logs <deployment_id> --kind build, fix the cause and deploy again.
Tested configuration
| Template | node-22 |
| Install | npm install |
| Build | npm run build --if-present |
| Start | npm run start |
| Tested size | s-1vcpu-1gb |
React Router 7 framework mode: react-router build then react-router-serve ./build/server/index.js, which reads PORT. 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.
Last verification (2026-11-06): React Router 7 framework-mode app (react-router build, react-router-serve) deployed on node-22 and rendered the expected page.
You need
- A package.json with build and start scripts
- A server that listens on process.env.PORT and 0.0.0.0
- An Ample account token with servers:write
Know the limits
- Verified on the node-22 template at s-1vcpu-1gb.
- Tested with React Router 7 framework mode and Remix 2.
Frequently asked questions
Do I need a Dockerfile to deploy React Router?
No Dockerfile needed: Ample Computer detects React Router from the repository and builds it from source on the node-22 template.
How do I add a database to a React Router app?
Leave DATABASE_URL unset and deploy: when the code needs Postgres, MySQL, Redis, or MongoDB, Ample creates a managed database and passes its connection string to the app. See Connect Postgres for React Router.
What if the deploy fails?
ample deploy waits until the app is live or failed. A failure returns who must act, a diagnosis, and a suggested fix; read the logs with ample logs <deployment_id> --kind build.