History

JJ Kasper 0ab6ad5241 Update default gitignore templates (#39051 )		2022-07-26 20:08:40 -05:00
..
pages	Example: Static Generation of local Apollo GraphQL schema (#13202 )	2020-05-27 06:05:10 +00:00
shared/query-graphql	Example: Static Generation of local Apollo GraphQL schema (#13202 )	2020-05-27 06:05:10 +00:00
.gitignore	Update default gitignore templates (#39051 )	2022-07-26 20:08:40 -05:00
package.json	Remove `licence` from all `example/package.json` that has them (#28007 )	2021-08-14 10:48:39 -05:00
README.md	Update `pnpm create next-app` for latest pnpm 6 and 7 (#37254 )	2022-05-27 21:21:40 +00:00

README.md

Consume local Apollo GraphQL schema to create Static Generation export

Next.js ships with two forms of pre-rendering: Static Generation and Server-side Rendering. This example shows how to perform Static Generation using a local Apollo GraphQL schema within getStaticProps and getStaticPaths. The end result is a Next.js application that uses one Apollo GraphQL schema to generate static pages at build time and also serve a GraphQL API Route at runtime.

Deploy your own

Deploy the example using Vercel or preview live with StackBlitz

How to use

Execute create-next-app with npm, Yarn, or pnpm to bootstrap the example:

npx create-next-app --example api-routes-apollo-server api-routes-apollo-server-app
# or
yarn create next-app --example api-routes-apollo-server api-routes-apollo-server-app
# or
pnpm create next-app --example api-routes-apollo-server api-routes-apollo-server-app

Deploy it to the cloud with Vercel (Documentation).

Notes

Static Export

If you wish to export a static HTML + JS version of the site you need to first change the setting in this example in ./pages/[username].js where getStaticPaths has fallback: true - this needs to be false for static export to work. You can then run npm run build and npm run export to export the site as a static folder in ./out directory.