Get Started with Ruby SDK and Live Preview

This guide will help you get started with Contentstack Ruby SDK to build apps powered by Contentstack.

To get started with the Ruby SDK, you will need the following:

• Ruby version 2.0 or later

To use the Ruby SDK, download it using the gem install command:

$ gem install contentstack

Let's get started with the implementation.

Since the Live Preview Utils SDK is responsible for communication, you need to initialize it within your stack.

Use the following command to initialize the stack:

$client = Contentstack::Client.new("api_key", "delivery_token", "enviroment_name", {

   live_preview: {

     management_token: 'management_token',

     enable: true, 

     host: 'api.contentstack.io',

 }

})

Note: By default, the host parameter points to the North America endpoint. If your website is hosted on the European data center, then pass the European endpoint against the host parameter.

You need to add a custom middleware in the lib/middleware/contentstack_middelware.rb file.

Use the following code to get the Live Preview hash key:

class ContentstackMiddleware

  def initialize(app)

   @app = app

 end


 def call(env)

   @req = Rack::Request.new(env)

   // this will get live_preview hash and ContentType to request

   $client.live_preview_query(@req.params)

   @app.call(env)

 end

end

To add a middleware in the config file, use the following code:

module AppName

 class Application < Rails::Application

   ...


   config.middleware.use CustomMiddleware

 end

end

To install and initialize the Live Preview Utils SDK, you can refer to our SSR Live Preview Setup documentation.

Contentstack SDKs let you interact with the Content Delivery APIs and retrieve content from Contentstack. They are read-only in nature. The SDKs fetch and deliver content from the nearest server via Fastly, our powerful and robust CDN.

To get an entry, you need to specify the content type UID, locale code, and the UID of the entry.

entry = $client.content_type('content_type_uid')

       .entry('entry_uid')

       .locale('locale_code')

       .fetch


entry = $client.content_type('content_type_uid')

       .query

       .find

• JavaScript Live Preview Utils SDK
• Product Catalog using Ruby SDK and Contentstack
• Ruby SDK API Reference
• Ruby SDK Changelog
• View and Download Ruby SDK repository on GitHub