wangdequan/Web_FreeCAD_Bitbybit
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

P0: pin project runtime and document FreeCAD parity plan

Browse Source
This commit is contained in:
wangdequan
2026-08-02 08:47:06 -04:00
parent 23b7f58df5
commit a9f4ff752d
17 changed files with 540 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
README.md
View File

@@ -15,16 +15,16 @@ The current milestone is a facade-first integration slice. Part Design document
## Development
```bash
npm install
npm run dev
./npmw install
./npmw run dev
```
Node.js 22 or newer is the supported development baseline, matching the SQLite WASM package engine requirement.
The repository uses a project-local, checksum-verified Node.js `22.23.2` runtime and npm `10.9.8`. The wrapper downloads it to the ignored `.runtime/` directory and never changes `/usr/bin/node`; this removes the engine warning caused by running npm with an older system Node. `./nodew` runs the same pinned Node directly. See [docs/project-runtime.zh-CN.md](docs/project-runtime.zh-CN.md) for recovery and CI rules.
Build verification:
```bash
npm run build
./npmw run verify
```
The SQLite OPFS worker requires cross-origin isolation headers. Vite dev and preview apply `Cross-Origin-Opener-Policy: same-origin` and `Cross-Origin-Embedder-Policy: require-corp`; deployments must preserve them.