Skip to content
delta

How Seed design system upgrades work

The Seed design system is Delta’s default design system. It has its own version number, separate from the theme’s.

The Seed is the base, so it does not change often. It does grow. Sometimes a change to its tokens, templates or CSS needs an adjustment. A new Seed version carries that adjustment.

Your site keeps its own copy

When a site starts, Delta copies the Seed into the site. A theme update does not rewrite that copy, so your site looks the same after an update.

When a new version comes

Your agent can see when your site is behind the Seed. It tells you and offers to upgrade. Nothing happens until you say yes.

Before it changes anything, the agent shows you what a visitor would see change. Then the upgrade works like this:

  • What you never changed follows the new Seed.
  • What you changed or added stays as you made it.
  • Nothing you have is removed.

Your pages, templates and notes are not touched.

“Upgrade the site to the new Seed. Show me what changes first.”

If you want to go back

Delta takes a snapshot before the upgrade. Ask the agent to restore that snapshot and your site is as it was.

After an upgrade, look at a long text page and a page with a contrast section. New spacing can change how they sit.

For developers

  • The Seed version is the version field of tokens.json. The site’s copy lives in uploads/21press-delta.
  • get-design-context returns tokensVersion, seedTokensVersion and, when the site is behind, seedUpgrade.
  • The upgrade first shows the visible changes and writes nothing. After you say yes, it takes a snapshot, then writes.
  • It does a three-way merge of tokens.json, site.css and the component recipes: the Seed the site started from, the site’s file, the new Seed.
  • If a write fails, Delta restores the files. After a finished upgrade, restore-snapshot with the returned id undoes it.
  • restore-seed is not an upgrade. It replaces the whole design pack with the current Seed, your changes included. Take a snapshot first.

Related