create-idia-app

Scaffold an Expo + React Navigation consumer app with @idia-ui/core and @idia-ui/theme.

Published on npm as create-idia-app (Track C Phase 5).

Quick start (npm)

npx create-idia-app@latest my-app
cd my-app
pnpm dev
pnpm exec idia-ui doctor
pnpm exec idia-ui add storybook
pnpm run build-storybook

Build (monorepo)

From repo root:

node scripts/sync-consumer-template.mjs
pnpm --filter create-idia-app build

prebuild copies templates/consumer-app/ into packages/create-idia-app/template/.

Flags

| Flag | Behavior | |------|----------| | --pm <pnpm\|npm\|yarn> | Override package manager | | --skip-install | Skip install + doctor | | --force | Overwrite existing directory | | --no-git | Skip git init | | --with-storybook | Run idia-ui add storybook after install | | --with-brain | Run idia-ui add brain after install (Tier 1G experimental) |

Pure npm e2e (post–Phase 5)

No tarball overrides — uses public registry only.

cd $env:TEMP
npx create-idia-app@latest my-e2e-app --pm pnpm
cd my-e2e-app
pnpm install
pnpm exec idia-ui doctor
pnpm exec idia-ui add storybook
pnpm run build-storybook
# Verify button docs fragment in static output:
Select-String -Path storybook-static\**\*.js -Pattern "triggers an action" -List

Expected: doctor exit 0; add storybook exit 0; build-storybook exit 0; grep finds Button story prose.

Late-install fixture (RFC §26.3 row 4)

Proves Storybook add-on on an aged scaffold (not --with-storybook at create time).

cd $env:TEMP
npx create-idia-app@latest my-late-storybook --pm pnpm
cd my-late-storybook
pnpm install
pnpm exec idia-ui doctor
# Do NOT add storybook yet — simulate aged project (optional: wait or pin older @idia-ui/core patch)
pnpm exec idia-ui add storybook
pnpm run build-storybook
Select-String -Path storybook-static\**\*.js -Pattern "triggers an action" -List

Use a runtime-only scaffold ([email protected]+ without pre-polluted .storybook/). If the template already contains Storybook artifacts, add storybook idempotently skips — use a fresh scaffold or remove .storybook/ and storybook devDeps first.

Maintainer e2e (pre-publish tarballs)

When testing unpublished CLI changes inside the monorepo:

pnpm --filter @idia-ui/cli build
pnpm --filter create-idia-app build
node packages/create-idia-app/dist/index.js my-cli-test --skip-install

create-idia-app auto-detects packages/cli/dist/cli.js for doctor during monorepo smoke (no npm install of @idia-ui/cli required).

Generated app contract

• package.json name + @idia-ui/* pinned to ^0.2.0
• @idia-ui/cli in devDependencies at ^0.2.2
• app.json name / slug / scheme renamed from my-idia-app
• .idia/manifest.json stub with idiaCli + core versions
• Post-install: idia-ui doctor (non-strict) unless --skip-install

Version coupling

[email protected] generates apps targeting @idia-ui/[email protected] and @idia-ui/cli@^0.2.2.