- NewRepeater and relation fields and field groups on a taxonomy work in Free too.
- Action neededThe artifact store moves from wp-content/cache/nucleo to uploads/nucleo/store; the update moves the site folder.
- Action neededThe transients and the cookie of OTP codes and collections use the nucleo_ prefix instead of nc_.
- ImprovedCaptcha scripts, the menu style and the preview style load with wp_enqueue_script and wp_enqueue_style.
Changelog
What's new in Nucleo
Every version, with new features, improvements and fixes. Pro entries need an active license.
RSSv0.4.0Link to this version
- NewWooCommerce product page, archive, cart and checkout run on Nucleo, without woocommerce.css or the classic jQuery scripts.
- NewComposable Nucleo cart, and a WooCommerce checkout you configure with woo-checkout-parts-set.
- NewThe mini-cart block has a configurable panel and a side drawer variant, with item cards, coupon and totals.
- NewProduct page with Reviews and Additional information tabs and a review form in Nucleo style, even when the theme does not declare WooCommerce support.
- Action neededdoc-create with a layout kind and no postType creates a nucleo_layout document; with postType page or post it rejects the layout, popup and section kinds.
- Action neededOver MCP an insufficient permission (insufficient_scope) arrives as JSON with the missing scope, like the other errors.
- ImprovedThe CLI prints errors, warnings and output in English, and nucleo component new generates descriptions, comments and examples in English.
- ImprovedWooCommerce abilities are hidden when WooCommerce is not active.
- Improvedwoo-checkout-parts-set sets company, phone and address line 2 with the classic checkout too; reading no longer counts as a write.
- Improveddoc-validate and quality-check accept postType and check new content against the layouts of its type.
- ImprovedMCP tool descriptions now list error codes and cross-references; new woocommerce topic in catalog-get and rule R4.7 in the guide.
- ImprovedAfter a Nucleo update, script URLs carry the new version and documents are recompiled.
- FixedIn the Free package with WooCommerce active, Add to cart no longer causes a fatal error.
- FixedAn item read with content-list or content-get can be sent back to content-upsert as is; content-get returns the hash to use as the base.
- Fixedcontent-upsert and terms-set no longer rewrite items identical to the saved ones: they answer unchanged and post_modified stays as it is. The CLI push lists unchanged content separately (content unchanged).
- FixedA CLI push interrupted halfway no longer reports changes the site already accepted as conflicts; a conflict in content/ and terms/ suggests the right command.
- Fixedlayout-explain follows the runtime: on a product it marks single as replaced by product and lists the printed layouts in applied.
- Fixeddoc-create gives drafts a unique slug from the title too; the slug of an exported document is normalized instead of rejected.
- FixedA Cart or Checkout page with a Nucleo document keeps the WooCommerce block, and woo-checkout-parts-set edits it without losing it.
- FixedProduct variations also show terms without a saved order.
- FixedThe URL of a script with a parameter such as ?server= gets the version.
v0.3.5Link to this version
- FixedWith several videos, forms, embeds or sliders on one page, each instance loads its script on first use, not only the first one.
- FixedWith a single layout, the forms, collections and linked fields of the page display correctly.
- FixedA Nucleo page with blocking quality issues no longer goes live from the WordPress editor either.
- FixedWith an OAuth token, editing a page that is already live requires the publish scope.
- FixedThe CLI push validates the whole folder before changing the site and exits with an error when the site rejects the import.
- FixedThe CLI pull keeps a copy of overwritten local files and reports pages deleted from the site.
- FixedTitle and status changed in the admin are no longer silently overwritten by a push; wp.status draft moves a published page back to draft.
- FixedThe rebuild queue no longer loses documents that fail and lists them in status.
- FixedThe editor Publish button also saves the texts of the Text only view; the editor asks for confirmation before leaving with unsaved changes.
- FixedThe mini-cart works with WordPress in a subfolder.
v0.3.4Link to this version
- ImprovedRequests for several blocks from the catalog return a compact form under 25,000 characters. AI agents read the blocks of a page in one call.
- FixedThe quality check no longer reports a missing nav landmark when the menu is in the site header.
- FixedValidating a page that is not saved yet takes the site header and footer into account, as saving does.
v0.3.3Link to this version
- ImprovedAdmin links to nucleowp.dev use the new site addresses for documentation, pricing, customer area and feedback.
- FixedThe plan comparison link opens the pricing section of the Pro page. The renewal link opens the licenses in the customer area.
- FixedThe feedback link opens the board in the user's language.
v0.3.2Link to this version
- FixedWith WordPress in English, parts of the plugin, editor, WP-CLI and block scripts showed Italian text. The interface now follows the WordPress language, in English and Italian.
- FixedLabels written into pages, such as slider, video, embed and menu labels, use the site language instead of the language of the user who saves. With Polylang or WPML they use the page language.
- FixedAdmin dates use the user's language.
- Action neededPages saved before this version get the right labels at the next save or with a recompile from Tools.
- ImprovedThe site documentation is complete in English and Italian.
v0.3.1Link to this version
- Action neededThe theme is now Nucleo Canvas (folder nucleo-canvas). Sites with nucleo-theme get Nucleo Canvas as an update, and WordPress activates it in place of the old theme.
- ImprovedNucleo Canvas keeps the logo, menu locations and options of the old theme. After the update you can delete nucleo-theme.
- NewThe Free plugin downloaded from nucleowp.dev updates from updates.nucleowp.dev. The Free plugin from WordPress.org updates from the directory.
- NewThe theme adds comments, pagination and entry templates, and works without the plugin.
v0.3.0Link to this version
- NewAdds the Support page with a link to the feedback form and your site details.
- ImprovedThe Agents page has setup guides for Claude, ChatGPT, Cursor, VS Code, Codex, Gemini CLI, Windsurf and STDIO.
- NewAdds the Page settings tab in the Nucleo editor, with theme, layout and title per page.
- NewThe Back to the WordPress editor button keeps the Nucleo document; Edit with Nucleo restores it.
- NewAdds the Embed, Off-canvas, HTML and Shortcode blocks.
- ImprovedShows the inserter with icons and lets you drag blocks into the preview.
- NewEdits titles, texts, buttons and lists directly in the preview with a double click.
- NewAdds quality checks for images, DOM size, CSS, JS, fonts and embeds.
- SecurityLimits Bearer tokens to Nucleo REST routes and hardens the OAuth server.
- Action neededBearer tokens work only on /nucleo/v1/*. Update clients that call other paths.
v0.2.0Link to this version
- ProNucleo Pro and the theme update from the updates.nucleowp.dev server.
- ProPro receives updates with a license active on the site.
- Action neededThe theme updates without a license, only after the plugin: it requires at least the Nucleo version it ships with.
- Action neededThe license, update and store domain moves to nucleowp.dev.
v0.1.12Link to this version
- NewAdds captcha to the native nc/native-form forms.
- NewEach site uses one provider: reCAPTCHA v2, reCAPTCHA v3, hCaptcha, Cloudflare Turnstile, or Friendly Captcha.
- NewKeys are set in settings-set, group captcha, or in the Captcha tab of the settings.
- SecurityThe secret is write-only.
- NewEach native form shows the widget above the buttons.
- NewWith settings.captcha set to false, the form does not show the widget.
- SecurityThe server verifies the token on submit and on OTP code submit.
- NewIf the provider does not respond, the form accepts the submission.
v0.1.11Link to this version
- FixedNucleo reads page titles from every results page of doc-list, not only the first.
- FixedPages beyond the first results page now receive their correct title.
- FixedSEO titles now cover all pages of the site.
v0.1.10Link to this version
- NewNew siteIcon key: sets the site favicon from an image in the media library.
- NewWordPress uses the same image as the app icon.
- NewA null value removes the favicon.
- NewWith the URL of another site, the image is found by file name.
- NewThe export includes siteIcon only when the site has a favicon.
v0.1.9Link to this version
- ImprovedThe critical CSS includes the rule that hides closed elements, such as the menu close icon and closed panels.
- FixedThe preview no longer changes the header height.
- ImprovedThe loader marks the stylesheets it loads, and the check waits for them.
- ImprovedOn slow servers, the check starts only after the full CSS loads.
- ImprovedThe critical CSS check ignores the height of elements below the first screen.
v0.1.8Link to this version
- NewWith the site option imageFormats, off by default, Nucleo creates AVIF and WebP versions next to each uploaded image.
- NewImages use the modern format and show the original if the browser does not support it.
- NewThe image block and post images use the picture tag, with the original image as fallback.
- NewYou can turn off the formats for a single image block.
- NewThe image block accepts hand-written sources.
- NewSources exclude crops. Without sizes, the image block follows the WordPress width rule.
- NewThe MCP tool nucleo-media-formats generates the formats for images that are already uploaded.
- NewThe picture tag does not change the image layout and classes.
v0.1.7Link to this version
- NewEach block declares its internal parts, such as labels, legends, and placeholders.
- NewParts accept style keys, including breakpoints and states.
- Newstyle.custom adds CSS to the node for rules that style keys do not cover.
- NewThe size, spacing, typography, color, border, and motion groups apply to every block. supports.styleExclude removes them.
- ImprovedUnits follow the CSS property. transition accepts any property and multiple transitions.
- ImprovedEach page outputs one JSON-LD @graph in the footer. Company data accepts any schema.org property.
- NewTwo new MCP tools, nucleo-gap-report and nucleo-gap-list, record what Nucleo lacks.
- NewNew style keys: accentColor, fontStyle, minWidth, maxHeight, and transform.
- ImprovedThe sitemap filter runs only on sitemap requests. Export omits company data and empty icons.
- FixedThe new browser test of the parts found two defects, now fixed: the index declared a part that does not exist, and the form numbering won over the part style.
v0.1.6Link to this version
- FixedoptionalWeight and numberWeight stay numbers: 400 does not become 400px.
- NewnumberFont sets the font family ($font.mono).
- NewnumberFontSize and numberWeight set the size and weight of the numbering.
v0.1.5Link to this version
- NewThe nc/breadcrumbs block prints the BreadcrumbList of its path.
- NewCompany data accepts legalName, vatID and taxID.
- Improvedtransition accepts filter, background, border and text-decoration-color.
- Improvednc/native-form accepts a width with maxWidth or width.
- Newnc/native-form adds letters-box and numbers-box numbering.
- Improvednc/native-form accepts the optionalSize, optionalWeight, number*, controlMinHeight, placeholderColor, checkSize, checkAccent and navJustify styles.
- FixedThe legendLine rule is now visible and reaches the edge.
- Improvednc/button accepts size styles, such as width 100%.
v0.1.4Link to this version
- NewAdds the Hover and Current style states.
- NewAdds the nc/toc index block, which highlights the entry of the visible section while the page scrolls.
- NewAdds markers and styles to the fields of the native form block.
- NewImports site icons from a folder of SVG files with the nucleo icons import command.
- NewDownloads icons from Iconify once with the nucleo icons add command.
- NewLists and removes site icons with the nucleo icons list and nucleo icons remove commands.
- NewAdds and removes single site icons through the dedicated MCP tool. The set accepts up to 300 icons.
- NewReplaces a built-in icon with the site icon that has the same name, across the whole site.
- NewGenerates structured data for the company, SEO schema in the metadata, and automatic breadcrumbs.
- NewExcludes pages marked noindex from the sitemap.
- NewAdds rule R4.6 for agents: no mu-plugins, theme code or scripts in wp_head; site PHP goes in components.
v0.1.3Link to this version
- NewThe build writes the changelog entry automatically for each new version.
- NewThe changelog uses the commits since the last version.
- NewIf the claude CLI is missing or fails, the build shows a warning and continues.
v0.1.2Link to this version
- NewStyles support one-side borders, including dashed borders, whiteSpace, grayscale filter and container opacity.
- ImprovedCards with a link become clickable across the whole card.
- NewSections hide their node when the parameter is empty.
- NewSections support the list parameter and the repeat binding.
- NewNew icons: car, bus, tractor, search, gauge, layers and refresh.
- ImprovedAccordion shows a chevron or plus icon, and its text inherits the block typography.
- NewForms have style groups for controls and buttons.
- NewForm fields can take half width and group into fieldsets.
- NewInvalid form fields show a highlighted border.
- ImprovedAll 1797 strings are translated.
v0.1.1Link to this version
- ImprovedThe validator checks array items, media: and menu: and proposes the fix with the node id.
- ImprovedPush lists allowed values in its errors and fetches missing media from the library.
- ImprovedPush reports the page that names a section not imported.
- ImprovedForm emails to the admin now include the recipient.
- ImprovedForm errors show the cause to the admin and the developer.
- NewBlocks add 8 icons and support text transform.
- FixedThe link button no longer shows an underline.
- NewNucleo generates title, description, Open Graph and noindex. With Yoast or Rank Math active, Nucleo's SEO turns off.
- ImprovedNew menu items appear right after push.
- ImprovedTranslations are regenerated: 1793 strings, all translated.
v0.1.0Link to this version
- NewFirst release.