How to deploy SvelteKit to AWS

Deploy a SvelteKit static site with S3 and CloudFront or a Node server on ECS Fargate behind an Application Load Balancer through Ravion.

Deploy SvelteKit as a prerendered static site on S3 and CloudFront, or as a Node server on ECS Fargate behind an Application Load Balancer.

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 SvelteKit app for Ravion static or server hosting.

CopiedCopy promptOpen in Cursor

Configure the deployment

Choose adapter-static for a prerendered site on S3 and CloudFront, or adapter-node for a Node server on ECS Fargate behind an Application Load Balancer.

This example uses Railpack for the build. Use build_source: dockerfile instead when you need a custom Dockerfile.

Install @sveltejs/adapter-static, prerender the routes you need, and keep the adapter output in build.

ravion.yaml

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

Node adapter

Install @sveltejs/adapter-node. npm run build writes a standalone server to build, and node build starts it on port 3000.

ravion.yaml

project:
  givenId: sveltekit-app
  name: SvelteKit app
environments:
  - givenId: production
    name: Production
    moduleInstances:
      - givenId: network
        name: Network
        type: rvn-aws-network
        version: 1.0.0
        input:
          aws_account_id: ravion-prod
          aws_region: us-east-1
          name: sveltekit-production
      - givenId: cluster
        name: ECS cluster
        type: rvn-ecs-cluster
        version: 1.0.0
        input:
          network:
            moduleGivenIdRef: network
          name: sveltekit-production
      - givenId: web
        name: SvelteKit web service
        type: rvn-ecs-web
        version: 1.0.0
        input:
          cluster:
            moduleGivenIdRef: cluster
          name: sveltekit-production-web
          build_source: railpack
          source_repo: my-org/my-sveltekit-app
          railpack_build_cmd: npm run build
          railpack_start_cmd: node build
          container_port: 3000
          fargate_size:
            vcpu: 0.5
            memory_gb: 1

The Node adapter reads PORT and HOST environment variables. Bind to 0.0.0.0 in ECS.

Apply and connect your domain

Apply the matching config, then follow custom domains for CloudFront or the Application Load Balancer.

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.