Skip to content

Nerio Core 0.1.0-alpha.1

Pre-release
Pre-release

Choose a tag to compare

@vpavlov-me vpavlov-me released this 19 Jul 12:07
· 148 commits to main since this release
v0.1.0-alpha.1
9bc7f52

Nerio 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@alpha

Install the CLI or MCP package when needed:

pnpm add -D @nerio-ui/cli@alpha @nerio-ui/mcp@alpha

Package 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 doctor

Upgrade 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; latest remains on 0.1.0-alpha.0.
  • A clean external consumer installed the public npm artifacts, exercised nerio init, list, info, add, and doctor, 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.