sitecrafting/conifer

Powerful abstractions for serious WordPress theme development

Conifer

ALPHA STATUS., _(*1)

This is code that has been extracted from systems currently in production. While we consider Conifer production-ready, there may be lingering bugs. While the API is fairly stable, there may be breaking changes at this early stage., _(*2)

, _(*3)

, _(*4)

Documentation

For reference documentation, use-cases, and design principles, check out the docs., _(*5)

Quick start

See the Installation docs to get Conifer installed for use in your theme or plugin., _(*6)

Issues and Feature Requests

Please submit issues and feature requests directly to GitHub. We need guidance from the community about how people would like to use Conifer!, _(*7)

Development

To get started hacking on Conifer itself, first install Lando, the official dev environment for Conifer and sole system requirement for developing Conifer. Note that you need Lando version beta.47 or rc.1. The transition to rc.2+ is a work in progress., _(*8)

Then, just clone the repo and start up the dev environment:, _(*9)

git clone git@github.com:sitecrafting/conifer.git
cd conifer
lando start

Follow the prompts and you should have a local WordPress site running Conifer and its companion starter theme, Groot!, _(*10)

NOTE: there is currently a known issue with how Lando sets up pretty permalinks. They won't work before you configure them manually., _(*11)

Authored by SiteCrafting

Built with 💚 + ☕ in Tacoma, Washington., _(*12)

, _(*13)

Building a new release

Groot includes a script for building itself and creating a release. To create a tag and corresponding release called vX.Y.Z:, _(*14)

scripts/build-release.sh vX.Y.Z

This will create a .tar.gz and a .zip archive which you can upload to a new release on GitHub., _(*15)

If you have hub installed, it will also prompt you to optionally create a release directly!, _(*16)