fe3f520d8d
Based on https://github.com/vercel/next.js/pull/26708 - Renames FaunaDB -> Fauna - Moves to Tailwind instead of bespoke styling - Use SWR instead of hand-rolled fetch wrapper - List/Create API for Guestbook - Preps for setting correct environment variables from Vercel integration |
||
---|---|---|
.. | ||
components | ||
lib | ||
pages | ||
public/static | ||
scripts | ||
.env.local.example | ||
.gitignore | ||
jsconfig.json | ||
package.json | ||
postcss.config.js | ||
README.md | ||
schema.gql | ||
tailwind.config.js |
Fauna GraphQL Guestbook Starter
This Guestbook Single-Page Application (SPA) example shows you how to use Fauna's GraphQL endpoint in your Next.js project.
Deploy your own
Deploy the example using Vercel:
Why Fauna
By importing a .gql
or .graphql
schema into Fauna (see our sample schema file), Fauna will generate required Indexes and GraphQL resolvers for you -- hands free 👐 (some limitations exist).
How to use
Execute create-next-app
with npm or Yarn to bootstrap the example:
npx create-next-app --example with-fauna with-fauna-app
# or
yarn create next-app --example with-fauna with-fauna-app
You can start with this template using create-next-app
or by downloading the repository manually.
To use a live Fauna database, create a database at dashboard.fauna.com and generate an admin token by going to the Security tab on the left and then click New Key. Give the new key a name and select the 'Admin' Role. Copy the token since the setup script will ask for it. Do not use it in the frontend, it has superpowers which you don't want to give to your users.
The database can then be set up with the delivered setup by running:
npm run setup
# or using yarn
yarn setup
This script will ask for the admin token. Once you provide it with a valid token, this is what the script automatically does for you:
- Import the GraphQL schema, by importing a GraphQL schema in Fauna, Fauna automatically sets up collections and indexes to support your queries. This is now done for you with this script but can also be done from the dashboard.fauna.com UI by going to the GraphQL tab
- Create an index and UDF, in order to implement custom sorting (by createdAt field), we need to create a GraphQL resolver that uses UDF based on sorting index.
- Create a role suitable for the Client, Fauna has a security system that allows you to define which resources can be accessed for a specific token. That's how we limit our clients powers, feel free to look at the scripts/setup.js script to see how we make roles and tokens.
- Create a token for that role, this is the token to be used in the app.
At the end, a .env.local
file will be created for you with the newly generated client token assigned to an environment variable.
Run locally
Install packages, set up if needed, then run the development server:
npm install
# if you haven't run setup yet
npm run setup
npm run dev
# or using yarn
yarn
# if you haven't run setup yet
yarn setup
yarn dev
Your app should be up and running on http://localhost:3000!