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.
Create Atlas App
1. Connect to GitHub
Connect your GitHub account so you can clone Atlas blueprints.
Under
Connect to GitHub
, selectConnect
.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
.
2. Create a repository
Now that GitHub is connected, it's time to create a repository where your Blueprint code is going to be stored.
- Select your GitHub account
Use the dropdown list or start typing to filter available GitHub accounts.
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:
- 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.
- 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.
- 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.
- Click
Create App
.
That's it! Track the initial build progress on the next screen that loads automatically.
3. Find the link to your frontend site and WordPress admin
A link to visit your live frontend using a temporary domain will appear under Atlas URL
when the deploy completes.
To log in to the WordPress site linked to your Atlas app:
Click the link below the
Linked WordPress environment
title on your Atlas App environment page.Click the WP Admin link at the top of the WordPress environment page.
Next Steps
To make changes to the look and functionality of your app, see our Local App Development guide.