fix: repair pipe test and document Bash NVM setup

This commit is contained in:
tothbt committed 2026-10-23 21:08:47 +02:00
1 parent 326575e55d
commit 1d660a3c40
5 files changed
+119 -56

No files matched your search

+37 -20
View File
@@ -35,39 +35,52 @@ For desktop development, also install:
## Install
Select the project Node.js version before running any npm command. `.nvmrc` declares `lts/jod`:
These commands target **Bash** (Linux, macOS, or Windows WSL). From fish,
start `bash` first. Follow the [shell and NVM setup](docs/development.md#shell-and-nvm-setup)
before continuing. If Bash NVM is missing, agents must ask permission before
installing it. `.nvmrc` declares `lts/jod`:
```sh
nvm install
nvm use
npm ci
```bash
export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
. "$NVM_DIR/nvm.sh"
nvm install lts/jod
nvm use lts/jod && npm ci
```
Run `nvm use` again after opening a new shell or after switching Node.js versions for another project.
Each npm command block loads Bash NVM explicitly and selects the required Node
version, including in fresh noninteractive shells.
If Ionic CLI is not already installed:
```sh
npm install --global @ionic/cli
```bash
export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
. "$NVM_DIR/nvm.sh"
nvm use lts/jod && npm install --global @ionic/cli
```
## Web development
```sh
npm start
```bash
export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
. "$NVM_DIR/nvm.sh"
nvm use lts/jod && npm start
```
Build the Angular application:
```sh
npm run build
```bash
export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
. "$NVM_DIR/nvm.sh"
nvm use lts/jod && npm run build
```
Run linting and tests:
```sh
npm run lint
npm test
```bash
export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
. "$NVM_DIR/nvm.sh"
nvm use lts/jod && npm run lint
nvm use lts/jod && npm test
```
`npm test` starts Karma in its configured mode and may remain open in watch mode.
@@ -82,15 +95,19 @@ For VS Code, the recommended extension is `esbenp.prettier-vscode`. Use **Format
The Tauri CLI is available through:
```sh
npm run tauri -- <command>
```bash
export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
. "$NVM_DIR/nvm.sh"
nvm use lts/jod && npm run tauri -- <command>
```
For example:
```sh
npm run tauri -- dev
npm run tauri -- build
```bash
export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
. "$NVM_DIR/nvm.sh"
nvm use lts/jod && npm run tauri -- dev
nvm use lts/jod && npm run tauri -- build
```
> Tauri development intentionally uses `http://localhost:8103`. The current `npm start` script does not explicitly select that port, so verify that Ionic is listening on `8103` when using `tauri dev`.