Installation and Setup

Prepare your environment and launch Vibecanvas locally.

This guide helps you get Vibecanvas running reliably on a new machine.

1) Install Bun

Follow the Bun install guide, then verify:

bun --version

2) Install Vibecanvas globally

Choose the package manager you already use:

bun add -g vibecanvas

npm i -g vibecanvas

pnpm add -g vibecanvas

3) Verify the CLI is available

vibecanvas --version

4) Launch from your project

cd your-project
vibecanvas

Running vibecanvas starts the serve command by default.

To choose a port explicitly:

vibecanvas serve --port 3001

The default port is 3000 in development and 7496 in compiled builds.

5) Verify core behavior

• App opens with canvas and side panels.
• Chat can start a new conversation.
• Project files appear in the workspace tree.

6) Keep Vibecanvas updated

vibecanvas upgrade --check
vibecanvas upgrade

To install a specific release:

vibecanvas --upgrade 0.2.0-beta.3

If you need the full command list:

vibecanvas --help

If one of these fails, ask in Discussions:

• https://github.com/vibecanvas/vibecanvas/discussions