https://github.com/the-road-to-graphql/fullstack-apollo-express-mongodb-boilerplate

💥A sophisticated GraphQL with Apollo, Express and MongoDB boilerplate project.
https://github.com/the-road-to-graphql/fullstack-apollo-express-mongodb-boilerplate

apollo-client apollo-server apollo-server-express apollographql authentication authorization boilerplate fullstack mongo mongodb mongodb-boilerplate mongodb-database react react-apollo react-apollo-graphql reactjs starter-kit

Last synced: about 1 month ago
JSON representation

💥A sophisticated GraphQL with Apollo, Express and MongoDB boilerplate project.

• Host: GitHub
• URL: https://github.com/the-road-to-graphql/fullstack-apollo-express-mongodb-boilerplate
• Owner: the-road-to-graphql
• License: mit
• Created: 2018-11-28T00:41:12.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2020-06-12T08:44:08.000Z (almost 5 years ago)
• Last Synced: 2025-03-30T19:11:09.278Z (about 2 months ago)
• Topics: apollo-client, apollo-server, apollo-server-express, apollographql, authentication, authorization, boilerplate, fullstack, mongo, mongodb, mongodb-boilerplate, mongodb-database, react, react-apollo, react-apollo-graphql, reactjs, starter-kit
• Language: JavaScript
• Homepage: https://www.robinwieruch.de
• Size: 1.79 MB
• Stars: 339
• Watchers: 13
• Forks: 102
• Open Issues: 26
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# fullstack-apollo-express-mongodb-boilerplate

[![Build Status](https://travis-ci.org/the-road-to-graphql/fullstack-apollo-express-mongodb-boilerplate.svg?branch=master)](https://travis-ci.org/the-road-to-graphql/fullstack-apollo-express-mongodb-boilerplate) [![Slack](https://slack-the-road-to-learn-react.wieruch.com/badge.svg)](https://slack-the-road-to-learn-react.wieruch.com/) [![Greenkeeper badge](https://badges.greenkeeper.io/the-road-to-graphql/fullstack-apollo-express-mongodb-boilerplate.svg)](https://greenkeeper.io/)

A full-fledged Apollo Server with Apollo Client starter project with React and Express. [Read more about it in this tutorial to build it yourself](https://www.robinwieruch.de/graphql-apollo-server-tutorial/).

Further Readings:

 * [MongoDB Setup](https://www.robinwieruch.de/mongodb-express-setup-tutorial/)

 * [TODO: write migration tutorial]

**Family of universal fullstack repositories:**

Server Applications:

* [Node.js with Express + MongoDB](https://github.com/the-road-to-graphql/fullstack-apollo-express-mongodb-boilerplate)

* [Node.js with Express + PostgreSQL](https://github.com/the-road-to-graphql/fullstack-apollo-express-postgresql-boilerplate)

Client Applications:

* [React Client](https://github.com/the-road-to-graphql/fullstack-apollo-react-boilerplate)

## Features of Client + Server

* React (create-react-app) with Apollo Client

  * Queries, Mutations, Subscriptions

* Node.js with Express and Apollo Server

  * cursor-based Pagination

* MongoDB Database with Mongoose

  * entities: users, messages

* Authentication

  * powered by JWT and local storage

  * Sign Up, Sign In, Sign Out

* Authorization

  * protected endpoint (e.g. verify valid session)

  * protected resolvers (e.g. e.g. session-based, role-based)

  * protected routes (e.g. session-based, role-based)

* performance optimizations

  * example of using Facebook's dataloader

* E2E testing

## Installation

* `git clone [email protected]:the-road-to-graphql/fullstack-apollo-express-mongodb-boilerplate.git`

* `cd fullstack-apollo-express-mongodb-boilerplate`

* `touch .env`

* `npm install`

* fill out *.env file* (see below)

* `npm start`

* [start MongoDB](https://www.robinwieruch.de/mongodb-express-setup-tutorial/)

* visit `http://localhost:8000` for GraphQL playground

#### .env file

Since this boilerplate project is using MongoDB, you have to install it for your machine and get a database up and running. You find everything for the set up over here: [Setup MongoDB with Mongoose in Express Tutorial](https://www.robinwieruch.de/mongodb-express-setup-tutorial) [TODO: write setup tutorial]. After you have created a MongoDB database, you can fill out the environment variables in the *server/.env* file.

```

SECRET=asdlplplfwfwefwekwself.2342.dawasdq

DATABASE_URL=mongodb://localhost:27017/mydatabase

```

The `SECRET` is just a random string for your authentication. Keep all these information secure by adding the *.env* file to your *.gitignore* file. No third-party should have access to this information.

#### Testing

* adjust `test:run-server` npm script with `TEST_DATABASE_URL` environment variable in package.json to match your testing database name

* one terminal: npm run test:run-server

* second terminal: npm run test:execute-test

## Want to learn more about React + GraphQL + Apollo?

* Don't miss [upcoming Tutorials and Courses](https://www.getrevue.co/profile/rwieruch)

* Check out current [React Courses](https://roadtoreact.com)