Add RubyGems client starter

Author: RouterBase Contributors

.github/workflows/ci.yml

@@ -20,6 +20,13 @@ jobs:
         with:
           go-version: "1.22"
           cache: false
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
       - run: npm run verify
       - run: go test ./...
         working-directory: packages/go-routerbase
+      - run: ruby -Ilib test/client_test.rb
+        working-directory: packages/ruby-routerbase
+      - run: gem build routerbase-client.gemspec
+        working-directory: packages/ruby-routerbase

.github/workflows/publish-rubygems.yml

@@ -0,0 +1,28 @@
+name: Publish RubyGems
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: packages/ruby-routerbase
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+      - run: ruby -Ilib test/client_test.rb
+      - run: gem build routerbase-client.gemspec
+      - run: |
+          mkdir -p ~/.gem
+          printf -- "---\n:rubygems_api_key: %s\n" "$RUBYGEMS_API_KEY" > ~/.gem/credentials
+          chmod 0600 ~/.gem/credentials
+        env:
+          RUBYGEMS_API_KEY: ${{ secrets.RUBYGEMS_API_KEY }}
+      - run: gem push routerbase-client-*.gem

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.3.0 - 2026-06-30
+
+- Added a RubyGems-ready `routerbase-client` gem starter.
+- Added Ruby client, CLI, tests, and gem build verification.
+- Added a manual `Publish RubyGems` workflow.
+
 ## 0.2.0 - 2026-06-30
 
 - Added a Go SDK starter with chat completions, model listing, tests, and an example.

CONTRIBUTING.md

@@ -23,6 +23,14 @@ cd packages/go-routerbase
 go test ./...
 ```
 
+Run Ruby checks from the Ruby gem directory:
+
+```bash
+cd packages/ruby-routerbase
+ruby -Ilib test/client_test.rb
+gem build routerbase-client.gemspec
+```
+
 ## Example Guidelines
 
 - Keep examples small and runnable.

README.md

@@ -10,6 +10,7 @@ This repository is a practical starter kit for developers who want to test Route
 - `packages/python-routerbase`: a small Python SDK starter with tests and a CLI.
 - `packages/jsr-routerbase`: a JSR-ready TypeScript package draft.
 - `packages/go-routerbase`: a Go SDK starter with tests and a runnable example.
+- `packages/ruby-routerbase`: a RubyGems-ready client gem starter with tests and a CLI.
 - `examples/docker`: a tiny containerized prompt runner example.
 - `.github/workflows/ci.yml`: CI for Node and Python tests.
 - `docs`: rollout plan, publishing checklist, and maintenance notes.
@@ -74,6 +75,19 @@ response, err := client.ChatCompletion(context.Background(), routerbase.ChatComp
 })
 ```
 
+## Ruby Example
+
+```ruby
+require "routerbase"
+
+client = RouterBase::Client.new(api_key: ENV.fetch("ROUTERBASE_API_KEY"))
+response = client.chat_completion(
+  messages: [
+    { role: "user", content: "Explain RouterBase in one sentence." }
+  ]
+)
+```
+
 ## Published npm Packages
 
 These companion packages are already published:
@@ -87,8 +101,9 @@ These companion packages are already published:
 ## SDK Starters
 
 - Go module: `github.com/RouterBase/routerbase-examples/packages/go-routerbase`
-- Python package draft: `routerbase-client`
+- PyPI package draft: `routerbase-client`
 - JSR package draft: `@routerbase/client`
+- RubyGems package draft: `routerbase-client`
 
 ## Links
 

docs/batch-plan.md

@@ -90,3 +90,6 @@ Status:
 - Go tests added and wired into CI.
 - Module path prepared for pkg.go.dev discovery:
   `github.com/RouterBase/routerbase-examples/packages/go-routerbase`.
+- Ruby gem starter added at `packages/ruby-routerbase`.
+- Ruby tests and gem build added to CI.
+- Manual RubyGems publish workflow added: `.github/workflows/publish-rubygems.yml`.

docs/publishing-checklist.md

@@ -25,6 +25,7 @@ Use this checklist before publishing any RouterBase package or repository.
 - For npm packages, run `npm pack --dry-run`.
 - For PyPI packages, run `python3 -m build` in the package directory.
 - For Go modules, run `go test ./...` in the module directory and confirm pkg.go.dev can index the public module path.
+- For Ruby gems, run `ruby -Ilib test/client_test.rb` and `gem build routerbase-client.gemspec`.
 - For Docker images, build locally before pushing.
 
 ## Maintenance

docs/rubygems.md

@@ -0,0 +1,33 @@
+# RubyGems Package
+
+The Ruby client starter lives in:
+
+```text
+packages/ruby-routerbase
+```
+
+Gem name:
+
+```text
+routerbase-client
+```
+
+The gem metadata points to [RouterBase](https://routerbase.com), the RouterBase docs, and the GitHub source directory.
+
+## Local Checks
+
+```bash
+cd packages/ruby-routerbase
+ruby -Ilib test/client_test.rb
+gem build routerbase-client.gemspec
+```
+
+## Publish
+
+Add `RUBYGEMS_API_KEY` to GitHub repository secrets, then run:
+
+```text
+Publish RubyGems
+```
+
+from GitHub Actions.

docs/trusted-publishing.md

@@ -82,3 +82,31 @@ Before running:
 ## Link Policy
 
 Keep links natural and developer-focused. The first README link uses `[RouterBase](https://routerbase.com)`, and package metadata points to the RouterBase homepage.
+
+## RubyGems
+
+Workflow:
+
+```text
+.github/workflows/publish-rubygems.yml
+```
+
+Package:
+
+```text
+packages/ruby-routerbase
+```
+
+Before running:
+
+- Create a RubyGems API key with permission to push `routerbase-client`.
+- Add it to GitHub repository secrets as `RUBYGEMS_API_KEY`.
+- Run the `Publish RubyGems` workflow manually.
+
+Local verification:
+
+```bash
+cd packages/ruby-routerbase
+ruby -Ilib test/client_test.rb
+gem build routerbase-client.gemspec
+```

package.json

@@ -1,6 +1,6 @@
 {
   "name": "routerbase-examples",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Examples, SDK starters, and publishing assets for RouterBase.",
   "private": true,
   "type": "module",