# Bud

> A companion for reviewing a web project with your team and your agents.

## App

- [Introduction](/docs/app.md): Bud is a companion for reviewing a web project with your team and your agents.

### Getting started

- [Installation](/docs/app/getting-started/installation.md): Add Bud to a Vite project without changing how you develop it.
- [Configuration](/docs/app/getting-started/configuration.md): Choose the routes on your canvas, Bud's screens and how Bud connects to your app.
- [Vite and custom servers](/docs/app/getting-started/vite.md): How Bud connects to your pages, and what a custom server needs to do.

### Guides

- [Pages](/docs/app/guides/pages.md): Browse your live site inside Bud, page by page, in tabs.
- [Canvas](/docs/app/guides/canvas.md): See every page side by side as up-to-date screenshots, and zoom from overview to detail.
- [Comments](/docs/app/guides/comments.md): Pin a conversation to a page or to lines of code, and move it to a decision.
- [Files](/docs/app/guides/files.md): Browse, edit and review your project's code next to its pages.
- [Tasks](/docs/app/guides/tasks.md): Plan the work on a board backed by your project's Beads issues.
- [Task designs](/docs/app/guides/task-designs.md): Change how tasks look while keeping the same storage and operations.
- [Storage](/docs/app/guides/storage.md): Choose where tasks and discussions are stored. Bud is the interface, not the database.
- [Pickers](/docs/app/guides/pickers.md): How comments find the element they point at, and how to bring your own picker.
- [Factory](/docs/app/guides/factory.md): Turn comments into tasks that coding agents finish in sandboxes, reviewed before anything is pushed.

### Collaboration

- [Sharing](/docs/app/collaboration/sharing.md): Tasks and discussions travel with your Beads workspace when you choose to sync.
- [Working with agents](/docs/app/collaboration/agents.md): Hand a conversation to your own coding agent, or let Bud run one on a task.
- [Hosting on Cloudflare](/docs/app/collaboration/hosting.md): Share the canvas, pages, tasks and agents with your whole team on Cloudflare, always available, with every branch captured in its own container.
- [Troubleshooting](/docs/app/troubleshooting.md): Fix connection, comment and sync problems.