repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

docs: track packaging TODOs

a92b5e98080db68736eda5851caa1c8a1ad33939

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (1)

TODO.md

Added
new file mode 100644
1 +# TODO
3 +## Pi package install
5 +- Stop using Pi `npmCommand` as prefix workaround:
7 + ```json
8 + "npmCommand": ["npm", "--prefix", "/home/me/.local"]
9 + ```
11 +- Configure npm user prefix instead:
13 + ```bash
14 + npm config set prefix ~/.local
15 + ```
17 +- Ensure `~/.local/bin` is in `PATH`.
18 +- Use plain Pi npm command or remove setting:
20 + ```json
21 + "npmCommand": ["npm"]
22 + ```
24 +## pi-ext packaging
26 +- Make root package a workspace package:
28 + ```json
29 + {
30 + "private": true,
31 + "type": "module",
32 + "workspaces": ["extensions/*"]
33 + }
34 + ```
36 +- Keep runtime deps in each extension package.
37 +- Run from repo root:
39 + ```bash
40 + bun install
41 + ```
43 +- Commit root lockfile.
45 +## Fresh machine bootstrap
47 +```bash
48 +git clone ... ~/Workspace/pi-ext
49 +cd ~/Workspace/pi-ext
50 +bun install
51 +```
53 +For other users, prefer git package install:
55 +```bash
56 +pi install git:github.com/bugabinga/pi-ext@v0.0.3
57 +```