Build from source
Use these commands to run the desktop app from the repository. You need macOS,
Git, Node ^24.22.1, and pnpm 11.10.0, as pinned in the root package.json.
Start the development app
Section titled “Start the development app”-
Clone the repository and enter its folder:
git clone https://github.com/hussainph/volli-code.gitcd volli-code -
Install dependencies:
pnpm install -
Start the app:
pnpm dev
The development loop runs the renderer with hot reload, and rebuilds and relaunches Electron after main-process changes.
Run a built copy
Section titled “Run a built copy”From the repository root:
pnpm run buildpnpm startRebuild the terminal module
Section titled “Rebuild the terminal module”node-pty must match Electron’s ABI. If the terminal fails to load after a
dependency install, rebuild it:
pnpm -C apps/desktop run rebuild:nativeThe SQLite dependency uses N-API prebuilds, so this command does not rebuild it. If dependency installation itself fails, fix the reported install error before you try to launch the app.
Preview the docs
Section titled “Preview the docs”From the repository root:
pnpm -C apps/docs devFor code conventions and focused checks, see CONTRIBUTING.md. For problems in an installed app, use Troubleshooting.