Vastu
A small design system of web components, built with Lit. Every promise it makes, from its API and keyboard behaviour to its theming hooks and usage guidance, is written once in a machine-readable manifest. Docs, agent tools and tests are all generated from that one description.
The name comes from Vastu Shastra, the ancient Indian science of space, layout and proportion. Components take their whole look from a brand: Vastu, in sandstone and indigo, is the default, and Lekha, in paper and teal, is the second. Every brand has light, dark and high-contrast modes. Switch brand and mode at the top of the page; no component changes between them.
Components
- Button
<va-button>Starts an action, or submits or resets the form it is in.
Save changes Cancel Learn more Delete project - Checkbox
<va-checkbox>Lets the user choose an option, or agree to something, as part of a form.
Include archived projects Send me a copy We'll email it to the address on your account. Select all (some selected) Not available on your plan - Dialog
<va-dialog>Asks the user to confirm, decide or enter something before going back to the page.
Delete project “Atlas” and its 14 files will be deleted for everyone. You can't undo this.
Cancel Delete project - Menu
<va-menu>Opens a short list of actions from a button, such as Edit, Duplicate and Delete.
- Switch
<va-switch>Turns a setting on or off, with immediate effect.
Email notifications Dark theme Uses darker colours for this page. Sync (needs an account) - Tabs
<va-tabs>Switches between panels of related content in the same place on the page.
Your name, photo and bio.
Choose what we email you about.
Plan, invoices and payment method.
- Text field
<va-text-field>Collects a short piece of text, such as a name, an email address or a search term.
- Toast
<va-toast>Shows short status messages, such as "Changes saved", without interrupting the user.
Save Copy link Simulate an error
Status
Milestone M1: eight components, each checked on every change by contract tests generated from the manifest, behaviour tests, axe accessibility checks in every mode, visual regression at phone and desktop widths, size budgets, and a strict Content Security Policy with Trusted Types, in Chromium, Firefox and WebKit. Next is the agent layer: a markup validator, an MCP server and an eval. Read thedesign document.