docs: track packaging TODOs
a92b5e98080db68736eda5851caa1c8a1ad33939
Oliver Jan Krylow <oliver@bugabinga.net> · 2026-05-28 19:44 UTC
unsigned 1 parent
repositories / pi-ext
pi-ext
bugabingas pi extensions
owned by admin
Changed files (1)
TODO.md
ready@@ -1,0 +1,57 @@
+# TODO
+
+## Pi package install
+
+- Stop using Pi `npmCommand` as prefix workaround:
+
+ ```json
+ "npmCommand": ["npm", "--prefix", "/home/me/.local"]
+ ```
+
+- Configure npm user prefix instead:
+
+ ```bash
+ npm config set prefix ~/.local
+ ```
+
+- Ensure `~/.local/bin` is in `PATH`.
+- Use plain Pi npm command or remove setting:
+
+ ```json
+ "npmCommand": ["npm"]
+ ```
+
+## pi-ext packaging
+
+- Make root package a workspace package:
+
+ ```json
+ {
+ "private": true,
+ "type": "module",
+ "workspaces": ["extensions/*"]
+ }
+ ```
+
+- Keep runtime deps in each extension package.
+- Run from repo root:
+
+ ```bash
+ bun install
+ ```
+
+- Commit root lockfile.
+
+## Fresh machine bootstrap
+
+```bash
+git clone ... ~/Workspace/pi-ext
+cd ~/Workspace/pi-ext
+bun install
+```
+
+For other users, prefer git package install:
+
+```bash
+pi install git:github.com/bugabinga/pi-ext@v0.0.3
+```