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

# RBS — The Cloud Development Platform

> Build, test, deploy, and collaborate from your code editor — powered by managed RBS servers

## What is RBS?

RBS (ReasonOS Build System) is a **managed cloud development platform** that handles building, testing, deploying, and infrastructure provisioning — all accessible directly from your code editor. No local setup, no CI configuration, no infrastructure management. Just push code and build.

<CardGroup cols={3}>
  <Card title="Branch-based servers" icon="code-branch">
    One dedicated build server per active branch. Collaborate in real-time with your team.
  </Card>

  <Card title="Built-in Git" icon="git-alt">
    Integrated Git server included. Store and manage your code on the same platform that builds it.
  </Card>

  <Card title="Any language" icon="code">
    Python, Java, Node.js, TypeScript, Kotlin, Go, C/C++ — all supported with managed toolchains.
  </Card>
</CardGroup>

## How RBS works

<Steps>
  <Step title="Connect your repository">
    Create a project on RBS and connect your Git repository — or use the built-in Git server to host your code directly.
  </Step>

  <Step title="RBS spins up a server">
    When you start working on a branch, RBS automatically provisions a dedicated build server, clones your repo, and sets up the environment.
  </Step>

  <Step title="Build from your editor">
    Open your code editor, connect to the RBS workspace, and run builds, tests, and deployments — all from the editor.
  </Step>

  <Step title="CI/CD runs automatically">
    CI workers, job schedulers, and build workers are deployed automatically. No pipelines to configure.
  </Step>
</Steps>

## Why RBS?

|                                | RBS                         | GitHub + Actions  | GitLab            |
| ------------------------------ | --------------------------- | ----------------- | ----------------- |
| **Setup**                      | Instant — managed for you   | Manual CI config  | Manual CI config  |
| **Build servers**              | Auto-provisioned per branch | Shared runners    | Shared runners    |
| **Git hosting**                | Built-in                    | GitHub            | GitLab            |
| **Editor integration**         | Native                      | Third-party       | Third-party       |
| **Infrastructure as code**     | ✅ Built-in                  | ❌ Separate tool   | ❌ Separate tool   |
| **Container images**           | ✅ Built-in                  | ❌ Docker required | ❌ Docker required |
| **Hermetic builds**            | ✅ Always                    | ❌                 | ❌                 |
| **Coding agent**               | ✅ Built-in                  | ❌                 | ❌                 |
| **Agent builder SDK**          | ✅ Built-in                  | ❌                 | ❌                 |
| **Real-time collaboration**    | ✅ Built-in                  | ❌ Third-party     | ❌ Third-party     |
| **Video calls & screen share** | ✅ Built-in (P2P)            | ❌                 | ❌                 |
| **Team chat**                  | ✅ Built-in                  | ❌                 | ❌                 |

## The RBS DSL

RBS uses a simple, Python-like DSL to describe your builds. Define what you want to build in `.rbs` files, and the platform handles everything else — toolchains, dependencies, parallelism, and hermetic outputs.

```python theme={null}
# BUILD.rbs
load("@rbs//python/rules.rbs", "py_binary", "py_test")

py_binary(
    name = "api_server",
    srcs = ["main.py", "routes.py"],
    main = "main.py",
    deps = [":utils"],
)

py_test(
    name = "api_test",
    srcs = ["test_routes.py"],
    deps = [":api_server"],
    min_line_coverage = 85,
)
```

```bash theme={null}
rbs build api_server    # Build the server
rbs test api_test       # Run tests with coverage
rbs run api_server      # Run the server
```

## Key features

<Columns cols={2}>
  <Card title="Language SDKs" icon="layer-group" href="/sdks/python">
    Built-in support for Python, Java, Node.js, TypeScript, Kotlin, Go, and C/C++ with managed toolchains.
  </Card>

  <Card title="Code editor integration" icon="window" href="/code-editor">
    Work entirely from your editor. Run builds, view logs, and collaborate — all without leaving your IDE.
  </Card>

  <Card title="Coding agent" icon="robot" href="/agent-builder">
    A built-in AI coding assistant that understands your builds, modifies code, runs tests, and orchestrates teams.
  </Card>

  <Card title="Custom rules" icon="puzzle-piece" href="/custom-rules">
    Define your own build rules in minutes using the RBS DSL. Full access to file operations, HTTP, archives, and more.
  </Card>

  <Card title="Infrastructure" icon="cloud" href="/advanced/infrastructure">
    Provision cloud resources using 5000+ Terraform-compatible providers, all defined in the RBS DSL.
  </Card>

  <Card title="CI/CD pipelines" icon="rotate" href="/advanced/ci-cd">
    Fully managed CI workflows with DAG-based parallel execution and affected-only builds.
  </Card>

  <Card title="Container images" icon="docker" href="/advanced/containers">
    Build OCI-compliant container images without Docker, directly from your build rules.
  </Card>

  <Card title="Built-in Git" icon="git-alt" href="/platform/git-server">
    Integrated Git server with branch-based workspaces and team collaboration.
  </Card>

  <Card title="Real-time collaboration" icon="users" href="/platform/collaboration">
    Edit code together, video call, screen share, and chat — all built into the platform. No third-party tools.
  </Card>

  <Card title="Watch & hot reload" icon="eye" href="/sdks/watch-sdk">
    Automatic file watching and process restart. Change a file, see the result instantly.
  </Card>

  <Card title="Search SDK" icon="magnifying-glass" href="/sdks/search-sdk">
    Full-text content search, fuzzy file finder, and real-time file change notifications.
  </Card>

  <Card title="Lint SDK" icon="broom" href="/sdks/lint-sdk">
    Language-agnostic linting framework. Use Black, Prettier, ESLint, Ruff, or any custom linter.
  </Card>
</Columns>

## Get started

<CardGroup cols={2}>
  <Card title="Quickstart guide" icon="rocket" href="/quickstart">
    Connect your repository, open your editor, and run your first build in minutes.
  </Card>

  <Card title="Why ReasonOS?" icon="circle-question" href="/why-reasonos">
    See how RBS compares to Bazel, GitHub Actions, Terraform, and other tools.
  </Card>
</CardGroup>