1 · Install

pnpm install

Pulls only the dev toolchain (esbuild, lightningcss, typescript). The framework itself ships with zero dependencies.

2 · Build everything

pnpm build

Splits arekui.css into src/, then minifies into dist/arekui.min.css and dist/arekui.min.js.

3 · Watch mode

pnpm dev

Runs both minifiers in watch mode and keeps src/ + site/assets/ in sync while you edit. Stop with Ctrl+C.

4 · Every script

pnpm split            # arekui.css  →  src/**/*.css
pnpm build            # everything above + minify
pnpm build:css        # minify CSS only
pnpm build:js         # minify JS only
pnpm build:sourcemap  # same, with .map files
pnpm dev              # watch mode (CSS + JS)
pnpm clean            # delete dist/
pnpm typecheck        # tsc arekui.d.ts --noEmit

5 · How the pipeline fits together

arekui.css ──pnpm split──► src/**/*.css ──pnpm build:css──► dist/arekui.min.css

Root arekui.css is the single source of truth. src/ is generated — never hand-edit it, your changes get overwritten on the next build.

6 · Custom (trimmed) build

npx arekui-build                 # reads arekui.config.js
npx arekui-build -i ./src -o ./assets
npx arekui-build --full          # ignore the scan, include everything
npx arekui-build --sourcemap

Scans your markup and writes <output>/arekui.min.css containing only the ar-* classes you actually use.

7 · Just consuming ArekUI?

npm install arekui

None of the above applies. arekui.css, arekui.js and dist/ are published prebuilt — link them and ship.