Skip to content
FluxPlugs

Development environment

The monorepo contains TypeScript packages, a React/Tauri desktop application, and Rust installation code. Documentation is a separate Astro project.

Prerequisites

Section titled “Prerequisites”

Use Node.js 22.12+, pnpm 10.15.1, stable Rust, and Git. Install the Windows or Linux Tauri native prerequisites. CI runs on Windows and Ubuntu.

On Linux, Electron integration tests also need a graphical display or xvfb. The CI workflow records the additional system packages used by the test runners.

Build the application

Section titled “Build the application”

From the directory containing the root package.json:

Terminal window
pnpm install --frozen-lockfile
pnpm build
pnpm --filter @fluxplugs/injector-ui tauri dev

In Windows PowerShell, use pnpm.cmd if execution policy blocks pnpm.ps1. The Tauri development command runs its configured frontend/runtime/catalog preparation before launching the native app.

Build documentation separately

Section titled “Build documentation separately”
Terminal window
pnpm --dir docs install --frozen-lockfile
pnpm --dir docs build
pnpm --dir docs check:links

The docs folder has its own lockfile and workspace configuration. Root pnpm install does not install the website’s dependencies.

For background documentation development use pnpm –dir docs exec astro dev –background. Manage it with astro dev status, astro dev logs, and astro dev stop through the same pnpm invocation.

Generated output

Section titled “Generated output”

Runtime bundles, catalogs, TypeScript declarations, native targets, and Electron fixtures are build artifacts. Do not edit them as the source of a change. Generated contract types are the exception: regenerate them through the documented command and commit the expected diff.