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:
- An Easel account (sign up free)
- A GitHub repository using a supported framework
1. Import a repository
- Sign in at app.easel.sh and choose New project.
- If prompted, choose Connect GitHub and install the Easel GitHub App.
- Choose Import next to your repository.


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.


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 address under the heading is your Production URL
From now on, every push to the Production branch deploys to production automatically.