How to deploy a React app without DevOps · Ample Computer

How to deploy a React app without DevOps

Deploy a React frontend by letting Ample detect whether it is a static Vite build or part of a server-rendered application.

The short version

You do not need to hand-configure a server to deploy a React app. Ample inspects the project, runs its production build, and publishes the result using the runtime the project needs. A Vite React app is usually a static deployment, while a Next.js or custom React server uses a Node runtime.

Who this is for

This guide is for React builders who can run the app locally but do not want to configure a VM, reverse proxy, certificate, and release process themselves.

How to do it

  1. Confirm the React project type. Check package.json and the framework config. Vite, Next.js, and custom Node servers have different production outputs even though they all use React.

  2. Run a production build locally. Use the project's existing build script. Fix missing imports, type errors, and required public environment variables before deploying.

    $ npm run build
    
  3. Let Ample plan the runtime. The plan records whether the app is static or needs Node, along with any linked API or database.

    $ ample plan --write
    
  4. Deploy. Apply the plan and wait for the public URL. The platform activates the release after its health check succeeds.

    $ ample up
    

What this supports

Know the limits

Common failure modes