Deploy From A Blueprint

Now that you have chosen a blueprint, you can clone it in GitHub and deploy it to Atlas. Pushing to your main branch in GitHub will then deploy updates to Atlas automatically.

Atlas blueprints use the Faust.js framework based on Next.js. Atlas also supports other frameworks that run on Node.js.

Connect your GitHub account so you can clone Atlas blueprints.

  1. Under Connect to GitHub, select Connect.

  2. GitHub opens in another tab of your web browser. Give WP Engine permission to access your repositories.

After Atlas connects to your GitHub account, the Connect button indicates that you are Connected.

Connected to GitHub

Now that GitHub is connected, it's time to create a repository where your Blueprint code is going to be stored.

  1. Select your GitHub account

Use the dropdown list or start typing to filter available GitHub accounts.

Select your GitHub account

If you don't see the account for which you'd like to create a repository on the list, click on "Manage GitHub app" on the top of the screen: Connected to GitHub

  1. Name your repository

Depending on which Blueprint you chose, Atlas will suggest a repository name for you. The name of your repository should be unique within your GitHub account - If it's not, you'll see an error after clicking the "Create" button on the bottom of the page.

  1. Select the visibility of your repository

If you want to limit your repository's visibility to only people that can access your GitHub account, make sure to check the "Private repository" checkbox.

  1. Select a region for your Atlas app. The region you select will be used for all of your app's environments (production/staging/etc.) and cannot be changed once your Atlas application has been deployed.

Select your app's region

  1. Click Create App.

That's it! Track the initial build progress on the next screen that loads automatically.

A link to visit your live frontend using a temporary domain will appear under Atlas URL when the deploy completes.

Links to the frontend site and WordPress portal page

To log in to the WordPress site linked to your Atlas app:

  1. Click the link below the Linked WordPress environment title on your Atlas App environment page.

  2. Click the WP Admin link at the top of the WordPress environment page.

Select your repo

To make changes to the look and functionality of your app, see our Local App Development guide.