As the name suggests, Hasura Next.js Boilerplate is a boilerplate for building applications using Hasura and Next.js. This boilerplate will let you up and running with a Next.js front-end and Hasura back-end application easily.
A special mention to this boilerplate which helped in simplifying a lot of code generation.
This boilerplate is built on top of Next.js and Hasura. So, you get all the benefits and features that these two softwares provide. However, the following features are the most important ones:
- Automatic compilation and bundling of Next.js which ensures optimized code during production builds.
- Pre-rendering of pages at build time (SSG) or request time (SSR).
- Support for TypeScript.
- File-system routing which helps in adding new routes to your application.
- Support for optimized images out of the box.
- Instant real-time GraphQL APIs.
- Built-in authorization and authentication.
Hasura Next.js Boilerplate is a boilerplate for building applications using Hasura and Next.js. This boilerplate consists of the following:
This boilerplate is built using the following technologies:
It supports GraphQL Query, Mutation and Subscription out of the box.
- Frontend: Next.js application
This application is the primary user-facing application. Once it’s up and running (see Development section), it’s available on http://localhost:3000.
- Backend: Dockerized Hasura application
Hasura is an open source engine that connects to our databases & micro-services and auto-generates a production-ready GraphQL backend. It’s very easy to get Hasura up and running on our local system. All the migrations are set up in the migrations directory.
-
Clone the application:
git clone git@github.com:ghoshnirmalya/nextjs-hasura-boilerplate.git
-
Run the bootstrap script by running the following command from the root of your project:
cd nextjs-hasura-boilerplate && yarn bootstrap
-
Create a Google OAuth Client from https://console.developers.google.com/apis/credentials/oauthclient and copy the credentials to
GOOGLE_CLIENT_ID
andGOOGLE_CLIENT_SECRET
in your.env
file inside thefrontend
directory. -
Start Docker and run both the applications by running the following command from the root of your project:
yarn dev
We need to start Docker and then run the above command. The Hasura console will be available at http://localhost:8080/console. The Hasura GraphQL endpoint will be up and running on http://localhost:8080/v1/graphql. The Next.js application will be available at http://localhost:3000/.
Click on the button below to deploy the frontend application on Vercel. You'll need to sign up for a free Vercel account.
Click on the button below to deploy the backend application on Heroku. You'll need to sign up for a free Heroku account.
This project is licensed under the MIT License.