Embed SDK Overview

The Rhumby Embed SDK lets you add live race data to any website with a single script tag. No frameworks, no complex setup, just drop it in and go.

What It Does

The Embed SDK:

• Fetches live data from the Rhumby API
• Renders clean, responsive widgets in a shadow DOM
• Updates automatically as results change
• Works on any website (WordPress, Squarespace, static HTML, etc.)
• Respects your brand with customizable themes

One-Line Install

Add a script tag to your HTML:

<script src="https://rhumby.com/embed.js"
  data-token="emb_abc123"
  data-event="friday-night-spring-2026"
  data-view="standings">
</script>

That's it. The widget will appear where you put the script tag.

How It Works

1. Token → You create an embed token in your dashboard
2. API → The SDK uses the token to fetch data from the Rhumby API
3. Shadow DOM → The widget renders in an isolated shadow DOM (no style conflicts)
4. Auto-refresh → Data updates automatically (configurable interval)

Widget Types

The SDK supports four widget types:

Standings

Display cumulative series standings with race-by-race breakdowns.

<script src="https://rhumby.com/embed.js"
  data-token="emb_abc123"
  data-event="friday-night-spring-2026"
  data-view="standings">
</script>

Results

Show results for a specific race or all races.

<script src="https://rhumby.com/embed.js"
  data-token="emb_abc123"
  data-event="friday-night-spring-2026"
  data-view="results">
</script>

Schedule

Display the race schedule with status indicators.

<script src="https://rhumby.com/embed.js"
  data-token="emb_abc123"
  data-event="friday-night-spring-2026"
  data-view="schedule">
</script>

Registration

Embed a registration form directly on your website.

<script src="https://rhumby.com/embed.js"
  data-token="emb_abc123"
  data-event="friday-night-spring-2026"
  data-view="register">
</script>

Security

Embed tokens are:

• Safe to expose publicly (unlike API keys)
• Domain-restricted (only work on allowed origins)
• View-restricted (can limit which widgets they can show)
• Event-restricted (can limit to specific events)

Create tokens in your dashboard with the exact permissions you need.

Browser Support

The Embed SDK works in all modern browsers:

• Chrome/Edge 90+
• Firefox 88+
• Safari 14+
• Mobile browsers (iOS Safari, Chrome Mobile)

Next Steps

• Explore widget types and see examples
• Configure your widgets with all available options
• Customize themes to match your brand
• Create embed tokens with the right permissions