Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


beautiful screenshot

This project is retired, and not maintained. Please see this blog post for more information or head over to Underscores for all your starter theme needs. Thank you to all of the contributors to the project!

A library of shareable, reusable patterns for WordPress themes. Components allows you to generate different types of starter themes for taking your themes where you want them to go, faster.

This repository contains theme components – all the pieces of code that go into making a theme. The code that runs the Components site and generates the starter themes lives in a different repo.

Forked from _s, Components creates a modular, pattern-based approach to theme development. For more information, read the wiki or this introductory post on ThemeShaper.

Using Components

You'll notice this repository can't be activated and run as a WordPress theme. It's just the pieces for a theme. The best way to use it on your next project is to not download it directly from Github, but head over to the Components site, fill out the form and generate the theme of your choice. The generator does all the hard work so you can get to theming!

Developing for Components

If you want to start contributing to Components, we're happy to have you! Keep in mind, Components has two major repositories, plus a special development plugin that helps you contribute to the project:

To start developing, follow these steps:

  1. Place a local copy of Components in the root of your WordPress install. It should be named theme-components.
  2. Upload the theme-components-local-dev directory to the /wp-content/plugins/ directory.
  3. Make sure you have the Components site theme active, and the latest master branch running.
  4. Activate the plugin through the Plugins menu in WordPress.

From there, you can make changes to the local copy of Components in the root of your WordPress install, and the themes you create from your local WordPress install will reflect any changes you've made. You can test and commit code to the project. Just don’t forget to check out our CONTRIBUTING doc – it includes a few details that will make the process a lot smoother.


Need to report a security vulnerability? Go to or directly to our security-bug-bounty site

Browser Support

We support the latest two versions of all major browsers, except Internet Explorer, where we currently support 11 and Edge. (see Browse Happy for current latest versions).


If you have any problems using Components, please see the most common issues here.


License: GNU General Public License v2 or later License URI:


A collection of patterns for creating a custom starter WordPress theme.






No releases published


No packages published