BetaPublic beta — Read the release notes
Solidiom
Get Started
Documentation
← Changelog

Solidiom Beta 1

0.0.1-beta.1beta

Solidiom Beta 1

Version: 0.0.1-beta.1 Date: August 7, 2026 Status: Public Beta

Beta 1 marks the completion of the full catalog. Every layer — primitives, components, blocks, templates, and themes — meets the M4 Definition of Done and is ready for public evaluation.

What’s New

Complete Catalog

  • 52 primitives — Headless, accessible building blocks with full accessibility evidence. Every primitive includes keyboard interaction contracts, ARIA semantics enforced at compile time, and committed axe-core scan results.
  • 30 components — Styled recipe wrappers for CSS, Tailwind, and UnoCSS. Compose primitives with layout, semantic styling slots, and variant support.
  • 36 blocks — Page-level composables with loading, empty, error, and restricted states. Covering authentication, settings, billing, observability, and enterprise workflows.
  • 29 templates — Full application starters with routing, state, and theming. Balanced and Enterprise portfolios for SaaS, internal tools, and commerce.
  • 4 theme presets — Ocean, Forest, Slate, and Aurora. All meet WCAG AA contrast compliance for light and dark modes.

Accessibility

Every primitive is verified through three layers:

  1. axe-core automated scanning in real browsers
  2. Keyboard contracts tested with simulated key events
  3. VoiceOver evidence captured and committed as artifacts

ARIA semantics are enforced at compile time via TypeScript generics — missing attributes cause build errors.

Bilingual

All documentation and user-facing content available in English and Spanish. Translation completeness verified at build time: zero stale, zero missing.

CLI with Registry Integrity

The Solidiom CLI creates projects, adds primitives, and manages your workspace. Registry packages are signed with Ed25519 keys and verified with Sigstore-based provenance.

solidiom create my-app
solidiom add accordion
solidiom verify --registry

Three Styling Recipes

Supported recipe wrappers are available as CSS, Tailwind, and UnoCSS outputs. A given registry primitive may not have a Styled* wrapper in every profile.

  • CSS — Native custom properties and BEM-style class names
  • Tailwind — Tailwind CSS utility composition
  • UnoCSS — UnoCSS atomic class mapping

Cross-Browser

Beta 1 is certified on two rendering engines:

  • Chromium — Chrome, Edge, and Chromium-based browsers fully supported
  • Firefox — Gecko engine fully supported

WebKit (Safari) testing is currently blocked by system-level dependency constraints. WebKit support is targeted for the next beta release once those dependencies resolve.

Getting Started

Install

npx @solidiom/cli create my-app
cd my-app
pnpm install
pnpm run dev

Add Your First Primitive

solidiom add accordion

The CLI adds the requested deliverable and any selected styling profile; recipe wrappers are available only for the supported primitive set.

Available Commands

CommandDescription
solidiom create <name>Scaffold a new project
solidiom add <primitive>Add a primitive to your workspace
solidiom verify --registryVerify registry integrity

Known Limitations

Solid 2 Beta Dependency

Solidiom is built on Solid 2, which is itself in beta. API changes in Solid 2 may cascade to Solidiom primitives.

Deferred to Post-Beta

  • Zoom — Content zoom beyond 200% not tested for all primitives
  • Contrast — AAA contrast; current target is AA
  • Reduced motion — prefers-reduced-motion adaptations not comprehensive
  • Screen readers — VoiceOnly VoiceOver tested; NVDA, JAWS, TalkBack deferred
  • Touch — Touch interaction patterns not yet verified

API Stability

The public API may change between beta releases. No breaking changes are expected within the beta track.

Upgrade Path

Updates between beta releases follow the changesets workflow:

npm update @solidiom/*

No breaking changes in this initial beta release.

Feedback