create-hile

create-hile

Scaffold Hile applications and monorepos from maintained templates.

This README is intentionally short and example-first. The complete AI-facing guide ships in AI.md in this package.

When To Use

Use create-hile when starting a new Hile application or workspace.

Install

npx create-hile create my-app

Copy-Paste Example

Create a project:

npx create-hile create my-app
cd my-app
pnpm install
pnpm run dev

Skip dependency install:

npx create-hile create my-app --skip-install

Boundaries

• Do not use generated templates as the final architecture for complex apps without introducing models, services, and context boundaries.

• Do not trust stale template README files if they mention unrelated application domains; regenerate or rewrite them from current template files.

• Leaving template package versions stale after publishing new Hile packages.

• Shipping template READMEs copied from unrelated projects.

• Starting production without running the build command required by the selected template.

Verify

• New project has "type": "module".
• Dev script runs hile start --dev.
• Production script runs hile start after build.
• rsc-host is the only public HTTP owner; rsc-plugin starts only an internal micro listener.
• RSC templates pin React 19.2.8 exactly and verify plugin artifacts before startup.
• The RSC plugin template does not install Next; only the host pins the supported Next adapter version.
• Boot files default-export defineService(...).

More Context

• AI.md in this package: full package-local AI guide.
• Root llms-full.txt: full monorepo AI context.
• Root references/: source files copied from docs/ai.