Every Delta site runs one of two design systems. Delta’s seed is the token system the theme ships. Your own design system is anything else: a stylesheet you already have, a framework such as Automatic.CSS or Core Framework, or a brand you describe. The agent sets it up and switches the site over.
What you can bring
- A file: a CSS file, a design.md, a token list, or a Figma link.
- A plugin or a build that already loads its CSS. Delta leaves that stylesheet alone and loads a small site.css of its own after it.
- Nothing yet: a brief, a brand, or references. The agent proposes the values and asks you to approve them.
“Use {file name} as the design system for this site.”
“Our framework plugin already loads the CSS. Switch the site to it.”
Switching from Delta’s default design system to Automatic.css? Use the recipe Switch from Delta’s default design system to Automatic.css, or watch the video Using Automatic.css as Delta’s design system.
With Automatic.css, colours are set as hex values; other colour formats are refused.
Upload a CSS file to the Media Library, or attach it in the chat. Delta checks the file and holds it until you confirm the switch. The agent does not read a stylesheet from your computer’s folders or from a URL.
How the switch runs
- The agent reads your material. It asks what you have if your request does not say.
- It shows a table. Each line names a job, such as page background, text, or links and buttons, next to your own name for it. Nine jobs are required. When your material leaves a gap, the agent proposes values in your naming and asks once for all of them.
- It asks who edits the stylesheet. Delta can manage the file, or leave it untouched and add its own rules after it.
- It saves a snapshot and asks you to confirm. The agent lists how many templates, pages, and components the switch changes. Nothing on the site changes before you say yes.
- It switches and converts. The agent converts templates and pages to your names, in batches. If the site has no templates yet, it builds the basic set in your names.
- It checks the result. The agent renders a page, a post, an archive, the header and the footer, and the store pages when WooCommerce is active.
The agent reports what it converted, what it left unchanged, and what still needs work. Components from the old design system are removed; the markup that used them stays on the page.
What stays the same
- base.css stays. It is the theme’s floor: reset, page frame, focus outline, and skip link. Your stylesheet builds on it.
- Hard-coded values in your CSS stay as they are. Turning them into variables is a separate request.
- The WooCommerce base style still applies. Store rules that lived in the old site.css go with it.
What Delta → Design shows
On the seed, the card reads Delta Seed Design System and the tiles show token values. On your own system, the card reads Your Custom Design System and each tile is named from your table. When Delta manages site.css, the tiles show your colors and fonts. When another plugin loads the CSS, they show the variable names only.
The agent sets the mode. The Design page shows it; you cannot change it there.
Going back to the seed
“Put Delta’s seed design system back.”
The agent saves a snapshot and asks you to confirm. It then restores the seed files and the seed map, and tells you what it restored. To undo a switch instead, restore the snapshot taken before it under Delta → Snapshots.
Restore Default on Delta → Design is a different action. It resets the seed’s tokens, notes, CSS, and components to the theme default. It shows only while the site is on the seed and the seed has been changed.
For PHP hooks, see Developer hooks.
For developers
- Mode lives in option
21press_delta_design_system:seedorcustom, with ownershipdeltaorexternaland the recorded source handles. delta/switch-design-systemmoves a site from the seed to a custom system in one step: it checks every name in use, saves a snapshot, renames the names, writes the map and sets the mode. Run it withdryRun: truefirst.delta/register-design-systemalso sets the mode, but renames nothing.- The filter
21press_delta_design_switch_external_namesnames the variables another plugin may use, so a switch keeps them. delta/import-site-cssruns in two calls:{mediaId}returns a hash and a report;{confirm: true, hash}makes the file the live site.css. It does not change the mode.delta/list-variableslists enqueued custom properties with their source handle and selector.delta/restore-seedrestores the seed design pack and takes a snapshot first.- The active names live in rule
design-system-map. The seed ships it; a custom system overrides it withupsert-rule, andrestore-rulebrings the seed version back.