Skip to content

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.

  1. Clone the repository and enter its folder:

    git clone https://github.com/hussainph/volli-code.git
    cd volli-code
  2. Install dependencies:

    pnpm install
  3. Start the app:

    pnpm dev

The development loop runs the renderer with hot reload, and rebuilds and relaunches Electron after main-process changes.

From the repository root:

pnpm run build
pnpm start

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:native

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

From the repository root:

pnpm -C apps/docs dev

For code conventions and focused checks, see CONTRIBUTING.md. For problems in an installed app, use Troubleshooting.