Quickstart

# WORKSPACE.rbs — Project configuration
config_setting(key = "project_name", value = "my-project")
config_setting(key = "version", value = "1.0.0")

# BUILD.rbs — Build targets

native.task(
    name = "hello",
    command = ["echo", "Hello from RBS!"],
    description = "A simple hello world task",
)

native.task(
    name = "build_report",
    command = ["sh", "-c", "echo 'Build completed' > " + output_path.out + "/report.txt"],
    outputs = [output_path.out + "/report.txt"],
    description = "Generate a build report",
)

native.task(
    name = "full_build",
    command = ["echo", "All tasks completed!"],
    deps = [":hello", ":build_report"],
    description = "Run the full build pipeline",
)

# Build a single target
rbs build hello

# Run it
rbs run hello

# Build the entire dependency chain
rbs build full_build

# See all available targets
rbs workspace

config_setting(key = "project_name", value = "python-demo")

load("@rbs//python/toolchain.rbs", "python_toolchain")

# RBS manages the Python toolchain on the server
python_toolchain(name = "python", version = "3.11.0")

load("@rbs//python/rules.rbs", "py_binary", "py_test")

py_binary(
    name = "app",
    srcs = ["main.py"],
    main = "main.py",
)

py_test(
    name = "app_test",
    srcs = ["test_main.py"],
    deps = [":app"],
)

def greet(name: str) -> str:
    return f"Hello, {name}!"

if __name__ == "__main__":
    print(greet("World"))

rbs build app        # Builds with managed Python toolchain
rbs run app          # Runs the application
rbs test app_test    # Runs tests

main branch       → RBS Server A  (CI workers auto-deployed)
feature/auth      → RBS Server B  (you + 2 teammates working)
feature/payments  → RBS Server C  (your branch, fresh server)