Welcome to the development repository for the default theme that will launch with WordPress 6.1.
Twenty Twenty-Three is a stripped-back and minimal version of Twenty Twenty-Two, and will include a diverse collection of style variations designed by members of the community.
Just want to see a preview of what the theme currently looks like? Check out the demo site.
Please see the design specification for more information about the default typography and spacing settings.
If you would like to contribute code, the list of open issues is a great place to start looking for tasks. Pull requests are preferred when linked to an existing issue.
Contributing is not just for developers! There are many opportunities to help with testing, triage, discussion, designing and building variations, and more. Please look through open issues, and join in wherever you feel most comfortable.
If you'd like to help with triage, let @mikachan and @beafialho know here or in WordPress.org's Slack instance. The #core-themes-projects channel is a good place to start. We'll help you get set up with the ability to add labels to issues and PRs.
A big part of Twenty Twenty-Three is to emphasize a diverse collection of style variations, so this is a great way to contribute to the theme! You can read more about this in the project kick-off post.
This can be done a few different ways, including:
- Create an alternate theme.json file to the one provided by the theme and change values directly in the code.
- Make changes in the Global Styles panel in the Site Editor. You can save these changes as a new style variation using the Create Block Theme plugin.
- Design static mockups in Figma or a similar program.
When you're ready to submit, please create a new issue and share your designs:
- Theme.json files can be submitted as code or as zip files.
- Add images that showcase the look & feel of the variation.
- Include a style guide with design specifications — this should include details on typography, colors, spacing, etc. Here’s an example.
To get started with development:
- Set up a WordPress instance, we recommend wp-env or Local as an alternative to docker.
- Install the Gutenberg plugin
- Clone / download this repository into your
/wp-content/themes/directory
- Similar to Twenty Twenty-Two, a goal for the theme is to have as little CSS as possible. Much of the theme's visual treatments should be handled by the Block Editor and Global Styles. As a general rule, if multiple themes would benefit from the CSS you're considering adding, it might reasonably be provided by Gutenberg instead. Let's include clear code comments for any CSS we do include.
- Similarly, let's refrain from building any custom-built PHP or JavaScript-based workarounds for functionality that might reasonably be provided by the Block Editor. Twenty Twenty-Three will be a block theme, so let's keep its code simple.
- In accordance to those last two bullets, this theme has no required build process.
- If you've helped contribute to the theme in any way, you deserve credit! Folks will be updating CONTRIBUTORS.md periodically with names of contributors, but feel free to open a PR or issue if we leave someone out.
- Gutenberg plugin (latest)
- WordPress 5.9+
- PHP 5.6+
- License: GPLv2 or later
Some theme features / PRs may require Gutenberg trunk and will be described or tagged accordingly.
- Twenty Twenty-Three Figma Mockups
- Twenty Twenty-Three Project kickoff post
- Setting up a development environment
- Create Block Theme plugin
- Block Theme documentation
- Global Styles & theme.json documentation
The theme will be released with WordPress 6.1 and follow the key dates / milestones associated with its development schedule.