Skip to main content

Getting started

Import a GitHub repository and deploy it to production.

Deploy an app from GitHub to production in a few minutes.

Before you begin

You need:

1. Import a repository

  1. Sign in at app.easel.sh and choose New project.
  2. If prompted, choose Connect GitHub and install the Easel GitHub App.
  3. Choose Import next to your repository.
The repository list for the acme GitHub account, with a search field, four repositories each with an Import button, and a link to adjust GitHub access

Easel lists the repositories its GitHub App can access

If your repository isn't listed, choose Adjust GitHub access.

2. Deploy

Easel detects your framework and build settings. Check two things, then choose Deploy:

  • Root directory. In a monorepo, pick the app's folder, such as apps/web.
  • Environment variables. Add any your app needs to build or run.
The Configure and deploy form for acme/acme-web on the main branch: workspace Acme, project name acme-web, framework Next.js, root directory ./, collapsed Build settings and Environment variables sections, and the Deploy button

Easel fills in the settings it detects from your repository

The branch you deploy becomes your Production branch. If the build fails, see Deployment troubleshooting.

3. Open your site

When the deployment is Ready, your app is live on the project's Production URL.

The deployment screen reading acme-web is live, with the URL acme-web-acme.preview.easelusercontent.com, the acme/acme-web repository on main, Deployed in 48s, and a Go to project button

The address under the heading is your Production URL

From now on, every push to the Production branch deploys to production automatically.

Next steps