> ## Documentation Index
> Fetch the complete documentation index at: https://sonamu.cartanova.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> How to install Sonamu VS Code Extension

Here's how to install the VS Code extension for Sonamu development.

## Install from Marketplace

You can install directly from the [VS Code Marketplace](https://marketplace.cursorapi.com/items/?itemName=CartaNova.sonamu).

1. Open Extensions tab in VS Code (Cmd+Shift+X)
2. Search for "Sonamu"
3. Click Install button

<Frame caption="Search Sonamu Extension in Marketplace">
  <img src="https://mintcdn.com/cartanova-7788888c/gHShQ4W7H-WpAKgp/images/vscode-extension4.png?fit=max&auto=format&n=gHShQ4W7H-WpAKgp&q=85&s=7fe848d39a2732b9c3e306844a4fd560" alt="Search Sonamu Extension in Marketplace" width="2340" height="1890" data-path="images/vscode-extension4.png" />
</Frame>

## Build and Install Manually

You can also build from source code and install:

```bash theme={null}
cd ~/Projects/vscode-sonamu
pnpm install && pnpm build
cd packages/extension && pnpm package
code --install-extension sonamu-*.vsix
```

### Update

To update an already installed Extension, add the `--force` option:

```bash theme={null}
code --install-extension sonamu-*.vsix --force
```

## Verify Activation

Once the Extension is properly installed, it automatically activates when there's a `sonamu.config.ts` file in the workspace.

You can verify activation as follows:

1. Open Command Palette (Cmd+Shift+P)
2. Type "Sonamu"
3. Check if Sonamu-related commands are displayed

<Frame caption="Verify Sonamu Commands">
  <img src="https://mintcdn.com/cartanova-7788888c/gHShQ4W7H-WpAKgp/images/vscode-extension5.png?fit=max&auto=format&n=gHShQ4W7H-WpAKgp&q=85&s=a1a4db6f3ea8a3a42d8ed8ef608624eb" alt="Verify Sonamu Commands" width="1410" height="400" data-path="images/vscode-extension5.png" />
</Frame>