next-auth-hasura-example

An example repo of using next-auth with Hasura as the back-end. Based on https://hasura.io/learn/graphql/hasura-authentication/integrations/nextjs-auth/

Required:

• Node v14
• Yarn
• Git
• Docker
• Hasura CLI

Setting up Hasura

To launch Hasura for development

For the first time:

cd hasura
make jwt
# it will copy .env.example to .env and create JWT token inside your .env

Then

cd hasura
docker-compose up -d
# will launch postgres and Hasura containers
make console
# Will start Hasura console and tracking change (metadata/migrations) from the GUI.

Regroup your Hasura changes

Every action on your postgres tables will create a migration folder with timestamps and the sql code, you can merge these with the squash command.

hasura migrate squash --name 'squash-given-name' --from '{your older timestamps folder}'

Testing migrations

To test you newly created migrations what you can do is to reproduice a fresh install. To do so you can create a new repo and git clone this repo and copy your migrations but you will have to change the network Id and the db name inside your docker-compose.yaml, or you can delete your db without the need to create a new repo.

# Clean up Docker
cd /hasura
docker-compose down
docker volume ls
#... see the one you want to remove maybe "hasura_db_..."
docker volume rm name_of_your_volume
# now you can docker-compose up and do the migration (metadata and migrations)

🚀 Deployment

Hasura: use the hasura cli with the Makefile

# Make the migrations
make migrate-apply
# Update the metadata
make metadata-apply

Setting up front-end

Configure your local environment

Copy the .env.local.example file in this directory to .env.local (which will be ignored by Git):

cp .env.local.example .env.local

Add details in .env.local.

Start the application

To run your site locally, use:

npm run dev