| name | setup |
| description | Clone Strudel repo, install dependencies, and start the dev server. Use when setting up the project for the first time. |
Strudel Setup
Execute these steps in order:
-
Check prerequisites:
node --version
pnpm --version
If pnpm is missing, run npm install -g pnpm.
-
Clone from Codeberg (NOT GitHub — the GitHub mirror is archived):
git clone https://codeberg.org/uzu/strudel.git
-
Install dependencies:
cd strudel && pnpm i
-
Start dev server:
pnpm dev
This runs jsdoc-json generation first, then starts the Astro dev server for the REPL.
-
Verify: Open the URL shown in terminal (usually http://localhost:4321). The Strudel REPL should load.
-
Tell the user to open the browser and try typing sound("bd sd hh sd") in the REPL, then press Ctrl+Enter to hear a basic drum pattern.
If any step fails, diagnose before proceeding. Common issues:
- Node version too old →
nvm use 18 or install Node 20+
- Port conflict → check
lsof -i :4321
- pnpm lockfile issues →
rm -rf node_modules && pnpm i