---
url: /en/repo/settings.md
description: >
  You can customize repository page UI elements by adding a `.cnb/settings.yml`
  configuration file to the repository root, including workspace launch, Issue,
  Fork, and copy-repo buttons, as well as NPC, reaction images, and auto-tag
  settings.
---
Add a `.cnb/settings.yml` file to the repository root to customize page UI. All parameters are optional.

The complete configuration example below covers all customization categories. Each category
can be configured as needed, with unconfigured items using default values.

**Workspace, Issue, Fork, Copy Repo buttons**:

```yaml title=".cnb/settings.yml"
# Cloud-native development configuration (reads from the branch where the launch button is located)
workspace:
  launch:
    button:
      name: Launch Cloud-Native Development
      description: Click this button to launch the cloud-native development environment
      hoverImage: .cnb/launch-hover.gif
    cpus: 4
    disabled: false
    autoOpenWebIDE: false

# Issue configuration (reads from the default branch)
issue:
  button:
    description: ~bug~ Here you go!
    hoverImage: https://cnb.cool/my/test/-/git/raw/main/issue-hover.png

# Fork configuration (reads from the default branch)
fork:
  button:
    description: Nice repo you've got. Now it's mine.
    hoverImage: ".cnb/fork-hover.png"

# Copy Repo button configuration (reads from the default branch)
copyRepo:
  button:
    description: Your repo is great, now it's mine
    hoverImage: ".cnb/copy-hover.png"
```

**Reaction image, Tag auto-generation**:

```yaml title=".cnb/settings.yml"
# Reaction custom image
reaction:
  bug:
    image: .cnb/bug.gif

# Tag configuration (reads from the default branch)
tag:
  auto_tag:
    branch: hotfix
```

**NPC Configuration**:

```yaml title=".cnb/settings.yml"
npc:
  imports:
    list:
      - cnb/docs
  roles:
    - name: Code Assistant
      slogan: code is cheap, show me your prompt
      prompt: You are now Code Assistant, focused on helping write and optimize code
      enableThinking: false
      avatar:
        src: ".cnb/knowledge-base-hover.png"
    - name: Reviewer
      prompt: |
        You are a code reviewer, focused on code quality review and improvement suggestions.
  defaultRepo: "cnb/docs"
  defaultRole: "Reviewer"
  button:
    name: "Quick Ask AI"
    description: "Click, start AI!"
    hoverImage: ".cnb/knowledge-base-hover.png"
```

:::tip
If the file fails to parse or exceeds the size limit, the configuration will not take effect.
:::

## Customization Categories

UI customization supports the following categories. Click to view detailed configuration for each:

| Category                                           | Description                                             | Config Branch    |
|----------------------------------------------------|---------------------------------------------------------|------------------|
| [Cloud-Native Development Button](./settings-workspace.md) | Button name, description, hover image, CPU cores, etc.  | Current branch   |
| [Issue Button](./settings-issue.md)                | Create Issue button description and hover image         | Default branch   |
| [Fork Button](./settings-fork.md)                  | Fork button description and hover image                 | Default branch   |
| [Copy Repo Button](./settings-copy-repo.md)        | Copy Repo button description and hover image            | Default branch   |
| [Reaction Custom Image](./settings-reaction.md)    | Replace the default image in the reaction feature       | Default branch   |
| [Tag Auto-Generation](./settings-tag.md)           | Branch that triggers automatic tag creation             | Default branch   |
| [NPC Configuration](./settings-npc.md)             | AI roles, knowledge base, prompts, etc.                 | Default branch   |