GitHub Pages serves at /jsonPrism/ (case-sensitive, mirrors the repo name `poli0981/jsonPrism`). Our Vite `base` was set to `/jsonprism/` (lowercase), so index.html referenced `/jsonprism/assets/*.js` and every asset 404'd — the deployed page rendered blank. Rebase all GitHub URLs / Vite base / React Router basename to match the existing repo case `jsonPrism`. Renaming the repo to all-lowercase is the cleaner long-term fix, but that's a user-side action. GitHub Actions `macos-13` runners no longer pick up jobs (the macOS Intel build sat queued for >18 min, then was cancelled). Replace the two-entry matrix (macos-14 ARM + macos-13 Intel) with a single universal2 build on `macos-14` using `--target universal-apple-darwin`. The resulting `.app` / `.dmg` runs on both Apple Silicon and Intel. Storage keys, package name, Tauri identifier remain lowercase (`jsonprism`) — unaffected. Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1.9 KiB
1.9 KiB
Developer environment
This is the toolchain the maintainer keeps installed for JSONPrism + sibling projects. It is not a strict requirement for contributing — most contributors only need the Web app column.
Required for the web app
| Tool | Minimum | Latest exercised | Notes |
|---|---|---|---|
| Node.js | 22.11.0 LTS | 25.8.1 | Set in package.json engines.node. |
| npm | bundled with Node | — | npm ci is what CI runs. |
| Git | recent (≥ 2.40) | — | Commit signing (commit.gpgsign=true) recommended. |
Required for the Tauri desktop build
In addition to the web app deps:
| Tool | Minimum | Notes |
|---|---|---|
| Rust | 1.77 (per Cargo.toml) |
Install via rustup; stable channel. |
| Platform build deps | OS-specific | See README.md § Desktop app for the full list. |
Other tooling on the maintainer's machine
These are unrelated to JSONPrism but documented so anyone reproducing the broader dev environment knows what's around:
- Python: 3.12.x, 3.14.x (used for adjacent scripting projects).
- .NET: 8.x, 9.x, 10.x, 11.x (preview) — for sibling AutoClickForge / PhantomMAC projects.
- GPG: commit signing enabled (
commit.gpgsign=true).
IDEs
- JetBrains WebStorm (2026.x) — primary IDE; runs Prettier + ESLint on save.
- Visual Studio Code — secondary; useful for the Tauri/Rust side via
rust-analyzer.
Recommended workflow
# One-time
git clone https://github.com/poli0981/jsonPrism.git
cd jsonprism
npm install
# Daily
npm run dev # web dev server, http://localhost:5173
# Before pushing
npm run format
npm run typecheck
npm run lint
npm test
npm run build
Related docs
- docs/pc_spec.md — hardware reference.
- docs/TAURI-NOTES.md — Tauri-specific notes.
- README.md — project overview + quick start.
- Tiếng Việt