Free WordPress themes made by Automattic for WordPress.org and WordPress.com.
Find a file
2022-04-04 12:03:13 -04:00
.github
.husky
affinity
altofocus
alves Version Bump 2022-03-28 16:51:39 +05:30
ames
apostrophe-2
arbutus
archeo Version Bump 2022-04-01 15:58:15 -04:00
attar Version Bump 2022-02-23 11:08:08 +00:00
balasana Version Bump 2022-03-28 16:51:39 +05:30
barnett
barnsbury Version Bump 2022-03-28 16:51:39 +05:30
bennett
blank-canvas
blank-canvas-blocks
block-canvas Version Bump 2022-03-28 15:16:48 -04:00
blockbase Version Bump 2022-04-01 11:39:00 +01:00
brompton Version Bump 2022-03-28 16:51:39 +05:30
button-2
calm-business
calvin
canard
coutoire Version Bump 2022-03-28 16:51:39 +05:30
dalston Version Bump 2022-03-28 16:51:39 +05:30
dara Add language files from dotcom 2021-06-10 09:42:35 +01:00
dorna Version Bump 2022-03-01 10:54:57 +11:00
dyad-2
elegant-business
exford Version Bump 2022-03-28 16:51:39 +05:30
farrow
friendly-business
gazette
geologist
geologist-blue
geologist-cream
geologist-slate
geologist-yellow
hari Version Bump 2022-02-23 11:08:08 +00:00
hever Version Bump 2022-03-28 16:51:39 +05:30
ibis
illustratr
independent-publisher-2
intergalactic-2
ixion
jackson
karuna Version Bump 2022-03-09 14:15:53 +00:00
kingsley
leven Version Bump 2022-03-28 16:51:39 +05:30
libre-2
libretto
livro Version Bump 2022-03-23 12:28:04 -04:00
lodestar
marl Version Bump 2022-02-23 11:08:08 +00:00
mayland Version Bump 2022-03-28 16:51:39 +05:30
mayland-blocks
maywood Version Bump 2022-03-28 16:51:39 +05:30
modern-business
morden Version Bump 2022-03-28 16:51:39 +05:30
pendant Adjusted spacing on single per design review (#5812) 2022-04-04 12:03:13 -04:00
penscratch-2 Version Bump 2022-03-02 14:48:06 +05:30
photos
pique
professional-business
publication
quadrat
quadrat-black
quadrat-green
quadrat-red
quadrat-white
quadrat-yellow
radcliffe-2
rebalance
redhill Version Bump 2022-03-28 16:51:39 +05:30
remote Remote: added missing credits (#5808) 2022-04-04 09:44:32 +02:00
rivington Version Bump 2022-03-28 16:51:39 +05:30
rockfield Version Bump 2022-03-28 16:51:39 +05:30
russell
scratchpad
seedlet
seedlet-blocks Version Bump 2022-02-24 20:34:09 +00:00
shawburn Version Bump 2022-03-28 16:51:39 +05:30
shoreditch
skatepark Version Bump 2022-03-09 14:15:53 +00:00
sketch
sophisticated-business
spearhead
stewart Version Bump 2022-03-17 14:05:50 -04:00
stow Version Bump 2022-03-28 16:51:39 +05:30
stratford Version Bump 2022-03-28 16:51:39 +05:30
textbook
toujours
twentytwentytwo-blue
twentytwentytwo-mint
twentytwentytwo-pink
twentytwentytwo-red
twentytwentytwo-swiss
varia Version Bump 2022-03-28 16:51:39 +05:30
variations
videomaker Version Bump 2022-04-01 11:39:00 +01:00
videomaker-white Build videomaker variations and version bumpped 2022-03-23 12:42:40 -04:00
winkel Version Bump 2022-03-01 11:17:38 +11:00
zoologist Version Bump 2022-02-24 20:34:09 +00:00
.gitignore
.sandbox-ignore Try: Blockbase standalone theme (#5660) 2022-03-17 11:18:33 +01:00
.stylelintrc.json
.wp-env.json
composer.json
composer.lock
create-a-theme-checklist.js Update Create Theme Checklist items (#5697) 2022-03-17 15:29:47 +00:00
deploy-dotorg.sh add Archeo to the themes to deploy list (#5730) 2022-03-23 12:43:45 -04:00
dotorg-exclude.txt
LICENSE
package-dotorg.sh
package-lock.json Version Bump 2022-04-01 15:58:15 -04:00
package.json Version Bump 2022-04-01 15:58:15 -04:00
phpcs.xml.dist
pre-commit-hook.js
README.md Revise readme (#5717) 2022-03-23 11:10:57 -04:00
theme-batch-utils.sh
theme-utils.mjs Add utilities to sync core themes to wpcom (#5558) 2022-02-21 20:52:07 +00:00

Automattic Themes

The development repository for themes maintained by the Automattic Theme Team.

What's Here

We're committed to imagining and creating the future of themes. Our latest themes are block themes — they depend on the latest features available in the Gutenberg plugin. Read about our latest themes built to support full-site editing here.

A gallery of block themes with a variety of styles

Contributing

Issues

Before submitting your issue, please search for an existing or related ticket here.

Here are some tips to consider for writing a useful report:

  • Share steps for replicating the issue.
  • Add screenshots and videos where helpful.
  • Share your environment details, including what version of WordPress and Gutenberg you're using

Code

Patches and ideas in the form of code are always welcome! Here are a couple tips for crafting a great pull request:

  • Include the purpose of your PR. Be explicit about the idea or issue your PR solves.
  • Reference any existing issues that relate to your PR. This allows everyone to easily see all related discussions.

By contributing code to our free themes, you grant its use under the GNU General Public License v2 (or later).

Testing pull requests

Using GitHub

  1. Clone repository locally git clone git@github.com:Automattic/themes.git
  2. Identify the branch of the pull request, e.g. update/#1889
  3. Check out featured branch of pull request, e.g. git checkout update/#1889
  4. Symlink or copy affected theme OR zip affected theme and import into WordPress site

Manually download

  1. Identify and visit the branch of the pull request.
  2. Change the /tree/ part of the branch's URL to archive, and add a .zip to the end to download a zip of the branch. e.g. https://github.com/Automattic/themes/tree/update/%231889 would become https://github.com/Automattic/themes/archive/update/%231889.zip
  3. Unzip the zipped featured branch
  4. Zip affected theme and import into WordPress site

Note: In case the affected theme already exists on the WordPress site, it needs to be deleted before the theme zip file gets uploaded.

Coding Standards

Themes code should adhere to the WordPress coding standards. This repo contains a pre-commit hook which enables you to detect and fix code that doesn't follow the standards.

To set this up follow these instructions:

  1. Run npm i in the root of the repo.
  2. Run composer install

Now when you commit changes to a file PHPCBF will attempt to fix any issues with the file.

This will also install the WordPress-standard Prettier Configuration which can (optionally) be used in your IDE or command-line to format your code via (Prettier)[https://prettier.io/docs/en/editors.html].

Packaging for WordPress.org Themes Showcase

The code in this repository mirrors the code needed for the theme to function correctly on WordPress.com. To prepare a theme.zip that passes the WordPress.org theme review automated test, do the following:

  • From the top-level directory, run ./package-dotorg.sh [theme-slug]
  • View the generated zip in the respective theme's sub-directory

Note that this script rebuilds the theme to strip it of .com-specific functionality, and discards any changes via git after doing so. Make sure you have committed any working changes before running this script.

Sandbox Tools

If you use a sandbox to test or develop your themes you can use a couple of utilities to operate on that sandbox.

  • From the top-level directory, run node ./theme-utils.mjs clean-sandbox to bring the public themes GIT repository to a clean state. (This will only matter if your sandbox uses GIT such as how WordPress.com is currently managed.) Alternately you can trigger that as an npm script: npm run sandbox:clean. npm run sandbox:clean-all will clean the entire sandbox.

  • From the top-level directory, run node ./theme-utils.mjs push-to-sandbox to push your entire working copy to the public themes folder of your sandbox. Alternately you can trigger this as an npm script: npm run deploy:push:all This command will rsync your local copy with the exception of anything in the .sandbox-ignore file. You should clean your sandbox before pushing any changes to it. node ./theme-utils.mjs push-changes-to-sandbox or npm run deploy:push:changes alternatively will push only files that have changed since the last deployment.