I created a template that will enable developers to quickly bootstrap an Apollo GraphQL + TypeScript project, which can be deployed in a serverless fashion on Netlify. Also, with the FaunaDB addon, it will enable developers to have a stateful app. Thus, developers can concentrate on core application logic and scale the application as their app grows at the same time they don't have to sacrifice on security.
Netlify functions enable developers to deploy lambda functions. They have a template for Apollo GraphQL as well. However, this template doesn't support TypeScript. Limiting the advantages of GraphQL to just querying and mutating data. Having TypeScript helps developers to change code with reliability. This also enhances overall experience with GraphQL as schema defined in GraphQL can be directly exported to TypeScript types.
For such cases, Netlify recommends using legacy command
netlify-lambda command. But people ran into other issues using it.
GraphQL PlayGround: https://apollo-graphql-typescript.netlify.app/.netlify/functions/graphql
Template for serverless Apollo + GraphQL + TypeScript app deployed on Netlify
Template for serverless typed GraphQL app deployed on netlify.
How it works
The client side of the app is deployed as static code on netlify. The GraphQL side of the application is developed using
apollo-server-lambda and is deployed as netlify function. Netlify deploys each function as AWS lambda. You can read more about it here.
Although, there is a default template which can be quickly bootstraped using the command
netlify functions:create, it doesn't support TypeScript and requires developer to use legacy
netlify-lambda command. But using the legacy command further complicates the application and also has a few issues which you can read here.
In this template, I transpile the lambda directory using
tsc command during the build process. Thus eleminating the need to use
netlify-lambda. And I find this is a much more cleaner approach.
netlify dev command…
I integrated TypeScript at the build time itself. Thus there is no need to use the legacy command.
I further integrated
graphql-codegen to automatically generate TypeScript types for GraphQL schema. And also integrated
husky to introduce lint checks and validate them before each commit.
I created a demo project using this template and also integrated FaunaDB addon on GitHub.