@ui8kit/generator

Static HTML/CSS generator for UI8Kit with orchestrator pipeline.

Runtime Scope

The active pipeline is:

• Orchestrator -> CssStage -> HtmlStage -> PostCssStage
• CssService extracts classes from prepared HTML
• HtmlService wraps HTML fragments in full documents
• PostCssStage runs Tailwind + optional UnCSS

Installation

bun add @ui8kit/generator

Quick Start (CLI)

Create dist.config.json in project root:

{
  "app": { "name": "My App", "lang": "en" },
  "css": { "outputDir": "dist/css", "pureCss": true },
  "html": {
    "routes": { "/": { "title": "Home" }, "/menu": { "title": "Menu" } },
    "outputDir": "dist/html",
    "mode": "tailwind"
  },
  "postcss": { "enabled": true, "outputDir": "dist/html/css" },
  "fixtures": { "dir": "fixtures", "collections": ["menu", "recipes", "blog"] }
}

Run:

bunx ui8kit-generate static      # full pipeline
bunx ui8kit-generate html         # CSS + HTML only
bunx ui8kit-generate styles       # PostCSS only

Quick Start (API)

import { generate } from '@ui8kit/generator';

await generate({
  app: { name: 'My App', lang: 'en' },
  css: { routes: ['/'], outputDir: './dist/css', pureCss: true },
  html: {
    routes: { '/': { title: 'Home' } },
    outputDir: './dist/html',
    mode: 'tailwind',
  },
});

Common Commands (Root)

| Command | Description | |---------|-------------| | bun run generate:static | Full pipeline via CLI | | bun run generate:html | CSS + HTML only | | bun run generate:styles | PostCSS + UnCSS only |

Common Commands (Generator Dev)

| Command | Description | |---------|-------------| | bun run test | Run all tests | | bun run typecheck | TypeScript checks | | bun run test:coverage | Coverage report |

Full Documentation

See GUIDE.md for complete architecture, configuration, and troubleshooting.

For onboarding and rebrand workflows, start with:

• docs/README.md
• docs/rebrand-automation-101.md