What it does
Most apps built with an AI agent share one look: the same grey cards, the same blue button, the same radius. Ingot UI already gives your agent 6 complete dashboard systems instead of improvised markup. This tool takes one of them and makes it yours. From a brand colour and four choices it writes the whole --fu-* token set the components read:
- Accent: an 11-step scale, the button fill and its text colour, a soft tint, and an accent text colour that passes AA on white and on the tint.
- Neutrals: page, surface, lines and text greys, neutral or tinted warm, cool or toward your brand.
- Charts: five series colours led by your brand, ordered so neighbours stay apart for colour-blind readers.
- Shape and type: five corner radii, one of four widely used sans fonts, and a spacing base for compact or comfortable layouts.
How to use the export
- 1CSS variables. Save the file as styles/ingot/<name>.css and import it after your base Ingot token file. Its values win, and it is also scoped to data-system="<name>" if you want it on one area only.
- 2Tailwind v4. A standalone @theme block with resolved values. Use it when you want the fu-* utilities in a Tailwind project without the Ingot theme bridge.
- 3JSON tokens. W3C design tokens (DTCG) grouped into colour, radius, font, spacing and shadow, the format Figma variable import plugins such as Tokens Studio read.
- 4Prompt for your agent. A ready message that tells your agent to run init_project through the Ingot MCP server, add the theme file and record it in INGOT.md.
Every file starts with a link back to your settings, and the address bar always holds a shareable link to the current theme. New to the setup? The docs cover installing tokens by hand, and the MCP page shows how to connect Claude Code, Cursor, Codex or VS Code.
How it checks your theme
The contrast panel shows the real ratio for each pairing a dashboard uses: button text on the accent, accent text on white and on its tint, headings, body and muted text on the page and surface, and accent shapes on white. Text must reach 4.5:1 and shapes 3:1 (WCAG 2.2 AA). When a value would fail, the generator moves only its lightness, keeping hue and saturation, until it passes, and tells you what it changed. The chart colours can be previewed through protanopia, deuteranopia and tritanopia simulations.
Read more about how token-based theming works in the guide to dashboard design system tokens, or start from a finished look on the systems page.
FAQ
Is the theme generator free?
Yes. It runs in your browser, needs no account, and the files it exports are yours to use in any project.
Can I use the export without Ingot UI components?
Yes. The CSS file is plain CSS variables and the Tailwind v4 block gives you utilities such as bg-fu-surface, text-fu-ink and rounded-fu-md in any Tailwind v4 project. Ingot components read the same variables, so they pick the theme up with no changes.
How are the contrast checks done?
With the WCAG 2.2 contrast formula: text needs 4.5:1 and shapes such as switches need 3:1. If white text fails on your brand colour, buttons use the nearest deeper shade that passes, and your exact colour stays in charts and tints. Muted text and accent text are darkened just enough to pass on every background they sit on.
How are the chart colours picked?
Series 1 is your brand colour. The next four come from a colour-blind-safe set (Okabe–Ito plus a few product hues), each chosen to be the furthest from the colours already picked when seen with protanopia or deuteranopia (Machado 2009 simulation). The preview can show the whole dashboard through those simulations.
What does density change?
It sets Tailwind v4's --spacing base: 0.25rem for comfortable, 0.225rem for compact. Every padding, gap and height utility scales from it, so the same components get about 10% tighter without any code change.
How do I get my AI agent to use the theme?
Copy the Prompt for your agent tab into Claude Code, Cursor, Codex or VS Code with the Ingot UI MCP server connected. It calls init_project, saves your theme file after the base tokens, loads the font and adds a rule to INGOT.md so later sessions keep using it.
Is there a dark mode?
Not yet. The Ingot systems are light mode today, and dark mode is the first planned update. The generator will get a dark theme output when the systems do.