create-easy-web
pnpm create @easy-webStatus
Section titled “Status”In development. @easy-web/create is currently a stub. The interactive scaffold CLI is not yet published.
When complete, running pnpm create @easy-web will interactively scaffold a new site instance from the dev.ismaili.de pilot template. The planned flow:
- Prompt for instance details — site name, domain, Entra tenant ID, Azure subscription, Azure DevOps project
- Clone the pilot template — seeds the new repo from
dev.ismaili.de’s scaffold - Wire package dependencies — updates
package.jsonto consume the latest@easy-web/*packages from npm - Generate environment files — creates
.env.examplepre-filled with all required variable names - Optionally generate Decap CMS config — calls
@easy-web/cms-adapters’sgenerateDecapConfigwith the provided tenant details - Print next steps — Azure DevOps pipeline registration, SWA deployment, Entra app registration
Instance lifecycle
Section titled “Instance lifecycle”The scaffold automates the manual steps currently documented in websites/docs/architecture/instance-lifecycle.md. Each scaffolded instance:
- Consumes
@easy-web/*packages via npm (no source copies) - Gets its own Azure Static Web Apps deployment via the shared pipeline templates in
websites/pipelines/ - Uses the
websites/scripts/new-site.ps1bootstrap until the CLI is ready
Roadmap
Section titled “Roadmap”The CLI will be released after the dev.ismaili.de scaffold stabilises at v1.0. Follow the easy-web changelog for release announcements.
Related
Section titled “Related”- Instance lifecycle docs — manual steps the CLI will automate
dev.ismaili.de— the pilot instance used as the scaffold templatewebsites/scripts/new-site.ps1— current PowerShell bootstrap automation