How to deploy React to AWS

Deploy a React single-page application to S3 and deliver it through CloudFront.

Prerequisites

A Git repository containing your application and its production build command.
A Ravion account with your AWS account connected. Start free at Ravion signup.
The Ravion CLI installed and authenticated. See CLI installation.

The examples use my-org/my-app as a placeholder. Replace it with your repository before applying the config.

Set up this React app for Ravion static hosting.

Configure the deployment

Vite projects write to dist; Create React App projects write to build. This example uses Railpack for the build. Use build_source: dockerfile instead when you need a custom Dockerfile. This example deploys a Vite React app.

ravion.yaml

project:
  givenId: react-site
  name: React site
environments:
  - givenId: production
    name: Production
    moduleInstances:
      - givenId: static-site
        name: React site
        type: rvn-aws-static
        version: 1.0.0
        input:
          aws_account_id: ravion-prod
          aws_region: us-east-1
          name: react-site-production
          build_source: railpack
          source_repo: my-org/my-react-app
          railpack_build_cmd: npm run build

For Create React App, add output_directory: build to the module input. The default spa routing mode serves index.html for client-side routes.

Apply and connect your domain

ravion project create --given-id react-site --name "React site"
ravion project config apply react-site --file ravion.yaml --dry-run
ravion project config apply react-site --file ravion.yaml

Follow custom domains to connect your domain to CloudFront.

Next steps

Custom domains

Point a domain at your deployed service and manage its certificate.

Project config

Preview and apply Ravion configuration from source control.

Pipelines

Add approvals, migrations, and deployment automation.

Logs and metrics

Inspect deploy output and production health in Ravion.

⌘I

​Prerequisites

​Configure the deployment

​Apply and connect your domain

​Next steps