@lexydesign/amatista

React component library for the LexyDesign/Amatista UI system.

The package entrypoint is lib/index.ts. It imports the base CSS and re-exports the public component API from lib/components/index.ts.

Install

pnpm install

Development

pnpm storybook

Storybook reads stories from lib/**/*.stories.@(js|jsx|mjs|ts|tsx).

Tokens

This package uses Tailwind CSS v4 and loads Lexy tokens from lib/tokens.css. The token file is generated from the Kickoff template source, so do not edit it by hand.

pnpm sync:tokens

The sync command reads /home/obarria/Escritorio/Dev/kickoff-cli/template/src/app/globals.css, extracts the real @theme block, and writes lib/tokens.css.

Public API

The public API is generated. Do not edit lib/components/index.ts by hand.

pnpm sync:public-api
pnpm check:public-api

Public components are listed in scripts/public-components.mjs. Internal implementation details live under lib/vendor and should not be exported directly from the package entrypoint.

Validation

pnpm validate
pnpm build-storybook
pnpm verify:storybook-css

pnpm validate runs the library audit, public API check, tests, and package build. pnpm verify:storybook-css validates that every documented LexyDesign Storybook route renders with effective CSS and writes visual reports under reports/.

Audit

pnpm audit:library

The audit writes reports/library-audit.json and reports:

• public component count
• missing stories
• missing specs
• unclassified component folders
• empty component folders

Build

pnpm build

Build output is written to dist. Storybook static output is written to storybook-static; both are generated artifacts.

Publish To npm

The package is configured for public npm publishing as @lexydesign/amatista.

Before publishing, authenticate with npm using an account that has access to the @lexydesign scope:

npm login
npm whoami

Run the full release gate:

pnpm release:check

Create a local tarball for inspection:

pnpm release:pack

Inspect the exact files npm will publish:

npm pack --dry-run

Publish the current version:

pnpm publish

For future releases, bump the version first:

pnpm version patch
pnpm publish

The prepublishOnly script runs pnpm release:check, so npm publication fails if the library audit, public API check, tests, package build, Storybook build, or CSS verification fails.