Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

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 button


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" --type=rtc --keyfile=private.key

Running the demo

  1. Clone or download this repo
  2. Create a .env file using the example.env template (The file name has to be .env, it is not just the filename extension)
  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. Install the Angular CLI $ npm install -g @angular/cli
  7. Start the app: $ npm start
  8. 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.


Licenced under MIT


No description, website, or topics provided.




No releases published


No packages published
You can’t perform that action at this time.