Managing Blueprints

Blueprints let you save site configurations and quickly spin up new projects with the same setup.

What are Blueprints?

Blueprints are saved site configurations that capture the structure and settings of a Craft CMS site, including:

  • PHP version configuration
  • Database settings
  • Craft CMS version and configuration
  • Project structure and files
  • Environment variables and configuration
  • Site organisation and hostname settings

Blueprints allow you to create reusable project templates and maintain consistent development environments across teams.

Creating a Blueprint

To save a site as a blueprint:

  1. Open the site you want to use as a template
  2. Navigate to the appropriate section (typically from the site's context menu or settings)
  3. Click "Save as Blueprint"
  4. Enter a name and description for your blueprint
  5. The blueprint will capture the site's configuration and structure
  6. Click "Save Blueprint"

The blueprint captures the site configuration and structure, preserving PHP version, database settings, and Craft CMS configuration for reuse.

Using Blueprints

When creating a new site, select "Create from a Blueprint" and choose your saved blueprint. The new site will be created with:

  • The same PHP version as the blueprint
  • Matching database configuration
  • Preserved Craft CMS settings
  • Consistent project setup

This ensures that all team members can quickly spin up sites with identical configurations, maintaining consistency across development environments.

Managing Blueprints

Blueprints can be managed from Tun's interface, allowing you to:

  • View all saved blueprints
  • Create new sites from blueprints
  • Delete unused blueprints
  • Maintain consistent project setups

Best Practices

Create blueprints for common project types:

  • Standard Craft CMS sites
  • Sites with specific plugin combinations
  • Multi-site configurations
  • Headless Craft setups