Getting started in five minutes

Three steps in any framework: install the package, render a labelled email field and a button, and link a theme.

What you will have

A small sign-up form: a visible label tied to an email input, and a submit button. The components bring the semantic HTML, the ARIA and the keyboard behaviour; the theme brings the look. Lily ships no CSS of its own, so without a theme you get the browser's defaults, which is the point: every visual decision is yours.

Every user-facing string, the label and the button text, is yours too, so the same code works in any language.

Pick your framework

React

React 18 or 19, in Vite, Next.js or any React app.

npm install @lilydesignsystem/react-headless @lilydesignsystem/themes
import { useState } from "react";
import { Field, EmailInput, Button } from "@lilydesignsystem/react-headless";
import "@lilydesignsystem/themes/light.css";

export default function Signup() {
  const [email, setEmail] = useState("");
  return (
    <form onSubmit={(event) => event.preventDefault()}>
      <Field label="Email address" inputId="email">
        <EmailInput id="email" label="Email address" value={email} onChange={setEmail} required />
      </Field>
      <Button type="submit">Subscribe</Button>
    </form>
  );
}

onChange receives the new string, not an event.

Vue

Vue 3.4 or later, in Vite or Nuxt.

npm install @lilydesignsystem/vue-headless @lilydesignsystem/themes
<script setup>
import { ref } from "vue";
import { Field, EmailInput, Button } from "@lilydesignsystem/vue-headless";
import "@lilydesignsystem/themes/light.css";

const email = ref("");
</script>

<template>
  <form @submit.prevent>
    <Field label="Email address" input-id="email">
      <EmailInput id="email" label="Email address" v-model="email" required />
    </Field>
    <Button type="submit">Subscribe</Button>
  </form>
</template>

Svelte

Svelte 5, in SvelteKit or Vite. The package ships .svelte files for your bundler to compile.

npm install @lilydesignsystem/svelte-headless @lilydesignsystem/themes
<script>
  import { Field, EmailInput, Button } from "@lilydesignsystem/svelte-headless";
  import "@lilydesignsystem/themes/light.css";

  let email = $state("");
</script>

<form onsubmit={(event) => event.preventDefault()}>
  <Field label="Email address" inputId="email">
    <EmailInput id="email" label="Email address" bind:value={email} required />
  </Field>
  <Button type="submit">Subscribe</Button>
</form>

Solid

Solid 2.0, in Vite.

npm install @lilydesignsystem/solid-headless @lilydesignsystem/themes
import { createSignal } from "solid-js";
import { Field, EmailInput, Button } from "@lilydesignsystem/solid-headless";
import "@lilydesignsystem/themes/light.css";

export default function Signup() {
  const [email, setEmail] = createSignal("");
  return (
    <form onSubmit={(event) => event.preventDefault()}>
      <Field label="Email address" inputId="email">
        <EmailInput id="email" label="Email address" value={email()} onChange={setEmail} required />
      </Field>
      <Button type="submit">Subscribe</Button>
    </form>
  );
}

Angular

Angular 20 to 22, standalone components. Add the theme to styles in angular.json.

npm install @lilydesignsystem/angular-headless @lilydesignsystem/themes
// angular.json: "styles": ["node_modules/@lilydesignsystem/themes/dist/light.css"]
import { Component } from "@angular/core";
import { EmailInput, Button } from "@lilydesignsystem/angular-headless";

@Component({
  selector: "app-signup",
  imports: [EmailInput, Button],
  template: `
    <form (submit)="$event.preventDefault()">
      <label>
        Email address
        <lily-email-input label="Email address" [required]="true" />
      </label>
      <lily-button type="submit">Subscribe</lily-button>
    </form>
  `,
})
export class Signup {}

The visible label wraps the component, which labels the <input> inside it, in every version. From @lilydesignsystem/angular-headless 0.13.0 you can use <lily-field inputId="email"> around <lily-email-input id="email"> instead.

Web Components

Any page or framework. Importing the package registers every lily-* element.

npm install @lilydesignsystem/web-components-headless @lilydesignsystem/themes
<link rel="stylesheet" href="node_modules/@lilydesignsystem/themes/dist/light.css" />
<script type="module">
  import "@lilydesignsystem/web-components-headless";
</script>

<form>
  <label>
    Email address
    <lily-email-input label="Email address" required></lily-email-input>
  </label>
  <lily-button type="submit">Subscribe</lily-button>
</form>

The bare import needs a bundler or an import map. The wrapping label reaches the inner <input> in every version; from 0.13.0, <lily-field label="Email address"> around the input does too.

HTML

No install and no build: Lily's HTML is plain markup with class hooks. Link a theme from a CDN and write the markup.

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@lilydesignsystem/themes@0.6.2/dist/light.css" />

<form>
  <div class="field">
    <label for="email">Email address</label>
    <input class="email-input" id="email" type="email" required />
  </div>
  <button class="button" type="submit">Subscribe</button>
</form>

Every component's markup is in @lilydesignsystem/html-headless (components/{slug}.html) and on its page in the catalog.

Nunjucks

Nunjucks 3, in Eleventy or Express. Add the package's templates to your loader.

npm install @lilydesignsystem/nunjucks-headless nunjucks @lilydesignsystem/themes
// setup
const nunjucks = require("nunjucks");
const { templatesDir } = require("@lilydesignsystem/nunjucks-headless");
const env = new nunjucks.Environment(new nunjucks.FileSystemLoader([templatesDir, "views"]));

{# views/signup.njk #}
{% from "field/macro.njk" import field %}
{% from "label/macro.njk" import label %}
{% from "email-input/macro.njk" import emailInput %}
{% from "button/macro.njk" import button %}

<form method="post">
  {% call field() %}
    {{ label({ for: "email", text: "Email address" }) }}
    {{ emailInput({ id: "email", autocomplete: "email", required: true }) }}
  {% endcall %}
  {{ button({ type: "submit", text: "Subscribe" }) }}
</form>

Alpine.js

Alpine 3.14 or later. The markup is the same as HTML's; the plugin adds state and keyboard behaviour to the interactive components (menus, tabs, listboxes), so register it once.

npm install @lilydesignsystem/alpine-headless alpinejs @lilydesignsystem/themes
import Alpine from "alpinejs";
import lily from "@lilydesignsystem/alpine-headless/plugin";
import "@lilydesignsystem/themes/light.css";

Alpine.plugin(lily);
Alpine.start();

Then use the HTML form above. Each component's annotated snippet is in @lilydesignsystem/alpine-headless (components/{slug}.html). The plugin needs 0.3.1 or later.

Blazor

.NET 11, a Blazor Web App. Link the theme from wwwroot or a CDN in App.razor.

dotnet add package LilyDesignSystem.Blazor.Headless
@page "/signup"
@using LilyBlazorHeadless.Components

<form @onsubmit="Subscribe">
    <Field Label="Email address" InputId="email">
        <EmailInput id="email" Label="Email address" @bind-Value="email" required />
    </Field>
    <Button type="submit">Subscribe</Button>
</form>

@code {
    private string email = "";

    private void Subscribe() { }
}

Next steps

  • Tutorials: compose a fuller form, style it against the class hooks, and add the preference pickers.
  • Theming: the 63 themes, switching them at runtime, and writing your own.
  • Framework comparison: what each of the ten libraries covers, side by side.
  • Components: all 661, each with a live demo, its markup and its keyboard contract.
  • National identifiers (health, tax and identity numbers from 77 countries) are a separate package per framework, such as @lilydesignsystem/react-headless-identifiers.