GraphQL Node/React Boilerplate
GraphQL Node/React Boilerplate, (GNRP for short) is a fast way to start building out a custom GraphQL project. And yes, GraphQL is as awesome as promised.
You can find the open source code on github. It is available for non-commercial use.
Warning: This repo is still using an old version of Apollo (apollo-client). Apollo has gone through a number of improvements & breaking changes. I intend to upgrade this repo to a newer version, and will do so when I have more time.
- Fork the repository
- yarn install
- make containers-up
- make watch
Why all of the above tech? Not for the sake of just using them, of course... they enable real engineering & business value in the form of some of the following features.
- Docker-based Services
- GraphQL + Restful Endpoints
- GraphQL Subscriptions (Real-time Pub/Sub)
- React Server-side Rendering
- JWT-based Authentication
- Simple, Abstracted File Store
- CRON Workers w/ Distributed Lock
- Nightwatch E2E Tests
- MJML Email Templates
- Email Tracking (Opens, Clicks, Spam Reports, etc)
- API Request Timing Logs
- Signup UTM Tracking
- Basic Recurring Payments
- Easy Send-to-Slack Channel Notifications
- Node.js, Express
- GraphQL, Apollo
- Postgres, Sequelize
- Nightwatch, Selenium
- HTML, MJML, CSS
This is a heavily stripped down code-base that ran our startup, Jobstart, in production for more than year and a half with 99% uptime. We were involved in the GraphQL & Apollo communities, presented some of our ideas at Apollo Day, and published one of the top guides to getting started with GraphQL.
We've implemented custom solutions to some issues, which are included in this project and available as separate repositories:
- Apollo-errors (6,400 weekly downloads)
- Apollo-resolvers (1,400 weekly downloads)
This boilerplate works, but best practices as defined by open-source communities are always changing, especially for GraphQL.
Integrations & Connectors
In order to accomplish
- Google Maps (Places)