A Next.js starter kit template with React 17 + Typescript + Tailwind CSS 2 + React Query 3 + NextAuth.js (with GitHub Auth + Passwordless Auth) + Fauna DB
-
Clone the project
git clone https://github.com/pbteja1998/nextjs-starter.git
-
Go to the project directory
cd nextjs-starter
-
Install dependencies
yarn
-
Create .env.local and change env variables as per the instructions.
cp .env.example .env.local
-
Setup the database by running the following command and pasting the Fauna Secret key when prompted. More details at fauna-schema-migrate.
yarn setup-db
-
Start the server
yarn dev
To run this project, you will need to add the following environment variables to your .env.local
file
NEXTAUTH_URL
- This is the your application URL. Locally, you can set this to
http://localhost:3000
- This is the your application URL. Locally, you can set this to
SECRET
- Set this to any randomly generated string
EMAIL_SERVER
- This is the email server string. It's in the format of
smtp://username:[email protected]:587
. Replaceusername
,password
andsmtp.example.com
with your own credentials.
- This is the email server string. It's in the format of
EMAIL_FROM
- Your email address from which you are sending emails.
GITHUB_ID
GITHUB_SECRET
- You need to create a GitHub OAuth App, and get the GITHUB_ID AND GITHUB_SECRET from that app.
- You can follow these instructions.
- When creating an oauth app for local development, you can set the
Homepage URL
tohttp://localhost:3000
andAuthorization Callback URL
tohttp://localhost:3000/api/auth/callback/github
LINKEDIN_ID
LINKEDIN_SECRET
- You need to create an oauth app for LINKEDIN. You can set the callback URL to
http://localhost:3000/api/auth/callback/linkedin
- You need to create an oauth app for LINKEDIN. You can set the callback URL to
FAUNADB_SECRET
- Create a new fauna server key and set this variable to that key
Please note that this is completely optional. You can directly create your database in Fauna cloud and directly use the secret you generate there.
We are using Fauna Dev docker container to run Fauna instance locally.
These are the instructions to setup Fauna container locally.
# Pull the latest Docker container:
docker pull fauna/faunadb:latest
# Verify that the container executes correctly:
docker run fauna/faunadb --help
After you installed this, you can start the container using the following command
docker run --rm --name faunadb -p 8443:8443 -p 8084:8084 fauna/faunadb
Please note that this will create a new instance of Fauna everytime you run it, and all the data will be cleared when you stop this container. For other config options and approaches, go through the documentation.
Changes you need to do in the template:
- You have to set
USE_FAUNA_DOCKER=true
in your.env.local
file - Everytime you start the docker container, you need to first apply the migrations. You can do it by running
yarn setup-docker-db
. - More details at fauna-schema-migrate and Fauna Dev.
For feedback and support, please open an issue in this repo.
TBD
TBD
TBD
TBD