Nerio Core 0.1.0-alpha.1
Pre-releaseNerio Core 0.1.0-alpha.1
This is the first Tailwind CSS v4-first Nerio Core prerelease. It is an alpha release: APIs and migration requirements are not frozen for 1.0.
Highlights
- Migrates all Core component style authoring to static Tailwind CSS v4 recipes.
- Keeps Nerio
--n-*variables as the canonical theme, mode, density, and customization layer. - Supports package and source-install consumers with and without Tailwind Preflight.
- Aligns the Registry, CLI, MCP discovery, documentation, and clean-consumer validation with the Tailwind-first contract.
- Includes focused fixes for Button class precedence, Sheet backdrop/RTL behavior, Toast RTL positioning, and source-install dependency closure.
Install
Install package mode from the alpha channel:
pnpm add @nerio-ui/tokens@alpha @nerio-ui/adapters@alpha @nerio-ui/registry@alpha @nerio-ui/ui@alphaInstall the CLI or MCP package when needed:
pnpm add -D @nerio-ui/cli@alpha @nerio-ui/mcp@alphaPackage consumers must import @nerio-ui/tokens/tailwind.css, import @nerio-ui/ui/styles.css, register the installed UI source with Tailwind @source, and include the Nerio packages in the supported Next.js transpilePackages configuration.
For editable source installation:
pnpm dlx @nerio-ui/cli@alpha init
pnpm dlx @nerio-ui/cli@alpha add button
pnpm dlx @nerio-ui/cli@alpha doctorUpgrade from 0.1.0-alpha.0
Follow the complete Tailwind migration report. In particular, replace the pre-migration component styling setup with the documented Tailwind bridge, remove stale copied component CSS after nerio doctor confirms the new setup, and preserve the documented Preflight ownership model.
Verification
- Candidate commit:
9bc7f526369f8bb3a123a763e903bc47d7829a63 - Signed tag:
v0.1.0-alpha.1 - All six coordinated packages were published under
alpha;latestremains on0.1.0-alpha.0. - A clean external consumer installed the public npm artifacts, exercised
nerio init,list,info,add, anddoctor, verified MCP discovery, built package and source-install usage with Next.js 16, and passed browser interaction checks. - npm registry signatures are present. This manually published alpha does not include a provenance attestation; trusted publishing remains to be configured for a future release workflow.
Known limitations
- This release is not production-stable or 1.0-compatible.
- Package distribution is source-first TypeScript; supported Next.js consumers must configure
transpilePackages. - IconButton and documented Button aliases remain temporary alpha migration compatibility.
- This release does not claim a stable API freeze, beta quality, or Nerio Pro coverage.
Please report feedback and reproducible issues in the Nerio issue tracker.