@yca-software/2chi-core

Platform kit library for 2chi TanStack Start apps — UI primitives, server helpers, Prisma fragments, and 22 feature kits.

Install

pnpm add @yca-software/2chi-core

Import styles in your app:

import '@yca-software/2chi-core/styles.css';

Peers: react, react-dom, zod

Usage

Prefer subpath imports:

import { Button } from '@yca-software/2chi-core/ui';
import { registerKits } from '@yca-software/2chi-core/kit';
import { kitRegistryMap } from '@yca-software/2chi-core/kits/registry';
import { KitPage } from '@yca-software/2chi-core/kits/org';

| Subpath | Contents | |---------|----------| | /ui | Button, Input, Card, PageLoader, … | | /forms | EmailField, PasswordField | | /patterns | QueryState, KitPageShell | | /marketing | Hero, Footer | | /server | AppError, context helpers | | /kit | registerKits, ChiKit types | | /kits/registry | All kit metadata | | /kits/<id> | Kit-specific UI + server exports |

See docs/SIMPLICITY.md and per-kit src/kits/<id>/README.md.

Development

pnpm install
pnpm run build
pnpm run ci

Release

Publishing is automated when you create a GitHub Release:

1. Bump version in package.json
2. Commit and push to main
3. Tag vX.Y.Z and publish the release (or push the tag)

CI runs lint, types, tests, build, then publishes to npm with provenance.

Requires: NPM_TOKEN secret in the GitHub repo (Automation token with publish access to @yca-software scope).

Related

• CLI scaffold: @yca-software/2chi-create-app
• Platform guide: 2chi-stack docs/PLATFORM_GUIDE.md (dev workspace)