create-nico-umbraco

Scaffold a pre-configured NICO Umbraco 17 website (nav, footer, uSync, Tailwind).

Maintainer workflow

1. Update the reference Umbraco project as usual.
2. Refresh the bundled template:

npm run scaffold:sync

3. Test locally:

cd packages/create-nico-umbraco
npm link
cd ../..
npx create-nico-umbraco ../test-site --name "Test Client"

4. Publish to npm:

cd packages/create-nico-umbraco
npm publish

Consumer usage

npx create-nico-umbraco my-client-site --name "My Client"
cd my-client-site
npm run dev

Then complete Umbraco install in the browser at /umbraco. uSync imports nav/footer schema on first boot.

The scaffold creates umbraco/Data/ automatically. If you see SQLite Error 14: unable to open database file, ensure that folder exists.

What gets copied

• Umbraco project + uSync (siteSettings, nav/footer element types, content)
• Views (_Layout, MainNav, HomeNav, Footer, mobile drawer)
• Tailwind CSS + motion scripts
• Starter media assets

Options

| Flag | Description | |------|-------------| | --name "Display Name" | Human-readable project name | | --skip-install | Copy files only; skip npm/dotnet install |