Skip to main content
astrocraft-ui/ components · 101

Alert

Free · MIT

Headless, accessible, and styled entirely through the attribute surface below — bring your own CSS system, or start from the reference theme.

Install

Without a flag you get no styling at all — plain HTML carrying the attribute surface below. --theme copies the same theme in two dialects;--bridge lumos re-points either one onto Lumos for Astro's tokens (it needs a theme to re-point, and Lumos itself, already in your project).

Unstyled — behavior only, you write the CSS

Install command
npx astrocraft-ui add display/alert

Plain-CSS theme — no build step

Install command
npx astrocraft-ui add display/alert --theme css

Tailwind theme — needs Tailwind v4

Install command
npx astrocraft-ui add display/alert --theme tailwind

Plain-CSS theme, re-pointed onto Lumos tokens

Install command
npx astrocraft-ui add display/alert --theme css --bridge lumos

Tailwind theme, re-pointed onto Lumos tokens

Install command
npx astrocraft-ui add display/alert --theme tailwind --bridge lumos

Live demo

Alert

info:This is a info alert message.
success:This is a success alert message.
warning:This is a warning alert message.
error:This is a error alert message.

Attribute surface

With no class-merging machinery, these attributes are the whole extension point. State is a data-attribute or a native attribute; visibility is the hiddenattribute. Generated from source by pnpm slots.

ComponentSlotsVariantsRuntime stateNative state
`Alert.astro``alert``data-variant`: `info` · `success` · `warning` · `error`——

Source

What the command copies — 2 files, alias-free so the copy lands standing alone. This is the whole component; there is nothing else.

src/components/ui/display/alert/Alert.astro
---
// src/components/ui/display/alert/Alert.astro — headless primitive (see ../../README.md).
// Static, role="alert"; semantic tone via `variant`, exposed as `data-variant`.
import type { HTMLAttributes } from "astro/types";

type Props = HTMLAttributes<"div"> & {
  variant?: "info" | "success" | "warning" | "error";
};

const { variant = "info", class: className, ...rest } = Astro.props;
---

<div class={className} role="alert" data-slot="alert" data-variant={variant} {...rest}>
  <slot />
</div>
src/components/ui/display/alert/index.ts
import Alert from "./Alert.astro";

export { Alert };
export default Alert;

What you get

The component source, copied into your project by npx astrocraft-ui add display/alert — no package dependency, no CSS to fight. Whatever the paid blocks compose, this is it.