# gnostic-ui

> Astro components, reusable blocks, themes, and complete site templates.

## Docs

- [Build Astro sites from source](https://ui.gnosticai.com/): Astro components, reusable page sections, and site templates with props, slots, and shared themes.

## Guides

- [Guides](https://ui.gnosticai.com/docs): Install the registry, select a theme, and build an Astro site.
- [Introduction](https://ui.gnosticai.com/docs/introduction): Use Astro source, props, slots, and shared themes to compose controls, sections, and complete sites.
- [Installation](https://ui.gnosticai.com/docs/installation): Install Astro source from the gnostic-ui registry.
- [Theming](https://ui.gnosticai.com/docs/theming): Learn how to theme your components.
- [Theme generator](https://ui.gnosticai.com/docs/theme-generator): Choose a style and palette, then export an editable theme.
- [Extended blocks](https://ui.gnosticai.com/docs/extended-blocks): Install the gallery, content, hero, feature, contact, and footer blocks from the earlier collection.
- [Credits](https://ui.gnosticai.com/docs/credits): The projects and people behind the foundation, component styles, and Astro work in gnostic-ui.

## Components

- [Components](https://ui.gnosticai.com/components): Astro source for form controls, page structure, feedback, and media, with working examples and installation commands.
- [Accordion](https://ui.gnosticai.com/components/accordion): Expandable Astro sections for grouped answers and supporting content.
- [Alert Dialog](https://ui.gnosticai.com/components/alert-dialog): Astro confirmation dialogs for actions that need an explicit decision.
- [Alert](https://ui.gnosticai.com/components/alert): Inline Astro feedback with message, action, and semantic status styles.
- [Avatar](https://ui.gnosticai.com/components/avatar): Astro profile images and text fallbacks in a shared size system.
- [Badge](https://ui.gnosticai.com/components/badge): Small Astro labels for status, category, and counts.
- [Banner](https://ui.gnosticai.com/components/banner): Astro announcement containers with optional dismissal and stored visibility.
- [Breadcrumb](https://ui.gnosticai.com/components/breadcrumb): Astro navigation links that show a page’s position in a site.
- [Button](https://ui.gnosticai.com/components/button): Native buttons and links for Astro actions, with size, variant, and loading styles.
- [Card](https://ui.gnosticai.com/components/card): Astro card sections with shared spacing, framed layouts, and optional actions.
- [Carousel](https://ui.gnosticai.com/components/carousel): Embla carousel parts for Astro image and content sequences.
- [Checkbox](https://ui.gnosticai.com/components/checkbox): Native Astro checkboxes for independent choices and form values.
- [Collapsible](https://ui.gnosticai.com/components/collapsible): One expandable Astro panel for optional detail or secondary controls.
- [Combobox](https://ui.gnosticai.com/components/combobox): A searchable Astro choice control with data-slot selection behavior.
- [Command](https://ui.gnosticai.com/components/command): Searchable Astro command lists for navigation and page actions.
- [Dialog](https://ui.gnosticai.com/components/dialog): Astro modal parts for focused tasks, forms, and detail views.
- [Drawer](https://ui.gnosticai.com/components/drawer): Astro edge panels with data-slot dragging and dismissal.
- [Dropdown Menu](https://ui.gnosticai.com/components/dropdown-menu): Astro action menus with item, checkbox, and radio compositions.
- [Empty](https://ui.gnosticai.com/components/empty): Astro empty-state parts for lists, searches, and unfinished setup.
- [Field](https://ui.gnosticai.com/components/field): Astro field layouts that connect labels, controls, descriptions, and errors.
- [Floating Input](https://ui.gnosticai.com/components/floating-input): Astro text fields with a label that moves when focused or filled.
- [Form](https://ui.gnosticai.com/components/form): Native Astro form markup with shared field spacing.
- [Frame](https://ui.gnosticai.com/components/frame): Astro frame parts for related panels, headings, and actions.
- [Group](https://ui.gnosticai.com/components/group): Joined Astro buttons and controls with shared border and radius styles.
- [Header](https://ui.gnosticai.com/components/header): Astro header parts for a site logo, navigation, and actions.
- [Hover Card](https://ui.gnosticai.com/components/hover-card): Astro link previews that show supporting information on hover or focus.
- [Icon](https://ui.gnosticai.com/components/icon): Astro icon rendering for Lucide symbols and Simple Icons brand marks.
- [Input Group](https://ui.gnosticai.com/components/input-group): Astro inputs with attached text, icons, and action controls.
- [Input](https://ui.gnosticai.com/components/input): Native Astro inputs with shared focus, error, and disabled styles.
- [Item](https://ui.gnosticai.com/components/item): Astro content rows for lists, linked summaries, and grouped details.
- [Kbd](https://ui.gnosticai.com/components/kbd): Astro keyboard key labels for shortcuts and instructions.
- [Label](https://ui.gnosticai.com/components/label): Native Astro labels that name and focus form controls.
- [Layout](https://ui.gnosticai.com/components/layout): Astro document parts for the page shell, head, body, and main content.
- [Lightbox](https://ui.gnosticai.com/components/lightbox): Astro image detail views built with the existing dialog controller.
- [Lightbox Carousel](https://ui.gnosticai.com/components/lightbox-carousel): Astro image carousels that open the chosen slide in a larger view.
- [Lightbox Grid](https://ui.gnosticai.com/components/lightbox-grid): Responsive Astro gallery grids with bento and masonry layouts.
- [Logo](https://ui.gnosticai.com/components/logo): Astro brand containers with optional home-page links.
- [Marquee](https://ui.gnosticai.com/components/marquee): Astro moving content rows with direction, duration, and spacing controls.
- [Meter](https://ui.gnosticai.com/components/meter): Astro range meters for capacity, usage, and other bounded measurements.
- [Native Select](https://ui.gnosticai.com/components/native-select): Styled native HTML select controls for Astro forms.
- [Navigation Menu](https://ui.gnosticai.com/components/navigation-menu): Astro navigation groups with links and optional popup panels.
- [Pagination](https://ui.gnosticai.com/components/pagination): Native Astro page links with current-page and previous/next styles.
- [Popover](https://ui.gnosticai.com/components/popover): Astro floating panels opened by a labelled control.
- [Price](https://ui.gnosticai.com/components/price): Astro parts for amounts, currency labels, and billing periods.
- [Progress](https://ui.gnosticai.com/components/progress): Astro progress tracks for a known value or an unknown completion time.
- [Radio Group](https://ui.gnosticai.com/components/radio-group): Astro radio choices for one selected value in a related set.
- [Rating](https://ui.gnosticai.com/components/rating): Astro star displays for an existing rating value.
- [Resizable](https://ui.gnosticai.com/components/resizable): Astro panels with pointer and keyboard size controls.
- [Scroll Area](https://ui.gnosticai.com/components/scroll-area): Native scrolling for Astro panels, with custom tracks, keyboard access, and optional edge fades.
- [Section](https://ui.gnosticai.com/components/section): Astro section parts for page headings, content, and actions.
- [Select](https://ui.gnosticai.com/components/select): Astro selection popups with labelled options and data-slot behavior.
- [Segmented Control](https://ui.gnosticai.com/components/segmented-control): Shared Astro style recipes for related radio choices, navigation links, and pressed buttons.
- [Separator](https://ui.gnosticai.com/components/separator): Astro dividers for visual grouping or a semantic content boundary.
- [Sheet](https://ui.gnosticai.com/components/sheet): Astro side panels for secondary tasks and compact navigation.
- [Sidebar](https://ui.gnosticai.com/components/sidebar): Astro sidebar parts for navigation, grouped links, and layout controls.
- [Skeleton](https://ui.gnosticai.com/components/skeleton): Astro placeholder shapes that reserve space while content loads.
- [Slider](https://ui.gnosticai.com/components/slider): Astro range controls with data-slot pointer and keyboard input.
- [Spinner](https://ui.gnosticai.com/components/spinner): Astro activity indicators for pending controls and page regions.
- [Switch](https://ui.gnosticai.com/components/switch): Astro on/off controls for settings with data-slot state handling.
- [Table](https://ui.gnosticai.com/components/table): Semantic Astro table parts for records and comparisons.
- [Tabs](https://ui.gnosticai.com/components/tabs): Astro tab panels with shared pill and underline appearances.
- [Textarea](https://ui.gnosticai.com/components/textarea): Native Astro multiline fields with shared focus and error styles.
- [Theme Toggle](https://ui.gnosticai.com/components/theme-toggle): Astro controls for switching between light and dark color modes.
- [Theme Switcher](https://ui.gnosticai.com/components/theme-switcher): Astro controls for previewing color palettes and component appearances.
- [Toc](https://ui.gnosticai.com/components/toc): Astro table-of-contents links for headings within a page.
- [Toggle](https://ui.gnosticai.com/components/toggle): Astro pressed-state buttons for local on/off actions.
- [Tooltip](https://ui.gnosticai.com/components/tooltip): Astro hints for hover and keyboard focus on a labelled control.
- [Typography](https://ui.gnosticai.com/components/typography): Astro prose styles and text parts for articles and documentation.
- [Video](https://ui.gnosticai.com/components/video): Responsive Astro YouTube embeds from supported video URLs.

## Patterns

- [Patterns](https://ui.gnosticai.com/patterns): Background patterns that fill a positioned parent.
- [Dot Pattern](https://ui.gnosticai.com/patterns/dot-pattern): A dot background that fills its container.
- [Dot Pattern with Glow](https://ui.gnosticai.com/patterns/dot-pattern-with-glow): A dot background that reveals a colored glow under the pointer.
- [Grid Pattern](https://ui.gnosticai.com/patterns/grid-pattern): An SVG grid background that fills its container and can highlight selected squares.

## Blocks

- [Blocks](https://ui.gnosticai.com/blocks): Reusable Astro page sections for site navigation, content, media, forms, and footers.
- [Article](https://ui.gnosticai.com/blocks/article): Astro article layouts with author details, lead images, and reading content.
- [Articles](https://ui.gnosticai.com/blocks/articles): Astro article listings for posts, notes, and editorial collections.
- [Banner](https://ui.gnosticai.com/blocks/banner): Astro announcement strips for short messages and a related destination.
- [Contact](https://ui.gnosticai.com/blocks/contact): Astro contact sections with labelled fields, links, and message forms.
- [Content](https://ui.gnosticai.com/blocks/content): Astro media-and-text sections for explanations, stories, and project details.
- [Cta](https://ui.gnosticai.com/blocks/cta): Astro call-to-action sections with a clear next step and optional supporting evidence.
- [Doc](https://ui.gnosticai.com/blocks/doc): Astro reference-page layouts with contents links and previous/next navigation.
- [Faqs](https://ui.gnosticai.com/blocks/faqs): Astro question-and-answer sections using the existing disclosure controls.
- [Features](https://ui.gnosticai.com/blocks/features): Astro feature sections with icons, media, and grouped explanations.
- [Footer](https://ui.gnosticai.com/blocks/footer): Astro site footers with grouped links, brand details, and contact routes.
- [Gallery](https://ui.gnosticai.com/blocks/gallery): Astro image galleries with a centered project carousel and text overlays.
- [Header](https://ui.gnosticai.com/blocks/header): Astro site headers with desktop navigation and mobile menu options.
- [Hero](https://ui.gnosticai.com/blocks/hero): Astro hero sections for a clear page heading, supporting media, and primary action.
- [Links](https://ui.gnosticai.com/blocks/links): Astro resource lists and link collections with optional destination previews.
- [Logos](https://ui.gnosticai.com/blocks/logos): Astro logo collections for named customers, partners, and integrations.
- [Mobile Menu](https://ui.gnosticai.com/blocks/mobile-menu): Astro mobile navigation panels with labelled triggers and grouped links.
- [Pricing](https://ui.gnosticai.com/blocks/pricing): Astro pricing sections with plan details, feature lists, and action links.
- [Product](https://ui.gnosticai.com/blocks/product): Astro product detail sections with media, price text, and actions.
- [Products](https://ui.gnosticai.com/blocks/products): Astro product collections with images, descriptions, and price displays.
- [Reviews](https://ui.gnosticai.com/blocks/reviews): Astro review sections with quotes, attribution, and optional rating displays.
- [Services](https://ui.gnosticai.com/blocks/services): Astro service sections for offers, project work, and enquiry routes.

## Examples

- [Example overview](https://ui.gnosticai.com/examples/overview): See Astro controls and reusable sections assembled with sample page content.

## Agent resources

- [llms-full.txt](https://ui.gnosticai.com/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://ui.gnosticai.com/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://ui.gnosticai.com/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://ui.gnosticai.com/openapi.json.
- [API catalog](https://ui.gnosticai.com/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://ui.gnosticai.com/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://ui.gnosticai.com/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://ui.gnosticai.com/sitemap.xml): Every indexable page URL with its last-modified date.