Documentation

Introduction

Astro UI is a component library for Astro: accessible, token-themed components that render on the server and progressively enhance where a platform primitive needs it.

Get startedComponents

Philosophy

Server-rendered by default

Components are .astro files that output HTML. There is no client runtime to adopt and no hydration cost to pay.

Platform over abstraction

Native elements own behavior: <dialog> handles modality, <details> handles disclosure, radios handle rating. The library styles and wires — it doesn't reimplement.

Tokens are the API

Theming isn't a config file; it's CSS. Override a custom property and every component that reads it follows — including blocks and future ones.

Guides

Get startedInstall the package, import the token layer, and render your first component in a minute.StylingThe token model: CSS custom properties for every color, radius, and space — and how to override them.Design principlesWhat astro-ui guarantees — zero JS, tokens, accessibility, composable pieces — and how each rule is enforced.RepositoryWorkspace layout: the library package, the demo app, how they link, and the workflow for each side.RTLLogical CSS properties throughout. What mirrors automatically and the few physical exceptions.ChangelogRelease-by-release history following Keep a Changelog.ReleasesRelease highlights by version, with what's new at a glance.RoadmapShipped, in progress, and planned work for the library.

Community & support

Astro UI is MIT-licensed open source. Report bugs and request features on GitHub; for Astro framework questions, theAstro Discordis the place.