// readme

NiiVue Monorepo

Monorepo for the NiiVue ecosystem — browser-based medical image visualization.

Packages

Apps

Getting Started

Use the hot-reloadable live demos for local development—they provide the fastest feedback loop while working on the project.

git clone git@github.com:niivue/mono.git
cd mono
bun install
bunx nx build niivue
git lfs install
git lfs pull
bun run dev

Core commands include

bun install                # Install all dependencies
bunx nx build <project>    # Build a single project (builds deps first)
bunx nx run-many -t build  # Build all projects
bunx nx run-many -t test   # Run all tests

See CONTRIBUTING.md for detailed setup, tooling, and development instructions.

Releasing and Publishing

Packages are versioned and published using Nx Release via the Release GitHub workflow:

  • Release candidates are published automatically on every push to main. Each merged PR that contains releasable conventional commits produces new x.y.z-rc.N versions on the npm next dist-tag.
  • **Stable…