@axonyx/ui
v0.0.32
Published
Framework-agnostic CSS and JS package for Axonyx UI Foundry.
Downloads
3,097
Maintainers
Readme
Axonyx UI
Axonyx UI is the design-system layer for the Axonyx ecosystem.
Website: https://axonyx.dev
It is built on the Foundry design language: a system-oriented visual language for builders, with engineered surfaces, signal-driven states, and metal-inspired themes.
Purpose
Axonyx UI defines the visual contract for Axonyx primitives so projects like axonyx-site can import a stable, reusable UI layer instead of carrying page-specific styling.
Foundry
Foundry is the design language behind Axonyx UI.
Core ideas:
- engineered surfaces instead of floating paper
- signal-driven accent color instead of decorative color usage
- structured dark foundations for serious interfaces
- semantic primitives that map cleanly from
.ax - theme finishes inspired by metal: Bronze, Silver, and Gold
Initial Scope
The stable primitive set is growing around:
ContainerGridCardCopyButtonBadgeAlertField,Input,Textarea,SelectCheckbox,Radio,SwitchBreadcrumbsButtonGroupTabsAccordionDropdownDialogTooltipCodeBlockPropsTableIcon
The first themes are:
bronzesilvergold
Theme Model
Themes do not change component structure.
They only change token values such as:
- background
- surface
- border
- text
- accent
- link
- panel treatment
Theme is applied at the document root:
<html data-theme="silver">Projects should load one global stylesheet in the shell or layout, not inside each page body:
<link rel="stylesheet" href="/css/axonyx-ui/index.css" />Rendering Contract
The first stable Foundry contract for .ax primitives is:
Container max: "xl"-><div class="ax-container" data-max="xl">Grid cols: 2, gap: "lg"-><div class="ax-grid" data-cols="2" data-gap="lg">Card title: "..."-><article class="ax-card"><h2 class="ax-card__title">...</h2>...Copy tone: "lead"-><p class="ax-copy" data-tone="lead">...</p>Copy -> "..."-><p class="ax-copy">...</p>
CSS Files
src/css/
tokens.css
themes.css
layout.css
card.css
copy.css
links.css
button.css
button-group.css
breadcrumbs.css
radio.css
icons.css
index.cssFoundry .ax Components
The repo can also expose package-importable .ax components for Axonyx apps:
src/foundry/
Container.ax
Grid.ax
Badge.ax
Chip.ax
Avatar.ax
Divider.ax
Field.ax
Input.ax
Textarea.ax
Select.ax
Option.ax
Checkbox.ax
Radio.ax
Switch.ax
Breadcrumbs.ax
ButtonGroup.ax
LinkButton.ax
IconButton.ax
Section.ax
Cluster.ax
AppShell.ax
Table.ax
List.ax
ListItem.ax
EmptyState.ax
Skeleton.ax
Progress.ax
StatusLamp.ax
Stat.ax
Pagination.ax
Tooltip.ax
SiteShell.ax
HeroCard.ax
ContentGrid.ax
Stack.ax
SectionCard.ax
Button.ax
TextLink.ax
FeatureSection.ax
PageHeader.ax
DocsSection.ax
DocsCallout.ax
DocsNav.ax
DocsCodeBlock.ax
CommandList.axExample import:
import { SectionCard } from "@axonyx/ui/foundry/SectionCard.ax"React to Axonyx adapter coverage lives in:
docs/react-ax-adapter-map.mdNamed slot example:
import { FeatureSection } from "@axonyx/ui/foundry/FeatureSection.ax"
<FeatureSection title="Build with slots">
<Copy slot="eyebrow">Foundry</Copy>
<Copy>Default body content still flows through the main slot.</Copy>
<a slot="actions" href="/docs">Open docs</a>
</FeatureSection>