Generic selectors
Exact matches only
Search in title
Search in content
Post Type Selectors
Search in posts
Search in pages

Blueprints in Local

Blueprints in Local offer a quick easy way to start a site by utilizing pre-saved site settings such themes and plugins. If you’ve created the perfect site and want to recreate it, this is the best way to apply those settings when building new sites.

Table of Contents:

  1. What are Blueprints?
  2. What is an Atlas Blueprint?
  3. Why use Blueprints?
  4. Overview of the Blueprints tab
  5. Create a Blueprint
  6. Create a site using a Blueprint
  7. Rename a Blueprint
  8. Delete a Blueprint
  9. Access Blueprints on your local machine
  10. FAQ
    1. Can I edit my Blueprint after I create it? 
    2. How do I navigate to the Blueprint files on my local machine? 
    3. Can I create my own Atlas Blueprint? 

What are Blueprints?

A Blueprint is a WordPress site package that can include themes, plugins, configured pages, site settings, and more. With everything pre-installed, Blueprints let you skip several steps when you set up a site!

What is an Atlas Blueprint?

An Atlas Blueprint is a pre-built headless WordPress site designed to work seamlessly with WP Engine’s Atlas hosting platform. An Atlas Blueprint is now available in Local when the Atlas Add-on is installed. It’s a great way to learn and test headless WordPress sites!

Using an Atlas Blueprint gets you up and running quickly with a headless WordPress site. From there, you can customize it however you’d like.

New to headless? Learn more about headless WordPress here.

Preview of an Atlas Blueprint on the “Blueprints” tab.

There is a pre-made Atlas Blueprint, the Basic Blueprint, this comes with the elements of an Atlas site, such as a Faust.js frontend, Atlas Content Modeler, and more. 

Download the Atlas Add-on to test and preview the Atlas Blueprint in Local.

Why use Blueprints?

Blueprints save time by eliminating the need to navigate plugin and theme directories or run command-line commands to set up a site. Blueprints provide a great solution for developers who have a set of go-to tools used to build a site (e.g. a certain theme, your favorite plugins, or specific database settings). 

It’s also great for developers who build many similar sites frequently, for example, agencies and freelancers.  

Users who build WordPress plugins and themes or build on the WordPress core use Blueprints to spin up sites quickly for testing their latest builds.

Think of it as a head-start to your development workflow. No more starting from scratch or clearing out everything you don’t need from a cloned site. Ready to get your sites up and running faster? Create a Blueprint to get started.

Overview of the Blueprints tab

Blueprints are a main navigation item in Local. Just press on this tab to see all the Blueprints you’ve created. Once you’ve saved an existing site as a Blueprint, it will appear under the “My Blueprints” section. 

If you have the Atlas Add-on enabled, you’ll also see a pre-made Atlas Blueprint from our team in this tab for you to try. Learn more here.

Overview of Blueprints tab.
Overview of Blueprints tab.

Create a Blueprint

Turning a site into a Blueprint is easy, just follow these steps!

  1. Create a site in Local that includes everything you want in your Blueprint (e.g. themes, plugins, pages, etc.).
  1. Start the site you want to create a Blueprint from.

To start a site, click “Start site” in the top right corner of your site’s page or right-click the site’s name on the sidebar and click “Start site”.

Select "Start a site" in the upper right corner.
Select “Start a site” in the upper right corner.
  1. After the site is started, press the context menu (…) icon near the site name, or right-click the site’s name on the sidebar.
  1. Select “Save as Blueprint.”
Select "Save as Blueprint" from the three dot drop down.
Select “Save as Blueprint” from the three-dot dropdown.
  1. Name your Blueprint and press “Save.”
Name your Blueprint and click "Save Blueprint".
Name your Blueprint and click “Save Blueprint”.

That’s it — you created a new Blueprint!

Create a site using a Blueprint

Here’s how to start a new site in Local from a Blueprint:

  1. Create a Blueprint from an existing site in Local with the steps from the “Create a Blueprint” section of this help doc.
  1. Click the plus in the bottom left to create a new site in Local.
Create a new site in Local from the plus sign on the bottom right.
Create a new site in Local from the plus sign on the bottom right.
  1. Select the “Create from a Blueprint” option.
Create a site from Blueprint by choosing the middle option.
Create a site from Blueprint by choosing the middle option.
  1. Select the Blueprint you want to use.
Select the Blueprint you want to use from the list.
Select the Blueprint you want to use from the list.

If the Atlas Add-On is enabled and you would like to start a site from the Atlas Blueprint, you can select that here.

Select an Atlas Blueprint.
Select the Atlas Blueprint.
  1. Finish going through the “Create a site” flow by naming your site and pressing “Create site”.

That’s it — your new site is ready to continue building!

Rename a Blueprint

To rename a Blueprint, navigate to the Blueprints tab and select the Blueprint you want to rename. Click the “Rename” button, edit the text, and click “Save.”

Select an Atlas Blueprint.
Select the Atlas Blueprint.
Type the new name and select "Rename Blueprint".
Type the new name and select “Rename Blueprint”.

Delete a Blueprint

To delete a Blueprint, navigate to the Blueprints tab and press the delete button next to the Blueprint. A confirmation banner will appear where you can press “Yes, delete [Blueprint name]” or “Cancel.”

Delete a Blueprint by selecting the three dots.
Delete a Blueprint by selecting the three dots.
Check the box and select "Yes, delete Blueprint".
Check the box and select “Yes, delete Blueprint”.

Access Blueprints on your local machine

Blueprints are stored with the rest of Local’s application data on your machine. This location varies by the operating system.

FAQ

Can I edit my Blueprint after I create it? 

Not at this time. Right now there’s only the ability to create, rename, and delete a Blueprint. To edit your Blueprint (like updating a theme), we recommend creating a site from the Blueprint you want to update, make any edits you want, and save the updates as a new Blueprint.  

How do I navigate to the Blueprint files on my local machine? 

Blueprints are stored with the rest of Local’s application data on your machine. This location varies by the operating system.

Can I create my own Atlas Blueprint? 

The Atlas Blueprint section will only contain pre-made Atlas Blueprints from our teams here at WP Engine (the company that owns Local). You can, however, create a site from an Atlas Blueprint, modify it as you’d like, and save that as a new Blueprint. That Blueprint will be saved to your “My Blueprints” section.