Documentation

Lonch provides a seamless deployment experience for both Static Frontends (like React, Next.js, and Vue) and Dockerized Backends (like Node.js, Python, or Go).

To get started, navigate to your Dashboard, click New Project, and connect your GitHub repository. Once authenticated, you can select any repository and branch to deploy.

When you deploy a Static site, Lonch provisions a secure build container to fetch your code, install dependencies, and run your build command. The resulting output directory (e.g., dist or .next) is then automatically uploaded to our highly available S3 buckets and served instantly worldwide through our CDN.

Auto-Detection: Our build system automatically detects popular frameworks like Next.js, React, and Vite, pre-filling your build commands and output directories for you.

Backend deployments on Lonch leverage AWS Elastic Container Service (ECS) and AWS Fargate for serverless container execution.

• We automatically generate a Dockerfile for you if one isn't present in your repository.
• Your code is built into a container image and pushed securely to our private AWS Elastic Container Registry (ECR).
• A new ECS Fargate task is spun up, exposing your specified port. Our dynamic Application Load Balancer seamlessly routes traffic to your new container without any downtime.

You can configure Environment Variables during project creation or manage them later in your Project Settings.

For Static Sites (like Next.js), variables prefixed with NEXT_PUBLIC_ or VITE_are injected securely during the build time to be included in your static bundle.

For Backend Apps, variables are securely passed into your AWS ECS Fargate container at runtime, ensuring your sensitive API keys and secrets never leak into your build logs or container images.

Every project is assigned a free project-slug.lonch.cloud subdomain by default. To use your own domain, simply go to the Domains tab of your project and add it.

You will be provided with an A Record (IP Address) and a TXT Record to configure in your DNS provider (like Cloudflare, GoDaddy, or Route53). Once verified, our edge proxies automatically generate and renew SSL certificates for your domain.