From b876a8099f3d5cb671a9c6f69bd5b17ca9eb3d17 Mon Sep 17 00:00:00 2001 From: Preston Davies Date: Wed, 18 Nov 2026 10:50:56 -0500 Subject: [PATCH 1/2] docs: put toolkit in maintenance mode and hand stylelint-config to wp-tooling - README and toolkit README: maintenance-mode notice, support level set to Maintenance, links to wp-tooling and its migration guide. - @10up/stylelint-config: v5 is published from 10up/wp-tooling. Mark the copy here private and ignore it in changesets, so the two repositories can't publish over each other. - Patch changeset for 10up-toolkit so the notice reaches the npm page. --- .changeset/config.json | 2 +- .changeset/toolkit-maintenance-mode.md | 5 +++++ README.md | 7 +++++-- packages/stylelint-config/README.md | 3 +++ packages/stylelint-config/package.json | 1 + packages/toolkit/README.md | 5 ++++- 6 files changed, 19 insertions(+), 4 deletions(-) create mode 100644 .changeset/toolkit-maintenance-mode.md diff --git a/.changeset/config.json b/.changeset/config.json index acdaa5ee..fab0b019 100644 --- a/.changeset/config.json +++ b/.changeset/config.json @@ -10,5 +10,5 @@ "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": { "onlyUpdatePeerDependentsWhenOutOfRange": true }, - "ignore": ["tenup-theme", "@10up/component-accordion", "@10up/library-ts-test"] + "ignore": ["tenup-theme", "@10up/component-accordion", "@10up/library-ts-test", "@10up/stylelint-config"] } \ No newline at end of file diff --git a/.changeset/toolkit-maintenance-mode.md b/.changeset/toolkit-maintenance-mode.md new file mode 100644 index 00000000..b3a9e4d5 --- /dev/null +++ b/.changeset/toolkit-maintenance-mode.md @@ -0,0 +1,5 @@ +--- +'10up-toolkit': patch +--- + +Mark 10up-toolkit as in maintenance mode. The README now points new projects to Vite+ and `@10up/wp-vite-plugins` in 10up/wp-tooling, and links the migration guide. Nothing in the build changes. diff --git a/README.md b/README.md index 0b5dbd0f..5fdc9c9d 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,10 @@ > A collection of tools for building projects at 10up. -[![Support Level](https://img.shields.io/badge/support-active-green.svg)](#support-level) [![License: GPL 2.0 or later](https://img.shields.io/badge/License-GPL%202.0%20or%20later-yellow.svg)](https://spdx.org/licenses/GPL-2.0-or-later.html) +> [!WARNING] +> **10up-toolkit is in maintenance mode.** It will get security fixes for now, and will later be deprecated and archived. New projects should build with [Vite+](https://viteplus.dev) and [`@10up/wp-vite-plugins`](https://github.com/10up/wp-tooling/tree/trunk/packages/wp-vite-plugins) from [10up/wp-tooling](https://github.com/10up/wp-tooling). To move an existing project, follow [Migrating from 10up-toolkit](https://github.com/10up/wp-tooling/blob/trunk/packages/wp-vite-plugins/docs/migrating-from-toolkit.md). + +[![Support Level](https://img.shields.io/badge/support-maintenance-blue.svg)](#support-level) [![License: GPL 2.0 or later](https://img.shields.io/badge/License-GPL%202.0%20or%20later-yellow.svg)](https://spdx.org/licenses/GPL-2.0-or-later.html) [![projects builds](https://github.com/10up/10up-toolkit/actions/workflows/build-test-projects.yml/badge.svg)](https://github.com/10up/10up-toolkit/actions/workflows/build-test-projects.yml) [![tests](https://github.com/10up/10up-toolkit/actions/workflows/test.yml/badge.svg)](https://github.com/10up/10up-toolkit/actions/workflows/test.yml) @@ -19,7 +22,7 @@ Check out the documentation in [10up-toolkit](packages/toolkit/README.md) README ## Support Level -**Active:** 10up is actively working on this, and we expect to continue work for the foreseeable future including keeping tested up to the most recent version of WordPress. Bug reports, feature requests, questions, and pull requests are welcome. +**Maintenance:** 10up only fixes security issues and bugs that block builds. No new features are planned. New work happens in [10up/wp-tooling](https://github.com/10up/wp-tooling). ## Repository Structure and Engineering Guidelines Visit the [CONTRIBUTING](/CONTRIBUTING.md) page for initial contribution, engineering guidance, and details on how to get set up properly. diff --git a/packages/stylelint-config/README.md b/packages/stylelint-config/README.md index 425932b6..28e11c2c 100644 --- a/packages/stylelint-config/README.md +++ b/packages/stylelint-config/README.md @@ -1,5 +1,8 @@ # 10up Stylelint Config +> [!IMPORTANT] +> `@10up/stylelint-config` is now developed and published from [10up/wp-tooling](https://github.com/10up/wp-tooling/tree/trunk/packages/stylelint-config), starting with version 5. This copy is frozen at 4.0.0 and is no longer published from this repository. + > At 10up, we strive to provide digital products that yield a top-notch user experience. In order to improve both our efficiency and consistency, we need to standardize what we use and how we use it. This theme scaffold allows us to share initial set up procedures to make sure all projects can get up and running as quickly as possible while closely adhering to 10up's high quality standards. [![Support Level](https://img.shields.io/badge/support-active-green.svg)](#support-level) diff --git a/packages/stylelint-config/package.json b/packages/stylelint-config/package.json index 57d44c15..7eabd9f6 100644 --- a/packages/stylelint-config/package.json +++ b/packages/stylelint-config/package.json @@ -1,6 +1,7 @@ { "name": "@10up/stylelint-config", "version": "4.0.0", + "private": true, "description": "10up stylelint config for WordPress projects", "main": "index.js", "homepage": "https://github.com/10up/10up-toolkit/tree/develop/packages/stylelint-config#readme", diff --git a/packages/toolkit/README.md b/packages/toolkit/README.md index e94bef7f..45e4d6d5 100644 --- a/packages/toolkit/README.md +++ b/packages/toolkit/README.md @@ -1,5 +1,8 @@ # 10up-toolkit +> [!WARNING] +> **10up-toolkit is in maintenance mode.** It will get security fixes for now, and will later be deprecated and archived. New projects should build with [Vite+](https://viteplus.dev) and [`@10up/wp-vite-plugins`](https://github.com/10up/wp-tooling/tree/trunk/packages/wp-vite-plugins) from [10up/wp-tooling](https://github.com/10up/wp-tooling). To move an existing project, follow [Migrating from 10up-toolkit](https://github.com/10up/wp-tooling/blob/trunk/packages/wp-vite-plugins/docs/migrating-from-toolkit.md). + A collection of bundled scripts for 10up development. 1. [Introduction](#introduction) @@ -1185,7 +1188,7 @@ For instance, if you have a block with the following `block.json` ## Support Level -**Active:** 10up is actively working on this, and we expect to continue work for the foreseeable future including keeping tested up to the most recent version of WordPress. Bug reports, feature requests, questions, and pull requests are welcome. +**Maintenance:** 10up only fixes security issues and bugs that block builds. No new features are planned. New work happens in [10up/wp-tooling](https://github.com/10up/wp-tooling). ## Like what you see? From c8b2945f8175260f96e4771132ab07715a135a67 Mon Sep 17 00:00:00 2001 From: Preston Davies Date: Wed, 18 Nov 2026 11:04:30 -0500 Subject: [PATCH 2/2] fix: keep stylelint-config out of the changesets ignore list Changesets refuses to ignore a package that a non-ignored package depends on, and 10up-toolkit depends on @10up/stylelint-config. "private": true alone is enough: changeset publish skips private packages. --- .changeset/config.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.changeset/config.json b/.changeset/config.json index fab0b019..acdaa5ee 100644 --- a/.changeset/config.json +++ b/.changeset/config.json @@ -10,5 +10,5 @@ "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": { "onlyUpdatePeerDependentsWhenOutOfRange": true }, - "ignore": ["tenup-theme", "@10up/component-accordion", "@10up/library-ts-test", "@10up/stylelint-config"] + "ignore": ["tenup-theme", "@10up/component-accordion", "@10up/library-ts-test"] } \ No newline at end of file