@polygonschmied/stellar-core

React UI components for Stellar DS — built on top of Radix UI with the Paper / Clay / Theater material system.

Install

pnpm add @polygonschmied/stellar-core @polygonschmied/stellar-tokens

stellar-tokens is a hard requirement — its CSS provides every variable the components reference at runtime.

Peer dependencies: react >= 18, react-dom >= 18. The Table component additionally needs @tanstack/react-table ^8 (optional peer — only install if you use Table).

Use

// once, at your app root
import "@polygonschmied/stellar-tokens/styles.css";

// anywhere
import { Button } from "@polygonschmied/stellar-core";

export function Save() {
  return <Button variant="primary">Save</Button>;
}

What's inside

Around 45 components, grouped below:

• Inputs — Button, Input, Textarea, Checkbox, RadioGroup, Switch, Select, Slider, Segmented, Datepicker, FormField
• Overlays — Dialog, Drawer, DropdownMenu, ContextMenu, Tooltip, Toast, Portal
• Navigation — Tabs, Accordion, Stepper, Tree (inline rename, drag-and-drop, row virtualization, async lazy-loading, search), Breadcrumbs, Pagination
• Data — Table, Avatar, Badge, Chip, Skeleton, EmptyState, ProgressBar, Spinner
• Layout — Stack, Inline, Container, AspectRatio, Divider

See src/index.ts for the full export list, or the playground Storybook for live demos.

Machine-readable / LLM reference

The package ships a component reference generated from the source at build time, so it never drifts. Point an editor, agent, or LLM at it:

// Markdown reference — every component with its props, types, and defaults
import ref from "@polygonschmied/stellar-core/llms.txt";

// Same data, structured for tooling
import catalog from "@polygonschmied/stellar-core/components.json";

Props inherited from native elements / Radix (className, style, ref, on*, …) are omitted from the reference — they pass through normally. For when-to-use-which-component guidance and the material rules, see the stellar-design skill.

License

MIT — see the repo README for the wider picture.