Cookieplone 2.0.0 released

Announcements
1

We are happy to announce the release of Cookieplone 2.0.0, together with a new release of cookieplone-templates (20260914.1).

Cookieplone is the recommended way to generate Plone projects, add-ons, and related codebases. Try it now:

uvx cookieplone@latest

What's new in Cookieplone 2.0

  • A new template repository format. Repositories are described by cookieplone-config.json, validated with JSON Schema, with global version pinning and templates grouped into categories.
  • A new form wizard. A confirmation page, back-navigation, and clearer validation messages.
  • Scriptable generation. Your answers are saved inside the generated codebase, and answers can be loaded from a JSON file with --answers-file. Author name and email default to your git configuration.
  • Extend instead of fork. A template repository can extends another one, inheriting, overriding, adding, or hiding its templates.
  • Friendlier errors. Clone failures now explain what went wrong, and template repositories can declare the minimum Cookieplone version they require.
  • A post-generation summary screen once your codebase is created.

What's new in the templates

  • All templates migrated to the new schema.
  • One project template for Volto and Classic UI. Answer "Support headless Plone?", and the questions that don't apply are skipped.
  • New Aurora project templates: Aurora with a Plone backend, including Playwright acceptance tests, and Aurora with Nick as the backend.
  • Volto with Nick as a monorepo, with GitHub Actions.
  • Unified changelog tooling (towncrier) and simpler changelog checks in the generated CI.

:warning: Which Cookieplone versions keep working

Cookieplone version Status
2.0.0 :white_check_mark: Works, with the new templates
1.1.0 or a newer 1.x :white_check_mark: Keeps working, pinned to templates 20260810.1 (no new templates)
1.0.0 or older :cross_mark: Stops working

Cookieplone 1.0.0 and older always download the latest templates, which now use the 2.0 format. They fail with:

RuntimeError: cookiecutter.json not found in ~/.cookiecutters/cookieplone-templates

If you see this error, upgrade Cookieplone:

# Running with uvx: always pick the latest stable release
uvx cookieplone@latest

# Installed as a uv tool
uv tool install --reinstall cookieplone

# Installed with pipx
pipx upgrade cookieplone

If an existing workflow still needs the previous templates, use Cookieplone 1.1.0:

uvx cookieplone@1.1.0

Open pull requests against next

Development of cookieplone-templates now happens on main. The next branch is frozen, read-only, as a fallback for the 2.0 betas, so pull requests targeting it can no longer be merged. If you have one open:

  1. Rebase your branch onto main (this works from a fork or from a branch in the Plone repository):
git fetch https://github.com/plone/cookieplone-templates.git main
git rebase FETCH_HEAD
git push --force-with-lease
  1. On GitHub, click Edit next to the pull request title and change the base branch to main.

Links

Thanks to everyone who contributed code, reviews, and testing during the alphas and betas!

8 Likes