Note: This project was build as a part of a tutorial blog post, check out the tutorial here.
See live demo here(may be slow to load due to free hosting). This application demonstrates consuming GraphQl Api provided by Hasura GraphQL Engine using a react app. Uses react-apollo GraphQL client to make requests to the api. Users can create account using Auth0 JWT authentication which is then verified by Hasura. React-router is used to provide SPA experience.
Authenticated users can:
- Create new posts
- Like posts
- Follow user profiles
- Realtime updates when other users upvote a post, create a new post or follow user profile (updating apollo cache).
Installing and running on local system require:
- Setting up Hasura Server (deployed on Heroku), and creating required tables
- Setting up Auth0
- See this guide for Auth0 JWT Integration with Hasura
- Clone or download this repo, install the required packages and run
npm start
You will need the following npm packages:
- react-router-dom
- react-bootstrap
- apollo-boost
- @apollo/react-hooks
- apollo-link-context
- @apollo/react-hoc
- graphql
- @auth0/auth0-spa-js
Following tables required to be created:
type Post {
id - integer, primary key
caption - text
url - text
created_at - timestamp with time zone
user_id - text
}
type User {
name - text
last_seen - timestamp with time zone
avatar - text
email - text
id - text, primary key
}
type Like {
id - integer, primary key
user_id - text
post_id - integer
}
type Follow {
id - integer, primary key
follower_id - text
following_id - text
}
Post.user_id and User.id have object relationship in table Post and array relationship in table User. Like.post_id and Post.id have array relationship in table Post. Row and Column permissions should be given accordingly.
See Setting up Auth0 with react and this guide for Auth0 JWT Integration with Hasura. Here we are using Auth0 Universal Login.
Using apollo cache and react state, we can give realtime updates for likes, new posts and follows. Apollo refetchQueries function updates apollo cache with refetched data.
App:
User Profile:
