Packages Overview

Packages are organized by responsibility.

libs/ core packages

These packages define the manifest contract, compile manifests, and render applications.

Package	Role
@ikary/cell-contract	Zod schemas, TypeScript types, structural and semantic validation
@ikary/cell-loader	YAML and JSON parsing, meta-property stripping, validation pipeline
@ikary/cell-engine	Compilation, normalization, field derivation, path builders
@ikary/cell-presentation	Zod schemas for UI primitive contracts
@ikary/cell-primitives	React primitive components, resolvers, adapters, registry
@ikary/cell-data	Data providers and entity data hooks
@ikary/cell-renderer	Top-level CellAppRenderer and page rendering runtime

See Loading & Validation for the full contract pipeline API.

apps/ executable packages

These packages run as applications or CLIs.

Package	Role
@ikary/cli	ikary CLI for scaffolding, validation, compilation, local stack commands, and primitives tooling
@ikary/ikary	Thin npm wrapper that exposes the same ikary command
@ikary/cell-runtime-api	Local runtime REST API service generated from manifests
@ikary/cell-preview-server	Local preview server used by the local stack
@ikary/mcp-server	Contract Intelligence API and MCP server

Dependency graph

graph TD
    contract[contract] --> loader[loader]
    contract --> engine[engine]
    contract --> presentation[presentation]
    contract --> primitives[primitives]
    presentation --> primitives
    primitives --> renderer[renderer]
    primitives --> data[data]
    engine --> renderer

Processing pipeline

flowchart TD
    A[YAML file] -->|load| B[loader]
    B -->|parse| C[contract]
    C -->|validate| D[engine]
    D -->|compile| E[Runtime CellManifestV1]

import { loadManifestFromFile } from '@ikary/cell-loader';
import { compileCellApp } from '@ikary/cell-engine';

const loaded = await loadManifestFromFile('manifest.yaml');
if (loaded.valid) {
  const compiled = compileCellApp(loaded.manifest!);
}

Build commands

pnpm build
pnpm test
pnpm typecheck