Astilba Create · Released
Start with a complete project, not a pile of choices.
Generate an independent TypeScript repository with pinned tooling, verification, security workflows, and explicit ownership evidence from one maintained recipe.
create-astilba 0.3.0 · four recipe v2 contracts · public on npm
01 · Fit
One verified starting point
Fits
- TypeScript libraries with package-surface checks
- React and Vite single-page applications
- Statically rendered Astro sites
- Cloudflare Worker services
- Non-interactive project creation for agents and CI
Does not fit
- Merging generated files into an existing directory
- Arbitrary framework and infrastructure combinations
- Updating or repairing a generated repository
- A programmatic generator API
- Applying hosted GitHub or deployment settings
02 · Generation boundary
Plan, validate, stage, publish
Create resolves one versioned recipe, validates the complete portable tree, and stages it beside the destination before publication.
- Resolve react-vite-spa v2RECIPE
- Validate the complete planSAFE
- Write the staging treeSTAGE
- Publish the new destinationREADY
4 maintained recipes1 ownership manifest
03 · Guarantees and costs
Failure is part of the contract
| Guarantee | Boundary made visible |
|---|---|
| The complete project is planned before Create writes it. | Invalid metadata, unsafe paths, and output collisions fail before publication. |
| A partial staging tree never passes as a complete project. | Create publishes a new destination only after files, links, modes, and optional Git initialization succeed. |
| Generated application code belongs to the project. | The manifest records seeded files as user-owned immediately; future tooling must not overwrite them. |
| A recipe is a complete maintained contract. | Create keeps the catalog small instead of promising arbitrary, unverified feature combinations. |
04 · Release state
The CLI and four recipes are released
Interactive CLIReleased
Automation JSONSchema v1
Recipe catalogSchema v1 · four recipe v2 contracts
Project manifestSchema v1
Programmatic APINot exported
Update and doctor toolingNot shipped