GRANDstack Starter

This project is a starter for building a GRANDstack (GraphQL, React, Apollo, Neo4j Database) application.
There are two components to the starter:

The UI application (a React app)
The API app (GraphQL server).

Install

At the root project folder:

First building neo4j image:
docker build -t registry-mycompany-neo4j registry-mycompany/neo4j
Now nodejs image:
docker build -t registry-mycompany-nodejs registry-mycompany/nodejs
Starting everything:
docker-compose up -d

Extra install steps:

Changing your hosts (MAC AND LINUX) (MANDATORY)

You need to go to your /etc/hosts file and add the lines below:

127.0.0.1   proxy.local.mycompany.com  
127.0.0.1   neo4j.local.mycompany.com  
127.0.0.1   api.local.mycompany.com  
127.0.0.1   ui.local.mycompany.com

Now it will be possible to use a real full address, and not the old (and lame) 'localhost:port'

Changing neo4j password: (OPTIONAL, but recommended)

Go to: http://neo4j.local.mycompany.com:7474
In order to change the neo4j password

Username: neo4j
password: letmein

Type the command:
:server change-password

just create a new password and then change the variable
NEO4J_PASSWORD
in the api container at docker-compose.yml file

Seeding data into DB (OPTIONAL)

docker exec -it api.local.mycompany.com yarn run seedDb

The project specifications

Neo4J image

neo4j: 3.5
APOC_VERSION 3.5.0.1
GRAPHQL_VERSION 3.5.0.1

WARNING

This image has a peculiarity

ENV NEO4J_AUTH=neo4j/letmein

This means the password for neo4j is already 'letmein'
I strongly recommend you to change this!
and then change the variable NEO4J_PASSWORD
in the api container at docker-compose.yml

NodeJS image

NODE_VERSION 10.14.2
YARN_VERSION 1.12.3
SO: debian:jessie-slim
Final image size: 185MB

Docker Compose

jwilder/nginx-proxy:latest
api and ui use 80 port

Neo4j

You need a Neo4j instance:
There is one already in this project for local purposes

But in production you will need some:

For schemas using the @cypher directive (as in this repo) via neo4j-graphql-js, you need to have the APOC library installed, which should be automatic in Sandbox, Cloud and is a single click install in Neo4j Desktop. If when using the Sandbox / cloud you encounter an issue where an error similar to Can not be converted to long: org.neo4j.kernel.impl.core.NodeProxy, Location: [object Object], Path: users appears in the console when running the React app, try installing and using Neo4j locally instead.

Sandbox

A good, but old, tutorial can be found here: https://www.youtube.com/watch?v=rPC71lUhK_I

See the project releases for the changelog.

thelovesmith/grand-stack-starter