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

# Customize Vibely

> Tune the product to match how you build — appearance, skills, notifications, referrals, and workspace branding.

Vibely ships opinionated defaults so you can build right away — but almost every default is yours to change. This section is the map of what you can customize, and where.

## Three scopes

Your customizations live at one of three levels. Picking the right scope decides who sees the change and where it follows you.

<CardGroup cols={3}>
  <Card title="Account" icon="user">
    Personal to you. Follows you across every workspace.
  </Card>

  <Card title="Workspace" icon="building">
    Shared across everyone in the workspace. Admin-only to edit.
  </Card>

  <Card title="Project" icon="folder">
    Lives in the project repo. Travels with `git clone`.
  </Card>
</CardGroup>

| Setting                       | Scope     | Where to change it                                             |
| ----------------------------- | --------- | -------------------------------------------------------------- |
| Theme (light / dark / system) | Account   | Bottom of sidebar → **Appearance**                             |
| Notification channels         | Account   | Settings → **Notifications**                                   |
| Generation-complete sound     | Account   | Settings → **Account**                                         |
| Knowledge bundles             | Workspace | Settings → **Knowledge**                                       |
| Skills                        | Workspace | Settings → **Skills**                                          |
| Branded URL                   | Workspace | <small>Settings → Workspace Settings → **Branded URL**</small> |
| People                        | Workspace | Settings → **People** (admin)                                  |
| Groups                        | Workspace | Settings → **Groups** (admin)                                  |
| Privacy & Security            | Workspace | Settings → **Privacy & Security**                              |

## What you'll find here

<CardGroup cols={2}>
  <Card title="Appearance" icon="palette" href="/docs/customize/appearance">
    Light, dark, and system theme — how it persists and where it follows you.
  </Card>

  <Card title="Skills" icon="wand-magic-sparkles" href="/docs/customize/skills">
    Reusable instruction bundles the agent loads on demand — invoke from the composer with `/skill-name`.
  </Card>

  <Card title="Notifications" icon="bell" href="/docs/customize/notifications">
    Email, push, in-chat — what fires what, and how to mute the noise.
  </Card>

  <Card title="Referrals" icon="gift" href="/docs/customize/referrals">
    Share Vibely from the header dialog. 100 credits per paid referral.
  </Card>

  <Card title="Workspace" icon="building" href="/docs/customize/workspace">
    Workspace name, avatar, public username, and invite behavior.
  </Card>
</CardGroup>

## A reasonable starting point

If you've just signed up and want to set things up the way most people prefer, do these three in order:

1. Pick a theme — `Bottom of sidebar → Appearance → Dark / Light / System`. See [Appearance](/docs/customize/appearance).
2. Mute the notification channels you don't need. See [Notifications](/docs/customize/notifications).
3. If you're on a team, set the workspace avatar and name so builds are easy to identify. See [Workspace](/docs/customize/workspace).

Total time: under five minutes.

## A note on scope

* **Account** settings (theme, notifications) follow *you* across every workspace you belong to.
* **Workspace** settings (Knowledge, Skills, Permissions, SSO, Security Center, Workspace Templates, Branded URL) apply to *everyone* in the workspace — most are admin-only to edit.
* **Project** settings (design tokens, theme.css, environment) live in the project repo and travel with `git clone`.

When a knob exists in more than one place, the most specific scope wins.