Theme Deployment

To deploy a Sage theme you'll need to make sure two things are covered:

  1. Run composer install from the theme directory on the remote server
  2. Copy over production theme assets (the dist/ folder)

Generate production ready assets with yarn build:production, which will build your assets with versioned filenames to the dist/ folder.

Deploying Sage with Trellis

If you use Trellis, you can build your assets locally (or on a CI server), then copy them to the remote server during deployment. See the build-before.yml example hook in Trellis.

Deploying Sage on Kinsta

Kinsta supports Bedrock and Trellis, so deploying Sage with Trellis on Kinsta is possible by following a few extra steps.

Deploying Sage on WP Engine

The Sage 9 on WP Engine thread on Roots Discourse covers how to work around limitations on WP Engine to deploy your theme.

We do not officially recommend or support this and suggest using a WordPress host that supports SSH, Git, Composer, and the latest PHP versions.

Join over 5,600 subscribers on our newsletter to get the latest Roots updates, along with occasional tips on building better WordPress sites.

Looking for WordPress plugin recommendations, the newest modern WordPress projects, and general web development tips and articles?

“Easily the best WordPress email I get.” Colin OBrien

Ready to checkout?