Skip to main content
Version: 0.2

Installation

Clone the repository and install JavaScript dependencies with pnpm:

git clone https://github.com/exepert/exepert.git
cd exepert
pnpm install

pnpm install only fetches the JavaScript dependencies. The WebAssembly module is produced separately by the build:wasm script, which the dev and build commands run automatically. To compile it on its own:

pnpm run build:wasm

This runs wasm-pack build rust/brain_sim --target web --release and writes the generated module to rust/brain_sim/pkg/ (gitignored). The front end imports it from there:

src/brain.ts
import init, { World } from '../rust/brain_sim/pkg/brain_sim'
import wasmUrl from '../rust/brain_sim/pkg/brain_sim_bg.wasm?url'

If rust/brain_sim/pkg/ is missing, the front-end build will fail to resolve those imports: run pnpm run build:wasm (or just pnpm dev) to generate it.

What gets installed​

The runtime dependencies are intentionally small:

  • three@0.170.0: rendering.
  • lil-gui: the settings panel.
  • stats.js: the FPS/frame-time overlay.

Everything else (Vite, TypeScript, Vitest, the legacy/WASM plugins) is a dev dependency.

Next: run the app with Development.