WordPress / WordPress/create-block-theme

Create a block theme swapping tool

Open
#583 0 comments 6 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
JavaScript
Stars
417
Forks
66
PR merge metrics
No merged PRs in 30d

Description

Without clear and followed standards for theme.json values, swapping between block themes is often a messy situation. Spacing, font sizes, and colors can be wildly different from theme to theme. Because so much of our content is now intertwined with the design, it's essential that we make theme transitions as smooth as possible.

One way of easing the transition would be to create a tool that lets users map values from an old and new theme and update them accordingly. For example, if your old theme had "slug": "large" you could map that to a closer alternative in the new theme, "slug": "30" and the values would be updated throughout the site/db accordingly.

Figma has a similar tool for fonts that is pretty intuitive. This interface could work fairly well here.

missing-fonts-modal

One limitation is there is no visual representation to see the difference between values so you can choose the best one. However, even as a developer tool, this would be quite valuable in helping us move the needle on block theme adoption.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No files, tests, or entry points are identified in the issue. Start by defining the mapping scope for theme.json values such as spacing, font sizes, and colors, then establish how mapped values should be updated throughout the site and database. Done means a usable theme-swapping tool exists with behavior aligned to the described Figma-style interface.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, wordpress
Domain
frontend, tooling, web-dev
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.