amazon-chime-sdk-rails 1.0.0 → 1.1.0

data/README.md

@@ -1,6 +1,6 @@
 # amazon-chime-sdk-rails
 
-[![Build Status](https://travis-ci.org/simukappu/amazon-chime-sdk-rails.svg?branch=master)](https://travis-ci.org/simukappu/amazon-chime-sdk-rails)
+[![Build Status](https://github.com/simukappu/amazon-chime-sdk-rails/actions/workflows/build.yml/badge.svg)](https://github.com/simukappu/amazon-chime-sdk-rails/actions/workflows/build.yml)
 [![Coverage Status](https://coveralls.io/repos/github/simukappu/amazon-chime-sdk-rails/badge.svg?branch=master)](https://coveralls.io/github/simukappu/amazon-chime-sdk-rails?branch=master)
 [![Dependency](https://img.shields.io/depfu/simukappu/amazon-chime-sdk-rails.svg)](https://depfu.com/repos/simukappu/amazon-chime-sdk-rails)
 [![Inline Docs](http://inch-ci.org/github/simukappu/amazon-chime-sdk-rails.svg?branch=master)](http://inch-ci.org/github/simukappu/amazon-chime-sdk-rails)
@@ -10,13 +10,15 @@
 
 *amazon-chime-sdk-rails* brings server-side implementation of [Amazon Chime SDK](https://aws.amazon.com/chime/chime-sdk) to your [Ruby on Rails](https://rubyonrails.org) application. [Amazon Chime SDK](https://aws.amazon.com/chime/chime-sdk) provides client-side implementation to build real-time communications for your application, and *amazon-chime-sdk-rails* enables you to easily add server-side implementation to your Rails application.
 
+<kbd>![cloud-react-meeting-demo-joined-image](https://raw.githubusercontent.com/simukappu/amazon-chime-sdk-rails/images/cloud_react_meeting_demo_joined.png)</kbd>
+
 *amazon-chime-sdk-rails* supports both of [Rails API Application](https://guides.rubyonrails.org/api_app.html) and [Rails Application with Action View](https://guides.rubyonrails.org/action_view_overview.html). The gem provides following functions:
-* Meeting Coordinator - Wrapper client module of [AWS SDK for Ruby](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Chime/Client.html), which simulates [AWS SDK for JavaScript](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Chime.html) to communicate with Amazon Chime SDK client implementation by JSON format.
-* Controller Templates - Mixin module implementation for meetings and attendees controllers.
-* Rails Generators
-  * Controller Generator - Generator to create customizable meetings and attendees controllers in your Rails application.
-  * View Generator - Generator to create customizable meetings views for your Rails application with Action View.
-  * Single Javascript Generator - Generator to [bundle Amazon Chime SDK into single .js file](https://github.com/aws/amazon-chime-sdk-js/tree/master/demos/singlejs) and put it into [Asset Pipeline](https://guides.rubyonrails.org/asset_pipeline.html) for your Rails application with Action View.
+* *Meeting Coordinator* - Wrapper client module of [AWS SDK for Ruby](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Chime/Client.html), which simulates [AWS SDK for JavaScript](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Chime.html) to communicate with Amazon Chime SDK client implementation by JSON format.
+* *Controller Templates* - Mixin module implementation for meetings and attendees controllers.
+* *Rails Generators*
+  * *Controller Generator* - Generator to create customizable meetings and attendees controllers in your Rails application.
+  * *Single Javascript Generator* - Generator to [bundle Amazon Chime SDK into a single .js file](https://github.com/aws-samples/amazon-chime-sdk/tree/main/utils/singlejs) and put it into [Asset Pipeline](https://guides.rubyonrails.org/asset_pipeline.html) for your Rails application with Action View.
+  * *View Generator* - Generator to create customizable meetings views for your Rails application with Action View.
 
 
 ## Getting Started
@@ -42,1068 +44,193 @@ The install generator will generate an initializer which describes all configura
 
 You need to set up AWS credentials or IAM role for *amazon-chime-sdk-rails* in your Rails app. See [Configuring the AWS SDK for Ruby](https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/setup-config.html) for more details.
 
-*amazon-chime-sdk-rails* requires following IAM permissions:
-
-* [chime:TagResource](https://docs.aws.amazon.com/chime/latest/APIReference/API_TagResource.html)
-* [chime:UntagResource](https://docs.aws.amazon.com/chime/latest/APIReference/API_UntagResource.html)
-* [chime:CreateMeeting](https://docs.aws.amazon.com/chime/latest/APIReference/API_CreateMeeting.html)
-* [chime:GetMeeting](https://docs.aws.amazon.com/chime/latest/APIReference/API_GetMeeting.html)
-* [chime:ListMeetings](https://docs.aws.amazon.com/chime/latest/APIReference/API_ListMeetings.html) (if necessary)
-* [chime:DeleteMeeting](https://docs.aws.amazon.com/chime/latest/APIReference/API_DeleteMeeting.html) (if necessary)
-* [chime:CreateAttendee](https://docs.aws.amazon.com/chime/latest/APIReference/API_CreateAttendee.html)
-* [chime:GetAttendee](https://docs.aws.amazon.com/chime/latest/APIReference/API_GetAttendee.html)
-* [chime:ListAttendees](https://docs.aws.amazon.com/chime/latest/APIReference/API_ListAttendees.html) (if necessary)
-* [chime:DeleteAttendee](https://docs.aws.amazon.com/chime/latest/APIReference/API_DeleteAttendee.html) (if necessary)
-
-See [Actions defined by Amazon Chime](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonchime.html#amazonchime-actions-as-permissions) for more details.
-
-### A: Develop your Rails API Application
-
-Let's start to building simple Rails API application providing real-time communications in a private room.
-For example, create Rails API application using [Devise Token Auth](https://github.com/lynndylanhurley/devise_token_auth) for user authentication.
-
-#### Prepare Rails API application
-
-At first, create new Rails application:
-
-```bash
-$ rails new chime_api_app --api
-$ cd chime_api_app
-```
-
-Add gems to your Gemfile:
-
-```ruby:Gemfile
-# Gemfile
-
-gem 'devise_token_auth'
-gem 'amazon-chime-sdk-rails'
-```
-
-Then, install *devise_token_auth*:
-
-```bash
-$ bundle install
-$ rails g devise:install
-$ rails g devise_token_auth:install User auth
-```
-
-Update your `application_controller.rb` like this:
-
-```ruby:app/controllers/application_controller.rb
-# app/controllers/application_controller.rb
-
-class ApplicationController < ActionController::API
-  include ActionController::Helpers
-  include DeviseTokenAuth::Concerns::SetUserByToken
-  before_action :configure_permitted_parameters, if: :devise_controller?
-
-  protected
-  def configure_permitted_parameters
-    devise_parameter_sanitizer.permit(:sign_up, keys: [:name])
-  end 
-end
-```
-
-Update your `user.rb` to remove unnecessary options like this:
-
-```ruby:app/models/user.rb
-# app/models/user.rb
-
-class User < ActiveRecord::Base
-  devise :database_authenticatable, :registerable
-  include DeviseTokenAuth::Concerns::User
-end
-```
-
-Update *devise_token_auth* configuration in `devise_token_auth.rb` to keep authorization headers:
-
-```ruby:config/initializers/devise_token_auth.rb
-# config/initializers/devise_token_auth.rb
-
-DeviseTokenAuth.setup do |config|
-  # Uncomment and update
-  config.change_headers_on_each_request = false
-end
-```
-
-#### Create private room functions
-
-Create models and controllers by generator:
-
-```bash
-$ rails g model room name:string
-$ rails g scaffold_controller api/rooms name:string --model-name=room
-$ rails g model entry room:references user:references
-$ rails g scaffold_controller api/entries room:references user:references --model-name=entry
-$ rake db:migrate
-```
-
-Update your `room.rb` like this:
-
-```ruby:app/models/room.rb
-# app/models/room.rb
-
-class Room < ApplicationRecord
-  has_many :entries, dependent: :destroy
-  has_many :members, through: :entries, source: :user
-
-  def member?(user)
-    members.include?(user)
-  end
-
-  def as_json(options = {})
-    super options.merge(:methods => [:members])
-  end
-end
-```
-
-Add uniqueness validation to your `entry.rb` like this:
-
-```ruby:app/models/entry.rb
-# app/models/entry.rb
-
-class Entry < ApplicationRecord
-  belongs_to :room
-  belongs_to :user
-  # Add uniqueness validation
-  validates :user, uniqueness: { scope: :room }
-end
-```
-
-Remove location header from your `rooms_controller.rb` and `entries_controller.rb` like this:
-
-```ruby:app/controllers/api/rooms_controller.rb
-# app/controllers/api/rooms_controller.rb
-
-# POST /rooms
-def create
-  @room = Room.new(room_params)
-
-  if @room.save
-    render json: @room, status: :created # Remove location header
-  else
-    render json: @room.errors, status: :unprocessable_entity
-  end
-end
-```
-
-```ruby:app/controllers/api/entries_controller.rb
-# app/controllers/api/entries_controller.rb
-
-# POST /entries
-def create
-  @entry = Entry.new(entry_params)
+*amazon-chime-sdk-rails* requires IAM permissions defined as [AWSChimeSDK AWS managed policy](https://docs.aws.amazon.com/chime-sdk/latest/dg/iam-users-roles.html). Grant these permissions to your IAM policy and assign it to your IAM user or role. This ensures that you have the necessary permissions for *amazon-chime-sdk-rails* in your server-side application. See [Actions defined by Amazon Chime](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonchime.html#amazonchime-actions-as-permissions) for more details.
 
-  if @entry.save
-    render json: @entry, status: :created # Remove location header
-  else
-    render json: @entry.errors, status: :unprocessable_entity
-  end
-end
-```
+### [Option 1] Develop your Rails API Application
 
-#### Develop meeting functions with amazon-chime-sdk-rails
+See [Develop your Rails API Application](/docs/Develop_Rails_API_Application.md#develop-your-rails-api-application) for step-by-step instructions.
 
-Install *amazon-chime-sdk-rails* and generates your controllers:
+You can build your Rails API application working with front-end application using [Amazon Chime SDK](https://aws.amazon.com/chime/chime-sdk). *amazon-chime-sdk-rails* provides *Controller Generator* to create customizable meetings and attendees controllers in your Rails API application.
 
 ```bash
-$ rails g chime_sdk:install
 $ rails g chime_sdk:controllers -r room -n api
 ```
 
-Add and uncomment several functions in generated `meetings_controller.rb` and `meeting_attendees_controller.rb` for your app configurations:
-
-```ruby:app/controllers/api/meetings_controller.rb
-# app/controllers/api/meetings_controller.rb
-
-class Api::MeetingsController < ApplicationController
-  before_action :authenticate_api_user!
-  include DeviseTokenAuth::Concerns::SetUserByToken
-  before_action :set_room
-  before_action :check_membership
-
-  include ChimeSdk::Controller::Meetings::Mixin
-
-  private
-  # Add
-  def set_room
-    @room = Room.find(params[:room_id])
-  end
-
-  # Add
-  def check_membership
-    unless @room.member?(current_api_user)
-      message = 'Unauthorized: you are not a member of this private room.'
-      render json: { room: @room, notice: message }, status: :forbidden
-    end
-  end
-
-  # Uncomment
-  def meeting_request_id
-    "PrivateRoom-#{@room.id}"
-  end
-
-  # Uncomment and update
-  def attendee_request_id
-    "User-#{current_api_user.id}"
-  end
-
-  # Uncomment
-  def application_meeting_metadata(meeting)
-    {
-      "MeetingType": "PrivateRoom",
-      "Room": @room
-    }
-  end
-
-  # Uncomment
-  def application_attendee_metadata(attendee)
-    user_id = attendee[:Attendee][:ExternalUserId].split('-')[3]
-    {
-      "AttendeeType": "User",
-      "User": User.find_by_id(user_id)
-    }
-  end
-end
-```
+*amazon-chime-sdk-rails* includes example Rails application in *[/spec/rails_app](/spec/rails_app)*. This example application provides API integration with [customized React Meeting Demo](https://github.com/simukappu/amazon-chime-sdk/tree/main/apps/meeting#readme---react-meeting-demo) as a sample single page application using [React](https://reactjs.org/) and [Amazon Chime SDK for JavaScript](https://github.com/aws/amazon-chime-sdk-js). See [Examples](#examples) for more details.
 
-```ruby:app/controllers/api/meeting_attendees_controller.rb
-# app/controllers/api/meeting_attendees_controller.rb
-
-class Api::MeetingAttendeesController < ApplicationController
-  before_action :authenticate_api_user!
-  include DeviseTokenAuth::Concerns::SetUserByToken
-  before_action :set_room
-  before_action :check_membership
-
-  include ChimeSdk::Controller::Attendees::Mixin
-
-  private
-  # Add
-  def set_room
-    @room = Room.find(params[:room_id])
-  end
-
-  # Add
-  def check_membership
-    unless @room.member?(current_api_user)
-      message = 'Unauthorized: you are not a member of this private room.'
-      render json: { room: @room, notice: message }, status: :forbidden
-    end
-  end
-
-  # Uncomment and update
-  def attendee_request_id
-    "User-#{current_api_user.id}"
-  end
-
-  # Uncomment
-  def application_attendee_metadata(attendee)
-    user_id = attendee[:Attendee][:ExternalUserId].split('-')[3]
-    {
-      "AttendeeType": "User",
-      "User": User.find_by_id(user_id)
-    }
-  end
-end
-```
-
-Then, update your `routes.rb` like this:
-
-```ruby:config/routes.rb
-# config/routes.rb
-
-Rails.application.routes.draw do
-  namespace :api do
-    scope :"v1" do
-      mount_devise_token_auth_for 'User', at: 'auth'
-      resources :rooms do
-        resources :entries, only: [:create, :destroy]
-        resources :meetings, defaults: { format: :json }, only: [:index, :show, :create, :destroy] do
-          resources :meeting_attendees, as: :attendees, path: :attendees, only: [:index, :show, :create, :destroy]
-        end
-      end
-    end
-  end
-end
-```
-
-Note that you need to set up AWS credentials or IAM role for *amazon-chime-sdk-rails*. See [Set up AWS credentials](#set-up-aws-credentials) for more details.
-
-Finally, start rails server:
+### [Option 2] Develop your Rails Application with Action View
 
-```bash
-$ rails server
-```
-
-Now ready to take off!
+See [Develop your Rails Application with Action View](/docs/Develop_Rails_View_Application.md#develop-your-rails-application-with-action-view) for step-by-step instructions.
 
-#### Get meeting configurations through Rails API
-
-Created Rails API works like this:
+You can build your Rails application with Action View using *amazon-chime-sdk-rails*. In addition to *Controller Generator*, *Single Javascript Generator* will [bundle Amazon Chime SDK into a single .js file](https://github.com/aws-samples/amazon-chime-sdk/tree/main/utils/singlejs) and put it into [Asset Pipeline](https://guides.rubyonrails.org/asset_pipeline.html) for your Rails application. Then, *View Generator* will create customizable meetings views which includes bundled Amazon Chime SDK from Asset Pipeline.
 
 ```bash
-# Sign up users
-
-$ curl localhost:3000/api/v1/auth -X POST -H "content-type:application/json" -d '{"email":"ichiro@example.com", "password":"password", "password_confirmation":"password", "name":"ichiro"}'
-
-{"status":"success","data":{"id":1,"provider":"email","uid":"ichiro@example.com","allow_password_change":false,"name":"ichiro","nickname":null,"image":null,"email":"ichiro@example.com","created_at":"2020-10-16T11:14:48.731Z","updated_at":"2020-10-16T11:14:48.827Z"}}
-
-$ curl localhost:3000/api/v1/auth -X POST -H "content-type:application/json" -d '{"email":"stephen@example.com", "password":"password", "password_confirmation":"password", "name":"stephen"}'
-
-{"status":"success","data":{"id":2,"provider":"email","uid":"stephen@example.com","allow_password_change":false,"name":"stephen","nickname":null,"image":null,"email":"stephen@example.com","created_at":"2020-10-16T11:15:33.226Z","updated_at":"2020-10-16T11:15:33.314Z"}}
-
-# Create private room
-
-$ curl localhost:3000/api/v1/rooms -X POST -H "content-type:application/json" -d '{"room":{"name":"PrivateRoom-1"}}'
-
-{"id":1,"name":"PrivateRoom-1","created_at":"2020-10-16T11:15:56.223Z","updated_at":"2020-10-16T11:15:56.223Z","members":[]}
-
-# You cannot create meeting yet because the user is not signed in
-
-$ curl localhost:3000/api/v1/rooms/3/meetings -X POST -H "content-type:application/json"
-
-{"errors":["You need to sign in or sign up before continuing."]}
-
-# Sign in as ichiro
-
-$ curl localhost:3000/api/v1/auth/sign_in -X POST -H "content-type:application/json" -D auth_headers.txt -d '{"email":"ichiro@example.com", "password":"password"}'
-
-{"data":{"id":1,"email":"ichiro@example.com","provider":"email","uid":"ichiro@example.com","allow_password_change":false,"name":"ichiro","nickname":null,"image":null}}
-
-$ _ACCESS_TOKEN=$(cat auth_headers.txt | grep access-token | rev | cut -c 2- | rev)
-$ _CLIENT=$(cat auth_headers.txt | grep client | rev | cut -c 2- | rev)
-$ _UID=$(cat auth_headers.txt | grep uid | rev | cut -c 2- | rev)
-
-# You cannot create meeting yet because the user is not a member of the private room
-
-$ curl localhost:3000/api/v1/rooms/1/meetings -X POST -H "content-type:application/json" -H "${_ACCESS_TOKEN}" -H "${_CLIENT}" -H "${_UID}"
-
-{"room":{"id":1,"name":"PrivateRoom-1","created_at":"2020-10-16T11:15:56.223Z","updated_at":"2020-10-16T11:15:56.223Z","members":[]},"notice":"Unauthorized: you are not a member of this private room."}
-
-# Add users to the private room
-
-$ curl localhost:3000/api/v1/rooms/1/entries -X POST -H "content-type:application/json" -d '{"entry":{"room_id":1,"user_id":1}}'
-
-{"id":1,"room_id":1,"user_id":1,"created_at":"2020-10-16T11:18:22.839Z","updated_at":"2020-10-16T11:18:22.839Z"}
-
-$ curl localhost:3000/api/v1/rooms/1/entries -X POST -H "content-type:application/json" -d '{"entry":{"room_id":1,"user_id":2}}'
-
-{"id":2,"room_id":1,"user_id":2,"created_at":"2020-10-16T11:18:41.116Z","updated_at":"2020-10-16T11:18:41.116Z"}
-
-# Now you can create meeting as a member of the private room
-
-$ curl localhost:3000/api/v1/rooms/1/meetings -X POST -H "content-type:application/json" -H "${_ACCESS_TOKEN}" -H "${_CLIENT}" -H "${_UID}" | jq .
-
-{
-  "Meeting": {
-    "MeetingId": "2f550432-579c-4058-bbb9-be8a01d3beea",
-    "ExternalMeetingId": "ChimeSdkRailsApp-development-PrivateRoom-1",
-    "MediaPlacement": {
-      "AudioHostUrl": "d3175d855e633b72aedb275a0dd6504f.k.m2.ue1.app.chime.aws:3478",
-      "AudioFallbackUrl": "wss://haxrp.m2.ue1.app.chime.aws:443/calls/2f550432-579c-4058-bbb9-be8a01d3beea",
-      "ScreenDataUrl": "wss://bitpw.m2.ue1.app.chime.aws:443/v2/screen/2f550432-579c-4058-bbb9-be8a01d3beea",
-      "ScreenSharingUrl": "wss://bitpw.m2.ue1.app.chime.aws:443/v2/screen/2f550432-579c-4058-bbb9-be8a01d3beea",
-      "ScreenViewingUrl": "wss://bitpw.m2.ue1.app.chime.aws:443/ws/connect?passcode=null&viewer_uuid=null&X-BitHub-Call-Id=2f550432-579c-4058-bbb9-be8a01d3beea",
-      "SignalingUrl": "wss://signal.m2.ue1.app.chime.aws/control/2f550432-579c-4058-bbb9-be8a01d3beea",
-      "TurnControlUrl": "https://ccp.cp.ue1.app.chime.aws/v2/turn_sessions"
-    },
-    "MediaRegion": "us-east-1",
-    "ApplicationMetadata": {
-      "MeetingType": "PrivateRoom",
-      "Room": {
-        "id": 1,
-        "name": "PrivateRoom-1",
-        "created_at": "2020-10-16T11:15:56.223Z",
-        "updated_at": "2020-10-16T11:15:56.223Z",
-        "members": [
-          {
-            "id": 1,
-            "provider": "email",
-            "uid": "ichiro@example.com",
-            "allow_password_change": false,
-            "name": "ichiro",
-            "nickname": null,
-            "image": null,
-            "email": "ichiro@example.com",
-            "created_at": "2020-10-16T11:14:48.731Z",
-            "updated_at": "2020-10-16T11:16:56.927Z"
-          },
-          {
-            "id": 2,
-            "provider": "email",
-            "uid": "stephen@example.com",
-            "allow_password_change": false,
-            "name": "stephen",
-            "nickname": null,
-            "image": null,
-            "email": "stephen@example.com",
-            "created_at": "2020-10-16T11:15:33.226Z",
-            "updated_at": "2020-10-16T11:15:33.314Z"
-          }
-        ]
-      }
-    }
-  },
-  "Attendee": {
-    "ExternalUserId": "ChimeSdkRailsApp-development-User-1",
-    "AttendeeId": "b581c46d-661f-92bb-d80e-f4b157d95fe9",
-    "JoinToken": "YjU4MWM0NmQtNjYxZi05MmJiLWQ4MGUtZjRiMTU3ZDk1ZmU5OjgyZmM2NTMxLTIwMjctNGMxMS04OTE0LTQwZjkxNmJmNjM3MQ",
-    "ApplicationMetadata": {
-      "AttendeeType": "User",
-      "User": {
-        "id": 1,
-        "provider": "email",
-        "uid": "ichiro@example.com",
-        "allow_password_change": false,
-        "name": "ichiro",
-        "nickname": null,
-        "image": null,
-        "email": "ichiro@example.com",
-        "created_at": "2020-10-16T11:14:48.731Z",
-        "updated_at": "2020-10-16T11:16:56.927Z"
-      }
-    }
-  }
-}
-
-# Get attendee data from created meeting ID
-
-$ MEETING_ID=$(curl localhost:3000/api/v1/rooms/1/meetings -X POST -H "content-type:application/json" -H "${_ACCESS_TOKEN}" -H "${_CLIENT}" -H "${_UID}" | jq -r .Meeting.MeetingId)
-
-$ curl localhost:3000/api/v1/rooms/1/meetings/${MEETING_ID}/attendees -H "content-type:application/json" -H "${_ACCESS_TOKEN}" -H "${_CLIENT}" -H "${_UID}" | jq .
-
-{
-  "attendees": [
-    {
-      "Attendee": {
-        "ExternalUserId": "ChimeSdkRailsApp-development-User-1",
-        "AttendeeId": "b581c46d-661f-92bb-d80e-f4b157d95fe9",
-        "JoinToken": "YjU4MWM0NmQtNjYxZi05MmJiLWQ4MGUtZjRiMTU3ZDk1ZmU5OjgyZmM2NTMxLTIwMjctNGMxMS04OTE0LTQwZjkxNmJmNjM3MQ",
-        "ApplicationMetadata": {
-          "AttendeeType": "User",
-          "User": {
-            "id": 1,
-            "provider": "email",
-            "uid": "ichiro@example.com",
-            "allow_password_change": false,
-            "name": "ichiro",
-            "nickname": null,
-            "image": null,
-            "email": "ichiro@example.com",
-            "created_at": "2020-10-16T11:14:48.731Z",
-            "updated_at": "2020-10-16T11:16:56.927Z"
-          }
-        }
-      }
-    }
-  ]
-}
-
-$ ATTENDEE_ID=$(curl localhost:3000/api/v1/rooms/1/meetings/${MEETING_ID}/attendees -X GET -H "content-type:application/json" -H "${_ACCESS_TOKEN}" -H "${_CLIENT}" -H "${_UID}" | jq -r .attendees[0].Attendee.AttendeeId)
-
-$ curl localhost:3000/api/v1/rooms/1/meetings/${MEETING_ID}/attendees/${ATTENDEE_ID} -H "content-type:application/json" -H "${_ACCESS_TOKEN}" -H "${_CLIENT}" -H "${_UID}" | jq .
-
-{
-  "Attendee": {
-    "ExternalUserId": "ChimeSdkRailsApp-development-User-1",
-    "AttendeeId": "b581c46d-661f-92bb-d80e-f4b157d95fe9",
-    "JoinToken": "YjU4MWM0NmQtNjYxZi05MmJiLWQ4MGUtZjRiMTU3ZDk1ZmU5OjgyZmM2NTMxLTIwMjctNGMxMS04OTE0LTQwZjkxNmJmNjM3MQ",
-    "ApplicationMetadata": {
-      "AttendeeType": "User",
-      "User": {
-        "id": 1,
-        "provider": "email",
-        "uid": "ichiro@example.com",
-        "allow_password_change": false,
-        "name": "ichiro",
-        "nickname": null,
-        "image": null,
-        "email": "ichiro@example.com",
-        "created_at": "2020-10-16T11:14:48.731Z",
-        "updated_at": "2020-10-16T11:16:56.927Z"
-      }
-    }
-  }
-}
-
-# Sign in as stephen
-
-$ curl localhost:3000/api/v1/auth/sign_in -X POST -H "content-type:application/json" -D auth_headers.txt -d '{"email":"stephen@example.com", "password":"password"}'
-
-{"data":{"id":2,"email":"stephen@example.com","provider":"email","uid":"stephen@example.com","allow_password_change":false,"name":"stephen","nickname":null,"image":null}}
-
-$ _ACCESS_TOKEN=$(cat auth_headers.txt | grep access-token | rev | cut -c 2- | rev)
-$ _CLIENT=$(cat auth_headers.txt | grep client | rev | cut -c 2- | rev)
-$ _UID=$(cat auth_headers.txt | grep uid | rev | cut -c 2- | rev)
-
-# Confirm attending same meeting in the private room as different attendee
-
-$ curl localhost:3000/api/v1/rooms/1/meetings -X POST -H "content-type:application/json" -H "${_ACCESS_TOKEN}" -H "${_CLIENT}" -H "${_UID}" | jq .
-
-{
-  "Meeting": {
-    "MeetingId": "2f550432-579c-4058-bbb9-be8a01d3beea",
-    "ExternalMeetingId": "ChimeSdkRailsApp-development-PrivateRoom-1",
-    "MediaPlacement": {
-      "AudioHostUrl": "d3175d855e633b72aedb275a0dd6504f.k.m2.ue1.app.chime.aws:3478",
-      "AudioFallbackUrl": "wss://haxrp.m2.ue1.app.chime.aws:443/calls/2f550432-579c-4058-bbb9-be8a01d3beea",
-      "ScreenDataUrl": "wss://bitpw.m2.ue1.app.chime.aws:443/v2/screen/2f550432-579c-4058-bbb9-be8a01d3beea",
-      "ScreenSharingUrl": "wss://bitpw.m2.ue1.app.chime.aws:443/v2/screen/2f550432-579c-4058-bbb9-be8a01d3beea",
-      "ScreenViewingUrl": "wss://bitpw.m2.ue1.app.chime.aws:443/ws/connect?passcode=null&viewer_uuid=null&X-BitHub-Call-Id=2f550432-579c-4058-bbb9-be8a01d3beea",
-      "SignalingUrl": "wss://signal.m2.ue1.app.chime.aws/control/2f550432-579c-4058-bbb9-be8a01d3beea",
-      "TurnControlUrl": "https://ccp.cp.ue1.app.chime.aws/v2/turn_sessions"
-    },
-    "MediaRegion": "us-east-1",
-    "ApplicationMetadata": {
-      "MeetingType": "PrivateRoom",
-      "Room": {
-        "id": 1,
-        "name": "PrivateRoom-1",
-        "created_at": "2020-10-16T11:15:56.223Z",
-        "updated_at": "2020-10-16T11:15:56.223Z",
-        "members": [
-          {
-            "id": 1,
-            "provider": "email",
-            "uid": "ichiro@example.com",
-            "allow_password_change": false,
-            "name": "ichiro",
-            "nickname": null,
-            "image": null,
-            "email": "ichiro@example.com",
-            "created_at": "2020-10-16T11:14:48.731Z",
-            "updated_at": "2020-10-16T11:16:56.927Z"
-          },
-          {
-            "id": 2,
-            "provider": "email",
-            "uid": "stephen@example.com",
-            "allow_password_change": false,
-            "name": "stephen",
-            "nickname": null,
-            "image": null,
-            "email": "stephen@example.com",
-            "created_at": "2020-10-16T11:15:33.226Z",
-            "updated_at": "2020-10-16T11:21:46.011Z"
-          }
-        ]
-      }
-    }
-  },
-  "Attendee": {
-    "ExternalUserId": "ChimeSdkRailsApp-development-User-2",
-    "AttendeeId": "986886fc-dcbc-1d44-4708-917ab23117de",
-    "JoinToken": "OTg2ODg2ZmMtZGNiYy0xZDQ0LTQ3MDgtOTE3YWIyMzExN2RlOjNjNjAzM2E5LWFlNGUtNGVmZi1iNjZjLWMwY2M1YjU3OTE4OA",
-    "ApplicationMetadata": {
-      "AttendeeType": "User",
-      "User": {
-        "id": 2,
-        "provider": "email",
-        "uid": "stephen@example.com",
-        "allow_password_change": false,
-        "name": "stephen",
-        "nickname": null,
-        "image": null,
-        "email": "stephen@example.com",
-        "created_at": "2020-10-16T11:15:33.226Z",
-        "updated_at": "2020-10-16T11:21:46.011Z"
-      }
-    }
-  }
-}
-
-$ MEETING_ID_2=$(curl localhost:3000/api/v1/rooms/1/meetings -X POST -H "content-type:application/json" -H "${_ACCESS_TOKEN}" -H "${_CLIENT}" -H "${_UID}" | jq -r .Meeting.MeetingId)
-
-$ echo ${MEETING_ID}
-
-2f550432-579c-4058-bbb9-be8a01d3beea
-
-$ echo ${MEETING_ID_2}
-
-2f550432-579c-4058-bbb9-be8a01d3beea
+$ rails g chime_sdk:controllers -r room
+$ rails g chime_sdk:js
+$ rails g chime_sdk:views
 ```
 
-Now you can start online meeting using [Amazon Chime SDK](https://aws.amazon.com/chime/chime-sdk) client-side implementation with this responded *Meeting* and *Attendee* data.
+You can also customize your meeting view using [Amazon Chime SDK for JavaScript](https://github.com/aws/amazon-chime-sdk-js). See [Examples](#examples) for more details.
 
-You can see [sample single page application](/spec/rails_app/app/javascript/) using [Vue.js](https://vuejs.org) and [Amazon Chime SDK for JavaScript](https://github.com/aws/amazon-chime-sdk-js) as a part of [example Rails application](#examples).
 
+## Examples
 
-### B: Develop your Rails Application with Action View
-
-Let's start to building simple Rails application with Action View providing real-time communications in a private room.
-For example, create Rails application using [Devise](https://github.com/heartcombo/devise) for user authentication.
+You can see example Rails application in *[/spec/rails_app](/spec/rails_app)*. This example Rails application is integrated with [customized React Meeting Demo](https://github.com/simukappu/amazon-chime-sdk/tree/main/apps/meeting#readme---react-meeting-demo) as a sample single page application using [React](https://reactjs.org/) and [Amazon Chime SDK for JavaScript](https://github.com/aws/amazon-chime-sdk-js). You can run customized React Meeting Demo and example Rails application by the following steps.
 
-#### Prepare Rails application
+### Run application in your local environment
 
-At first, create new Rails application:
+Run customized React Meeting Demo in your local environment:
 
 ```bash
-$ rails new chime_view_app
-$ cd chime_view_app
+$ cd <YOUR-WORKING-DIR-FOR-LOCAL>
+$ git clone https://github.com/simukappu/amazon-chime-sdk.git
+$ cd amazon-chime-sdk/apps/meeting
+$ npm install
+$ npm start
 ```
 
-Add gems to your Gemfile:
+You can open *https://localhost:9000* in your browser to access React Meeting Demo.
 
-```ruby:Gemfile
-# Gemfile
-
-gem 'devise'
-gem 'amazon-chime-sdk-rails'
-```
+<kbd>![local-react-meeting-demo-image](https://raw.githubusercontent.com/simukappu/amazon-chime-sdk-rails/images/local_react_meeting_demo.png)</kbd>
 
-Then, install *devise*:
+Then, run example Rails application in your local environment:
 
 ```bash
+$ cd <YOUR-WORKING-DIR-FOR-LOCAL>
+$ git clone https://github.com/simukappu/amazon-chime-sdk-rails.git
+$ cd amazon-chime-sdk-rails
 $ bundle install
-$ rails g devise:install
-$ rails g devise User
-$ rails g migration add_name_to_users name:string
-$ rails g devise:views User
+$ cd spec/rails_app
+$ echo "REACT_MEETING_DEMO_URL=https://localhost:9000" > .env
+$ bin/rake db:migrate
+$ bin/rake db:seed
+$ bin/rails g chime_sdk:js
+$ bin/rails s
 ```
 
-Update your `application_controller.rb` like this:
+Now you can access example Rails application as *http://localhost:3000* in your browser.
 
-```ruby:app/controllers/application_controller.rb
-# app/controllers/application_controller.rb
+<kbd>![local-example-rails-app-image](https://raw.githubusercontent.com/simukappu/amazon-chime-sdk-rails/images/local_example_rails_app.png)</kbd>
 
-class ApplicationController < ActionController::Base
-  before_action :configure_permitted_parameters, if: :devise_controller?
+Login as the following test users to experience example Rails application by *amazon-chime-sdk-rails*:
 
-  protected
-  def configure_permitted_parameters
-    devise_parameter_sanitizer.permit(:sign_up, keys: [:name])
-  end 
-end
-```
+| Email | Password | Initial member of Private Room 1 |
+|:---:|:---:|:---:|
+| ichiro@example.com  | changeit | Yes |
+| stephen@example.com | changeit | Yes |
+| klay@example.com    | changeit |     |
+| kevin@example.com   | changeit |     |
 
-Add user name form to your `app/views/users/registrations/new.html.erb` view template like this:
+After creating a new meeting from any private room, you can join the meeting from "*Join the Meeting*" button in your meeting view.
 
-```erb:app/views/users/registrations/new.html.erb
-# app/views/users/registrations/new.html.erb
 
-<div class="field">
-  <%= f.label :name %><br />
-  <%= f.text_field :name, autocomplete: "name" %>
-</div>
+<kbd>![local-example-rails-app-joined-image](https://raw.githubusercontent.com/simukappu/amazon-chime-sdk-rails/images/local_example_rails_app_joined.png)</kbd>
 
-<div class="field">
-  <%= f.label :email %><br />
-  <%= f.email_field :email, autofocus: true, autocomplete: "email" %>
-</div>
-```
+You can also try integration with customized React Meeting Demo from "*Open React Meeting Demo*" button.
 
-Update *devise* configuration in `devise.rb` to use scoped views:
+<kbd>![local-react-meeting-demo-api-integration-image](https://raw.githubusercontent.com/simukappu/amazon-chime-sdk-rails/images/local_react_meeting_demo_api_integration.png)</kbd>
 
-```ruby:config/initializers/devise.rb
-# config/initializers/devise.rb
+Push "Continue" and go to the private meeting room!
 
-Devise.setup do |config|
-  # Uncomment and update
-  config.scoped_views = true
-end
-```
+<kbd>![local-react-meeting-demo-joined-image](https://raw.githubusercontent.com/simukappu/amazon-chime-sdk-rails/images/local_react_meeting_demo_joined.png)</kbd>
 
-Add login header to your application. Create new `app/views/layouts/_header.html.erb` and update your `app/views/layouts/application.html.erb` like this:
-
-```erb:app/views/layouts/_header.html.erb
-# app/views/layouts/_header.html.erb
-
-<header>
-  <div>
-    <div>
-      <strong>Rails Application for Amazon Chime SDK Meeting (Rails App with Action View)</strong>
-    </div>
-    <div>
-      <% if user_signed_in? %>
-        <%= current_user.name %>
-        <%= link_to 'Logout', destroy_user_session_path, method: :delete %>
-      <% else %>
-        <%= link_to "Sign up", new_user_registration_path %>
-        <%= link_to 'Login', new_user_session_path %>
-      <% end %>
-    </div>
-  </div>
-</header>
-```
 
-```erb:app/views/layouts/application.html.erb
-# app/views/layouts/application.html.erb
-
-<!DOCTYPE html>
-<html>
-  <head>
-    <title>Rails Application for Amazon Chime SDK Meeting</title>
-    <%= csrf_meta_tags %>
-    <%= csp_meta_tag %>
-
-    <%= stylesheet_link_tag 'application', media: 'all', 'data-turbolinks-track': 'reload' %>
-    <%= yield(:javascript_pack_tag) %>
-    <%= javascript_pack_tag 'application', 'data-turbolinks-track': 'reload' %>
-  </head>
-
-  <body>
-    <div id="app">
-      <%= render 'layouts/header' %>
-      <%= yield %>
-    <div>
-  </body>
-</html>
-```
+### Deploy application to your AWS environment
 
-#### Create private room functions
+At first, [install the latest version of AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) and [set up AWS credentials](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) in your local environment.
 
-Create MVC by generator:
+Deploy customized React Meeting Demo to your AWS environment:
 
 ```bash
-$ rails g scaffold room name:string
-$ rails g scaffold entry room:references user:references
-$ rake db:migrate
-```
-
-Update your `room.rb` like this:
-
-```ruby:app/models/room.rb
-# app/models/room.rb
-
-class Room < ApplicationRecord
-  has_many :entries, dependent: :destroy
-  has_many :members, through: :entries, source: :user
-
-  def member?(user)
-    members.include?(user)
-  end
-end
+$ cd <YOUR-WORKING-DIR-FOR-CLOUD>
+$ git clone https://github.com/simukappu/amazon-chime-sdk.git
+$ cd amazon-chime-sdk/apps/meeting
+$ npm install
+$ cd serverless
+$ node ./deploy.js -r us-east-1 -b <YOUR-S3-BUCKET-NAME-FOR-MEETING-DEMO> -s react-meeting-demo
 ```
 
-Add uniqueness validation to your `entry.rb` like this:
+You can see *Amazon Chime SDK Meeting Demo URL* in your deployment output. Open your meeting demo URL in your browser to access React Meeting Demo.
 
-```ruby:app/models/entry.rb
-# app/models/entry.rb
+<kbd>![cloud-react-meeting-demo-image](https://raw.githubusercontent.com/simukappu/amazon-chime-sdk-rails/images/cloud_react_meeting_demo.png)</kbd>
 
-class Entry < ApplicationRecord
-  belongs_to :room
-  belongs_to :user
-  # Add uniqueness validation
-  validates :user, uniqueness: { scope: :room }
-end
-```
+Then, deploy example Rails application to your AWS environment. This deployment example uses [AWS Copilot CLI](https://aws.github.io/copilot-cli/). [Install AWS Copilot CLI](https://aws.github.io/copilot-cli/docs/overview/) before you start to deploy.
 
-Update *create* and *destroy* method in your `entries_controller.rb` like this:
-
-```ruby:app/controllers/entries_controller.rb
-# app/controllers/entries_controller.rb
-
-class EntriesController < ApplicationController
-  before_action :authenticate_user!
-  before_action :set_room
-  before_action :set_entry, only: [:destroy]
-
-  # POST /entries
-  # POST /entries.json
-  def create
-    @entry = Entry.new(entry_params)
-
-    respond_to do |format|
-      if @entry.save
-        format.html { redirect_to @room, notice: 'Member was successfully added.' }
-        format.json { render :show, status: :created, location: @room }
-      else
-        format.html { redirect_to @room, notice: @entry.errors }
-        format.json { render json: @entry.errors, status: :unprocessable_entity }
-      end
-    end
-  end
-
-  # DELETE /entries/1
-  # DELETE /entries/1.json
-  def destroy
-    @entry.destroy
-    respond_to do |format|
-      format.html { redirect_to @room, notice: 'Member was successfully removed.' }
-      format.json { head :no_content }
-    end
-  end
-
-  private
-  # Use callbacks to share common setup or constraints between actions.
-  def set_room
-    @room = Room.find(params[:room_id])
-  end
-
-  # Use callbacks to share common setup or constraints between actions.
-  def set_entry
-    @entry = Entry.find(params[:id])
-  end
-
-  # Only allow a list of trusted parameters through.
-  def entry_params
-    params.require(:entry).permit(:room_id, :user_id)
-  end
-end
-```
+***Optional***: To avoid [mixed content](https://web.dev/what-is-mixed-content/) in your customized React Meeting Demo, you have to publish example Rails application as HTTPS content. Currently in order to make your application HTTPS content from AWS Copilot CLI, you need your domain or subdomain mamaged as [Amazon Route 53 public hosted zones](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/AboutHZWorkingWith.html) and [domain association with AWS Copilot CLI](https://aws.github.io/copilot-cli/docs/developing/domain/). You can associate your domain with `--domain` option in running `copilot app init` before you run `copilot init`.
 
-#### Develop meeting functions with amazon-chime-sdk-rails
-
-Install *amazon-chime-sdk-rails* and generates your controllers:
+Now deploy example Rails application as the following steps:
 
 ```bash
-$ rails g chime_sdk:install
-$ rails g chime_sdk:controllers -r room
-```
-
-Add and uncomment several functions in generated `meetings_controller.rb` and `meeting_attendees_controller.rb` for your app configurations:
-
-```ruby:app/controllers/api/meetings_controller.rb
-# app/controllers/api/meetings_controller.rb
-
-class MeetingsController < ApplicationController
-  before_action :authenticate_user!
-  before_action :set_room
-  before_action :check_membership
-
-  include ChimeSdk::Controller::Meetings::Mixin
-
-  private
-  # Add
-  def set_room
-    @room = Room.find(params[:room_id])
-  end
-
-  # Add
-  def check_membership
-    unless @room.member?(current_user)
-      message = 'Unauthorized: you are not a member of this private room.'
-      redirect_to @room, notice: message
-    end
-  end
-
-  # Uncomment
-  def meeting_request_id
-    "PrivateRoom-#{@room.id}"
-  end
-
-  # Uncomment
-  def attendee_request_id
-    "User-#{current_user.id}"
-  end
-
-  # Uncomment
-  def application_meeting_metadata(meeting)
-    {
-      "MeetingType": "PrivateRoom",
-      "Room": @room
-    }
-  end
-
-  # Uncomment
-  def application_attendee_metadata(attendee)
-    user_id = attendee[:Attendee][:ExternalUserId].split('-')[3]
-    {
-      "AttendeeType": "User",
-      "User": User.find_by_id(user_id)
-    }
-  end
-
-  # Uncomment
-  def application_attendee_metadata(attendee)
-    user_id = attendee[:Attendee][:ExternalUserId].split('-')[3]
-    {
-      "AttendeeType": "User",
-      "User": User.find_by_id(user_id)
-    }
-  end
-end
-```
-
-```ruby:app/controllers/api/meeting_attendees_controller.rb
-# app/controllers/api/meeting_attendees_controller.rb
-
-class MeetingAttendeesController < ApplicationController
-  before_action :authenticate_user!
-  before_action :set_room
-  before_action :check_membership
-
-  include ChimeSdk::Controller::Attendees::Mixin
-
-  private
-  # Add
-  def set_room
-    @room = Room.find(params[:room_id])
-  end
-
-  # Add
-  def check_membership
-    unless @room.member?(current_user)
-      message = 'Unauthorized: you are not a member of this private room.'
-      redirect_to @room, notice: message
-    end
-  end
-
-  # Uncomment
-  def attendee_request_id
-    "User-#{current_user.id}"
-  end
-
-  # Uncomment
-  def application_attendee_metadata(attendee)
-    user_id = attendee[:Attendee][:ExternalUserId].split('-')[3]
-    {
-      "AttendeeType": "User",
-      "User": User.find_by_id(user_id)
-    }
-  end
-end
-```
-
-Generates meeting views by *amazon-chime-sdk-rails* generator:
-
-```bash
-$ rails g chime_sdk:views
-```
-
-Simply customize your meeting view generated *app/views/meetings/show.html.erb*:
-
-```javascript
-// app/views/meetings/show.html.erb
-
-function showApplicationUserName(attendee) {
-  // Comment
-  // return attendee.Attendee.AttendeeId;
-  // Uncomment
-  return `${attendee.Attendee.ApplicationMetadata.User.name} (${attendee.Attendee.AttendeeId})`;
-}
-```
-
-Bundle Amazon Chime SDK into single amazon-chime-sdk.min.js file and copy it to *app/assets/javascripts* by *amazon-chime-sdk-rails* generator:
-
-```bash
-$ rails g chime_sdk:js
-```
-
-Add *amazon-chime-sdk.min.js* to your Asset Pipeline:
-
-```ruby:config/initializers/assets.rb
-# config/initializers/assets.rb
-
-Rails.application.config.assets.precompile += %w( amazon-chime-sdk.min.js )
-```
-
-Then, add member management and meeting link to your room view:
-
-```erb:app/views/rooms/show.html.erb
-# app/views/rooms/show.html.erb
-
-<p id="notice"><%= notice %></p>
-
-<p>
-  <strong>Name:</strong>
-  <%= @room.name %>
-</p>
-
-<p>
-  <strong>Private Meeting:</strong>
-  <p><%= link_to 'Show Meetings', room_meetings_path(@room) %></p>
-  <p><%= link_to 'Join the Meeting', room_meetings_path(@room), method: :post %></p>
-</p>
-
-<p>
-  <strong>Members:</strong>
-  <table>
-    <tbody>
-      <% @room.entries.each do |entry| %>
-        <tr>
-          <td><%= entry.user.name %></td>
-          <td><%= link_to 'Remove', [@room, entry], method: :delete, data: { confirm: 'Are you sure?' } %></td>
-        </tr>
-      <% end %>
-    </tbody>
-  </table>
-</p>
-
-<p>
-  <strong>Add members:</strong>
-  <%= form_for [@room, Entry.new] do |f| %>
-    <%= f.hidden_field :room_id, value: @room.id %>
-    <%= f.collection_select :user_id, User.all, :id, :name %>
-    <%= f.submit "Add" %>
-  <% end %>
-</p>
-
-<%= link_to 'Edit', edit_room_path(@room) %> |
-<%= link_to 'Back', rooms_path %>
-```
-
-Update your `routes.rb` like this:
-
-```ruby:config/routes.rb
-# config/routes.rb
-
-Rails.application.routes.draw do
-  root "rooms#index"
-  devise_for :users
-  resources :rooms do
-    resources :entries, only: [:create, :destroy]
-    resources :meetings, only: [:index, :show, :create, :destroy] do
-      resources :meeting_attendees, as: :attendees, path: :attendees, only: [:index, :show]
-    end
-  end
-end
-```
-
-Note that you need to set up AWS credentials or IAM role for *amazon-chime-sdk-rails*. See [Set up AWS credentials](#set-up-aws-credentials) for more details.
-
-Finally, start rails server:
+$ cd <YOUR-WORKING-DIR-FOR-CLOUD>
+$ git clone https://github.com/simukappu/amazon-chime-sdk-rails.git
+$ cd amazon-chime-sdk-rails
+$ copilot app init --domain <YOUR_REGISTERED_DOMAIN> # --domain option is optional, but required to avoid mixed content
+    What would you like to name your application? [? for help] amazon-chime-sdk-rails
+$ copilot init
+    Which workload type best represents your architecture?  [Use arrows to move, type to filter, ? for more help]
+      Request-Driven Web Service  (App Runner)
+    > Load Balanced Web Service   (Internet to ECS on Fargate)
+      Backend Service             (ECS on Fargate)
+      Worker Service              (Events to SQS to ECS on Fargate)
+      Scheduled Job               (Scheduled event to State Machine to Fargate)
+    What do you want to name this service? [? for help] rails-app
+    Which Dockerfile would you like to use for rails-app?  [Use arrows to move, type to filter, ? for more help]
+    > ./Dockerfile
+      Enter custom path for your Dockerfile
+      Use an existing image instead
+    Would you like to deploy a test environment? [? for help] (y/N) no
+$ mkdir copilot/rails-app/addons && cp templates/amazon-chime-sdk-policy.yml copilot/rails-app/addons/
+$ copilot env init --name test --profile default --app amazon-chime-sdk-rails
+    Would you like to use the default configuration for a new environment?
+      - A new VPC with 2 AZs, 2 public subnets and 2 private subnets
+      - A new ECS Cluster
+      - New IAM Roles to manage services and jobs in your environment
+    [Use arrows to move, type to filter]
+    > Yes, use default.
+      Yes, but I'd like configure the default resources (CIDR ranges, AZs).
+      No, I'd like to import existing resources (VPC, subnets).
+$ REACT_MEETING_DEMO_URL=`aws cloudformation describe-stacks --region us-east-1 --stack-name react-meeting-demo | jq -r '.Stacks[].Outputs[].OutputValue'`
+$ gsed -i "s/#variables:/variables:/g" copilot/rails-app/manifest.yml
+$ gsed -i "/variables:/a\  REACT_MEETING_DEMO_URL: $REACT_MEETING_DEMO_URL" copilot/rails-app/manifest.yml
+$ copilot deploy
+```
+
+You can see *your service URL* in your deployment output. Now you can access example Rails application as this service URL in your browser.
+
+<kbd>![cloud-example-rails-app-image](https://raw.githubusercontent.com/simukappu/amazon-chime-sdk-rails/images/cloud_example_rails_app.png)</kbd>
+
+Login as the test users to experience example Rails application by *amazon-chime-sdk-rails*:
+
+| Email | Password | Initial member of Private Room 1 |
+|:---:|:---:|:---:|
+| ichiro@example.com  | changeit | Yes |
+| stephen@example.com | changeit | Yes |
+| klay@example.com    | changeit |     |
+| kevin@example.com   | changeit |     |
+
+After creating a new meeting from any private room, you can join the meeting from "*Join the Meeting*" button in your meeting view.
+
+<kbd>![cloud-example-rails-app-joined-image](https://raw.githubusercontent.com/simukappu/amazon-chime-sdk-rails/images/cloud_example_rails_app_joined.png)</kbd>
+
+You can also try integration with customized React Meeting Demo from "*Open React Meeting Demo*" button. Enjoy your real-time communications in the private room on the cloud!
+
+<kbd>![cloud-react-meeting-demo-joined-image](https://raw.githubusercontent.com/simukappu/amazon-chime-sdk-rails/images/cloud_react_meeting_demo_joined.png)</kbd>
+
+Finally, clean up your AWS environment:
 
 ```bash
-$ rails server
+$ copilot app delete
+    Are you sure you want to delete application amazon-chime-sdk-rails? [? for help] (Y/n) yes
+$ aws cloudformation delete-stack --region us-east-1 --stack-name react-meeting-demo
+$ aws s3 rb s3://<YOUR-S3-BUCKET-NAME-FOR-MEETING-DEMO> --force
 ```
 
-Now ready to take off!
-
-#### Start meeting with your Rails application
-
-Access *http://localhost:3000/* through your web browser.
-
-Sign up users from *Sign up* header. For example, sign up *ichiro* as *ichiro@example.com* and *stephen* as *stephen@example.com*.
-
-Create new room and add *ichiro* and *stephen* as a room member.
-
-Now you can join the meeting from *"Join the Meeting"* link in your room view. Your rails application includes simple online meeting implementation using [Amazon Chime SDK](https://aws.amazon.com/chime/chime-sdk) as a Rails view.
-
-##### The meeting has been created
-
-<kbd>![meeting-created-image](https://raw.githubusercontent.com/simukappu/amazon-chime-sdk-rails/images/meeting_created.png)</kbd>
-
-##### Ichiro and Stephen have joined the meeting
-
-<kbd>![meeting-created-image](https://raw.githubusercontent.com/simukappu/amazon-chime-sdk-rails/images/meeting_joined.png)</kbd>
-
-You should customize your meeting view using [Amazon Chime SDK for JavaScript](https://github.com/aws/amazon-chime-sdk-js). See [sample Rails application](/spec/rails_app/) using [Amazon Chime SDK for JavaScript](https://github.com/aws/amazon-chime-sdk-js) as a part of [example Rails application](#examples).
-
 
 ## Documentation
 
 See [API Reference](http://www.rubydoc.info/github/simukappu/amazon-chime-sdk-rails/index) for more details.
 
 
-## Examples
-
-See example Rails application in *[/spec/rails_app](/spec/rails_app)*. You can run this example Rails application by the following steps:
-
-```bash
-$ git clone https://github.com/simukappu/amazon-chime-sdk-rails.git
-$ cd amazon-chime-sdk-rails
-$ bundle install
-$ cd spec/rails_app
-$ bin/rake db:migrate
-$ bin/rake db:seed
-$ bin/rails g chime_sdk:js
-$ bin/rails server
-```
-
-
 ## License
 
-*amazon-chime-sdk-rails* project rocks and uses [MIT License](LICENSE).
+*amazon-chime-sdk-rails* project rocks and uses [MIT License](LICENSE).