Build A Real Time Chat App: React/GraphQL

In this tutorial, I’m going to run through how to build a real time chat app using React and GraphQL.

Here is a demo of the final product:

No time to waste! Let’s get started.

  1. Open to your terminal.

  2. Run create-react-app graphql-chat. This will scaffold a new react project for you.

  3. Run cd graphql-chat in your terminal to enter the project folder we just created.

  4. Update your dependencies in packages.json within your project folder to include the following under dependencies:

"apollo-client-preset": "^1.0.6",
  "apollo-link-ws": "^1.0.4",
  "graphql": "^0.12.3",
  "graphql-tag": "^2.6.1",
  "react": "^16.2.0",
  "react-apollo": "^2.0.4",
  "react-dom": "^16.2.0",
  "react-scripts": "1.0.17",
  "subscriptions-transport-ws": "^0.9.4"
  1. Now, run npm install.

  2. Add your styles to the public/index.html file in the head section:

<link rel="stylesheet" href="" />
<link rel="stylesheet" href="" />
  1. Install graphcool. npm install -g graphcool-framework

  2. Start a new graphcool server. graphcool-framework init server

  3. Go to the types.graphql file in the server folder.

  4. Replace all the content with the following:

type Chat @model {
  id: ID! @isUnique
  from: String!
  content: String!
  createdAt: DateTime!
  1. cd server and run graphcool deploy (Note: please signup for account for this to work)

  2. open up to see your schema.

  3. Go into your console and check out the GraphQL playground Endpoint API address. Copy and paste this into your browser to go to the GraphQL playground for your database! OR run graphcool-framework playground in your console to open up your GraphQL playground.

  4. Run the following two operations in your graphQL playground to test our schema.

Make sure to run FETCH_CHATS first, then the mutation.

  query FETCH_CHATS{

    mutation CREATE_CHAT {
      createChat(content: "test", from: "test") {

You should see something like this on the right hand side of your graphQL playground:

  "data": {
    "createChat": {
      "content": "test",
      "from": "test"
  1. Update your src/hello.js file to include all the dependencies.
 import { ApolloProvider } from 'react-apollo';
    import { ApolloClient } from 'apollo-client';
    import { HttpLink } from 'apollo-link-http';
    import { InMemoryCache } from 'apollo-cache-inmemory';
    import { ApolloLink, split } from 'apollo-client-preset'
    import { WebSocketLink } from 'apollo-link-ws'
    import { getMainDefinition } from 'apollo-utilities'
  1. Right after the imports, place the following to configure the websockets link. You can do this by copy and pasting the following into the src/hello.js file.
const wsLink = new WebSocketLink({

  uri: '[Subscriptions API URI]',
  options: {
    reconnect: true

Please make sure to substitute your own Subscriptions API http address for the placeholder Subscriptions API URI.

  1. Add the following to configure our HTTP connection. Make sure to add it right after the websockets configuration.

const httpLink = new HttpLink({ uri: '[SIMPLE API URI]' })

Please make sure to include your actual SIMPLE API URI (the web address for the Simple API included in your console).

  1. Create your Apollo client by copy and pasting the following after the previous code in src/hello.js.
const client = new ApolloClient({

  cache: new InMemoryCache()
  1. Reorganize your file structure. All your .js files should be under src/.

  2. run npm start from your Terminal, which will open the browser. You should see a popup with a message requesting your name. Enter a name, then see the test data that was initially inputted by mutation in the graphQL database!

  3. In our App.js file, insert the following for the Chat mutation.

    import { graphql, compose } from 'react-apollo';
    // App component ...

    const CREATE_CHAT_MUTATION = gql`
      mutation CreateChatMutation($content: String!, $from: String!) {
        createChat(content: $content, from: $from) {

    export default compose(
      graphql(ALL_CHATS_QUERY, { name: 'allChatsQuery' }),
      graphql(CREATE_CHAT_MUTATION, { name: 'createChatMutation' })
  1. Add the following to the render() method within App.js.
 const allChats = this.props.allChatsQuery.allChats || [];
       return (
          <div className="">
            <div className="container">
              { => (
                <Chatbox key={} message={message} />

              {/* Message content input */}
                onChange={e => this.setState({ content: })}
                placeholder="Start typing"

Now when you run `npm start`, you will see a chat box that says "Start typing" and be able to enter in new messages, however, you will only be able to see the new messages on reload! 

This is a problem. Let's fix it by <strong>setting up real time subscriptions</strong>. 

23) Add the following method to your `App` class to setup the subscription. 

_subscribeToNewChats = () => {
          document: gql`
            subscription {
              Chat(filter: { mutation_in: [CREATED] }) {
                node {
          updateQuery: (previous, { subscriptionData }) => {
            const newChatLinks = [
            const result = {
              allChats: newChatLinks
            return result;
  1. Add the following to the componentsDidMount method within the App class.


This starts the subscription.

  1. Run npm start. You should see a real time chat app that works!

Congratulations! You're Done!

Further implementation

Let’s deploy this to Heroku!

  1. Run heroku create (assuming you have Heroku CLI installed already)
  2. Delete the yarn.lock file in your root directory.
  3. git push heroku master in your CLI
  4. Run heroku open and it will open your web app!

Congratulations! You deployed your chat app to Heroku!

See a demo of what you’ll have created here:


How to Build a Real Time Chat App with React and GraphQL

Deploying with Zero Configuration with React in Heroku

Published 18 Jun 2018

founder && full stack && ethereum developer.
Max Goodman on Twitter