Skip to content
Roots
  • Home page
Radicle
v1.2.1

Installation

What is Radicle?

Radicle is an opinionated starting point for WordPress projects with the Roots stack.

Radicle includes the preferred setup of Acorn, Bedrock, Bud, Sage, and Trellis from the creators of Roots.

Why use Radicle?

The Roots ecosystem contains several projects and most of them are built in a way where they don't require one another. There are some exceptions to this: Sage requires Acorn and Trellis requires Bedrock.

Our WordPress starter theme, Sage, is distributed in a way that is compatible with every type of WordPress setup. Since Sage 10 and the introduction of Acorn, which allows developers to use Laravel components within WordPress, it hasn't been possible for us to easily distribute the theme with our ideal setup because it requires changes made outside of the typical wp-content directory.

Since the release of Acorn, we've preferred to use a more traditional Laravel-esque structure from the root of the project. We've made the root of the project the area of focus, including everything related to the WordPress theme, which is a modified verison of Sage 10. All of your theme templates are located at resources/views/. No more navigating 7 levels deep to get to your templates — they're just 2 levels away.

See the full list of Radicle features

Server requirements

  • Your document root must be configurable (most local development tools and webhosts should support this)
  • PHP >= 8.0 with the following extensions: BCMath, Ctype, Fileinfo, JSON, Mbstring, Tokenizer, XML
  • Composer
  • WP-CLI

Installing Radicle

Radicle requires purchasing a Radicle license to get access to the codebase. Once Radicle has been purchased, you can use the Roots Dashboard to generate an invitation to the GitHub repository or download the latest release.

After you've accepted the invitation to the GitHub repository, navigate to the releases to download the latest version of Radicle.

Are you building new sites often? Create your own private repo with the Radicle codebase and modify it to fit your needs. Radicle should be treated as a boilerplate/starting point, and not a framework.

The Radicle roadmap includes plans for adding better SEO support to Laravel routes that integrates them with Yoast and The SEO Framework. This functionality will be packaged as a Composer dependency that's separate from Radicle.

Although it is possible to retrofit an existing project with Radicle, we recommend using Radicle on a new project.

Unzip the contents of the latest Radicle release into your new project's directory. Make sure all of the hidden files (such as .gitignore) are included in your project directory.

Last updated

Support Roots

Help us continue to build and maintain our open source projects. We’re a small team of independent developers and every little bit helps.

Sponsor Roots on GitHub