Singularity Components

React + Tailwind 4 design system (sg: prefix). Storybook is the source of truth for component APIs. How this repo is hosted on the droplet lives in singularity-filion-docs (pnpm dev → http://localhost:5173).

Agent and Storybook MCP conventions are in AGENTS.md.

Local

pnpm storybook          # http://localhost:6006 (MCP at /mcp)
pnpm storybook:build
pnpm biome:check        # lint, format, organize imports
pnpm build              # library to dist/

Export new public components from main.ts so they land in the package build.

Pack locally

pnpm pack
# or: pnpm pack --dry-run

Creates singularity-components-<version>.tgz. In blog or tools:

{
  "dependencies": {
    "singularity-components": "file:../path-to-tarball/singularity-components-1.X.X.tgz"
  }
}

Or point at the sibling checkout: "singularity-components": "file:../../singularity-components".

Publish to npm

pnpm login
pnpm publish

Platform docs

| Topic | Page | | --- | --- | | This service | docs/projects/components.md | | Hosted Storybook / MCP | docs/architecture/request-flow.md | | Deploy pipeline | docs/droplet/deployment.md |