Files
jsonPrism/docs/dev_env.md
T
poli0981andClaude Opus 4.7 50521881f0 fix(release): GH Pages 404 + macOS Intel runner unavailable (#18)
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>
2026-05-13 17:26:20 +07:00

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.
# 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