Nexmo Stitch Demo

An API server and client app to demo how to use Nexmo Stitch applications. For more info visit our developer site.

Remix a sample project we set up on Glitch:

Prerequisites

Install the Nexmo CLI

• Ensure you have Node.JS installed
• Create a free Nexmo account - signup
• Install the Nexmo CLI:

$ npm install -g nexmo-cli@beta

Setup the CLI to use your Nexmo API Key and API Secret. You can get these from the setting page in the Nexmo Dashboard.

$ nexmo setup api_key api_secret

Create an Application

Create an application named My Conversation Application and store the returned private key as private.key within your current working directory.

$ nexmo app:create "My Stitch Application" http://example.com http://example.com --type=rtc --keyfile=private.key

Running the demo

1. Clone or download this repo
2. Create a .env file using the env.example template
3. Input your API Key, API Secret, and application ID
4. Ensure the private.key file from the "Create an Application" is in your current working directory (See private.key.example)
5. Install the node modules $ npm install
6. Start the app: $ npm start
7. The app should be running on localhost:3000

Start chatting!

1. Create a user or two

curl --request POST \
  --url http://localhost:3000/api/users \
  --header 'content-type: application/json' \
  --data '{
	"username": "user2",
	"admin": true
}'

2. Create a conversation via the demo API

curl --request POST \
  --url http://localhost:3000/api/conversations \
  --header 'content-type: application/json' \
  --data '{"displayName": "My Chat"}'

3. Join the user to the conversation. Remember to replace the conversationId and userId with IDs from the two previous steps.

curl --request PUT \
  --url http://localhost:3000/api/conversations \
  --header 'content-type: application/json' \
  --data '{
	"conversationId": "CON-7cda3a42-8f7f-44c6-a4ba-aa23be506397",
	"userId": "USR-ca160eee-836a-4ec7-8ac4-317aefe8d5d3",
	"action": "join"
}'

4. Verify the app is running by visiting localhost:3000/ and login with the username you created in step 1.

What's Next

Use the Android Messaging Demo app to try out Nexmo Stitch across web and Android platforms.