create-poops

Scaffold a new poops static-site project from the shitstorm templates.

npm create poops@latest my-app

You'll be prompted to pick a template. Then:

cd my-app
npm install
npm run dev

Templates

| Name | Ships with | | --- | --- | | base | clean poops starter | | sulphuris | + sulphuris CSS framework, book-of-spells | | hat | + htmx, Alpine.js, Tailwind |

Skip the prompt by naming the template as the second argument:

npm create poops my-app hat

For scripts/CI you can also use the explicit --template flag (needs -- so npm doesn't eat it):

npm create poops my-app -- --template hat

Each run pulls the latest template with a shallow git clone, then drops the .git directory so you start from a clean history. No dependencies — needs git on your PATH.

Options

• Omit the target to scaffold into the current directory (must be empty; pass --force to override).
• Pin a tag or branch: POOPS_REF=v1.2.0 npm create poops my-app. Commit SHAs won't work — a shallow clone can only fetch a named ref.