Blueprints

Blueprints offer a quick easy way to start a site by utilizing pre-saved site settings such as 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.

Blueprints Basics

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!

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.

Atlas Blueprints page in the Local app.

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.

Blueprints Benefits

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.

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.

note

The “Save as Blueprint” option will be disabled if the site is not started.

  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.
  1. Name your Blueprint and press “Save.”
Name your Blueprint and click "Save Blueprint".

note

If you plan to create multiple Blueprints it helps to be descriptive of the site in the name (e.g. Ecommerce site, Blog, Brochure site, etc.)

That’s it — you created a new Blueprint!

You can not edit a Blueprint after it is saved. 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.  

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.
  1. Select the “Create from a Blueprint” 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.

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.
  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.
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.
Check the box and select "Yes, delete 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.

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.