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

# README button

> Add a "Build with Ona" button to your repository README for one-click environment creation.

Add a badge to your repository README so contributors can open the project in an Ona environment with one click. The badge links to `app.ona.com/#<repository-url>` — Ona clones the repo, applies your [Dev Container](/ona/configuration/devcontainer/overview) configuration, and starts the environment automatically.

![Build with Ona](https://ona.com/build-with-ona.svg)

## Markdown

```markdown theme={null}
[![Build with Ona](https://ona.com/build-with-ona.svg)](https://app.ona.com/#<your-repository-url>)
```

Replace `<your-repository-url>` with the full URL to your repository on any [supported SCM provider](/ona/source-control/overview). For example:

```markdown theme={null}
[![Build with Ona](https://ona.com/build-with-ona.svg)](https://app.ona.com/#https://github.com/gitpod-io/empty)
```

## HTML

```html theme={null}
<a href="https://app.ona.com/#<your-repository-url>">
  <img src="https://ona.com/build-with-ona.svg" alt="Build with Ona" />
</a>
```

See [Open from URL](/ona/integrations/ona-url) for the full URL format, including pre-selecting a runner or environment class.