Export your sheet as CLAUDE.md, AGENTS.md and tokens
Download a Wuizard sheet as a zip with CLAUDE.md, AGENTS.md, CSS and Tailwind tokens, your slot components and whole pages, ready to drop into a repo.
The Wuizard team5 min read
On this page
Connecting your agent over MCP is the live way to use a sheet. Exporting is the same thing as files: your agent instructions, design tokens, components and pages in a folder you drop into your repo. It suits projects where an MCP connection isn't an option, and it's a good companion to one, because the instructions then travel with the code.
Download the zip#
- Open the sheet and click Export at the top. The export panel opens on that sheet. To export another sheet, open that one.
- Check the file tree. It lists what the zip will hold, including how many components and which whole pages. Need one file only? The same panel downloads or copies CLAUDE.md, AGENTS.md or the tokens (CSS, Tailwind v4 or v3, JSON or SwiftUI) on their own.
- Click the download button. The file is named after the sheet, such as
my-app-wuizard.zip.
Exporting isn't metered. The zip is built when you ask for it, so it always reflects the sheet as it is at that moment.
What's inside#
Everything sits in one folder named after the sheet:
README.md- What it's forSetup in four steps, a table of every slot and its file, and the pages and media in the zip
CLAUDE.md,AGENTS.md- What it's forHow your agent should build UI in this project (identical files)
tokens/tokens.css- What it's forYour foundations as CSS variables
tokens/tokens.json- What it's forThe same values as JSON, for scripts and other tools
tokens/tailwind-v4.css- What it's forA Tailwind v4
@themeblock
tokens/tailwind.config.js- What it's forA Tailwind v3 config
tokens/WuizardTokens.swift- What it's forThe tokens for SwiftUI
components/wuizard/- What it's forOne file per filled slot, rendered with your values
pages/- What it's forEach whole page the sheet can already build
slots.json- What it's forWhich asset and version fills each slot, and its file
ATTRIBUTION.md- What it's forWhere each component comes from
media/- What it's forThe sheet's generated images and animations, with
media.json
The pages/ and media/ folders only appear when the sheet has pages ready or media made.
Set it up in your project#
The README in the zip has these steps too.
1. Load the tokens once#
- Tailwind v4: paste
tokens/tailwind-v4.cssinto your global CSS, after@import "tailwindcss";. - Tailwind v3: merge
tokens/tailwind.config.jsinto your config, and importtokens/tokens.cssas well. - Anything else: import
tokens/tokens.css, or readtokens/tokens.json. - SwiftUI: add
tokens/WuizardTokens.swiftto your project.
@import "tailwindcss";
/* paste the contents of tokens/tailwind-v4.css here */2. Install the animation library#
The components are React with Tailwind and Motion, so install Motion if your project doesn't have it:
npm i motion3. Copy the components#
Copy components/wuizard/ into your source tree. Use the components as they are: their values are the ones chosen in the sheet, and every one respects reduced motion.
4. Add the agent instructions#
Put CLAUDE.md or AGENTS.md at the root of your repo, so your coding agent reads it at the start of every session.
What CLAUDE.md tells your agent#
The file starts by saying the project's UI is defined by a Wuizard sheet, and that the agent should use the MCP server if it's connected and the exported files if not. Then it lists how to build UI in the project:
- Use only the sheet's tokens. Never introduce new colours, radii, fonts, spacing, shadows or springs.
- For anything that has a slot, call
get_slotor use the exported file instead of writing it. - For a whole page, call
get_page. - Not a React project? Use
translate_assetfor Vue, Svelte, SwiftUI or vanilla JS. - Keep the reduced-motion fallback every component ships with.
- If something is missing, search the library and ask before adding to the sheet.
- Run
check_uion new components before finishing a screen.
After that come your own rules from the sheet, your foundations, the filled slots and any attribution. To grab just this file, open the sheet's CLAUDE.md tab, which has Copy and Download buttons. Connected agents can also read it as an MCP resource.
Whole pages and media#
A whole page is included once all its required sections are filled (the sheet's Pages tab shows which are ready). Page files import their sections from @/components/wuizard/, so point that alias at the components folder or edit the imports. Sections show neutral placeholder text until you pass your real copy, plans and numbers as props.
Generated images and animations come in media/, with readable file names. Copy them into public/ or your asset folder; media/media.json says what each one shows. The media guide covers making them.
Not on React?#
The tokens work anywhere: CSS variables, JSON or SwiftUI. The components in the zip are React. For Vue, Svelte, SwiftUI or plain JavaScript, a connected agent can call translate_asset for any slot, and every asset page in the library has the same translations. New translations are metered; ones already made are free. The docs have the details.
Keep the export up to date#
The zip is a snapshot. When you change the sheet, export again and replace the folder. Because slots.json records each asset's id and version, your diff shows exactly which components changed.
If your agent is also connected over MCP, it reads the live sheet whenever it calls a tool, so it stays current between exports. The connection guide sets that up. To understand why a sheet works better than pasting a component library into a project, read component libraries vs a design sheet.
Questions
Should I export or connect over MCP?
Both work, and many projects use both. MCP always serves the live sheet and lets the agent search the library or review its own work with check_ui. The export is a snapshot in your repo that works with any tool, offline, and shows up in code review.
Does exporting use credits?
No. Exporting isn't metered, so it doesn't spend trial credits or any monthly allowance. Export as often as you like.
Can I edit the exported components?
Yes, they're plain source files. If you change a value you want to keep, such as a colour or a radius, change it in the sheet too, so your next export and your agent agree with the code.
What's the difference between CLAUDE.md and AGENTS.md?
Only the name. The two files have the same contents. Some agents look for one name and some for the other, so the zip has both and you keep whichever your tools read.
In the library