Skip to content

Theme: Remove experimental package messaging #80049

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ciampo merged 3 commits into from
Jul 13, 2026
Merged

Theme: Remove experimental package messaging #80049

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
c547eb7
Theme: Remove experimental package messaging
ciampo Jul 9, 2026
d1a2f3b
Theme: Add changelog for stable metadata docs
ciampo Jul 9, 2026
412ca82
Theme: Mark package as stable
ciampo Jul 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions packages/theme/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

## Unreleased

### Stable Release

This package is now considered stable and production-ready. The API will follow semantic versioning from this point forward.

### Breaking Changes

- Remove the `--wpds-elevation-*` design tokens while the complete elevation model is still being defined ([#80099](https://github.com/WordPress/gutenberg/pull/80099)).
Expand All @@ -21,6 +25,7 @@

### Documentation

- Remove the experimental messaging from the package README and update the package keywords to reflect its stable design system purpose ([#80049](https://github.com/WordPress/gutenberg/pull/80049)).
- Clarify what `@wordpress/theme` provides, when consumers need to load `design-tokens.css`, the `ThemeProvider` contract including root provider usage, and the legacy compatibility boundary ([#79961](https://github.com/WordPress/gutenberg/pull/79961)).
- Document build plugin behavior and add parity coverage for PostCSS, esbuild, and Vite ([#80088](https://github.com/WordPress/gutenberg/pull/80088)).
- Document design token accessibility responsibilities ([#79943](https://github.com/WordPress/gutenberg/pull/79943)).
Expand Down
4 changes: 0 additions & 4 deletions packages/theme/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,5 @@
# Theme

<div class="callout callout-alert">
This package is still experimental. “Experimental” means this is an early implementation subject to drastic and breaking changes.
</div>

A theming package that's part of the WordPress Design System. It has two parts:

- **Design Tokens**: A comprehensive system of design tokens for colors, spacing, typography, and more.
Expand Down
4 changes: 3 additions & 1 deletion packages/theme/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,9 @@
"keywords": [
"wordpress",
"gutenberg",
"components"
"design-system",
"design-tokens",
"theme"
],
"homepage": "https://github.com/WordPress/gutenberg/tree/HEAD/packages/theme/README.md",
"repository": {
Expand Down
Loading