Using Relay with Ruby on Rails

Connect your Rails app to Relay as a Pusher-compatible broadcaster.

Prerequisites

• A running Relay server
• Your App Key, Secret, and ID

Add the Pusher gem to your Gemfile:

gem 'pusher'

Then install:

bundle install

Create config/initializers/relay.rb:

require 'pusher'

Pusher.app_id  = ENV['RELAY_APP_ID']
Pusher.key     = ENV['RELAY_APP_KEY']
Pusher.secret  = ENV['RELAY_APP_SECRET']
Pusher.host    = ENV.fetch('RELAY_HOST', 'ws.relaycloud.dev')
Pusher.port    = ENV.fetch('RELAY_PORT', '443').to_i
Pusher.scheme  = ENV.fetch('RELAY_SCHEME', 'https')

RELAY_APP_ID=your-app-id
RELAY_APP_KEY=your-app-key
RELAY_APP_SECRET=your-app-secret
RELAY_HOST=ws.relaycloud.dev

Pusher.trigger('public-feed', 'message.sent', { message: 'Hello from Rails!' })

class MessagesController < ApplicationController
  def create
    @message = Message.create!(message_params)
    Pusher.trigger('public-feed', 'message.sent', {
      message: @message.body,
      user_id: current_user.id
    })
    render json: @message
  end
end

On the client side, use the Pusher JS client to subscribe to channels and receive events in real time. See the Next.js guide for a full frontend example.