Full Stack Packages

Fullstack packages to develop and test end to end; to use as packages or work independently.

Purpose:

The idea is to create modules for each package so it can work independently as well as integrated to another project as packages.

Screenshot

Useful commands:

command	Description
`lerna clean`	- removes the node_modules directory from all packages.
`npm start`	- starts the web server and backend server. Or Use `npm run zen:watch`
`npm run zen:watch`	- starts the web server and backend server in watch mode.
`npm run zen:watch:debug`	- starts the web server and backend server in debug and watch mode.
`npm run watch`	- build the packages in watchmode (Useful for development)
`npm run lerna`	- install external dependencies at the repo root so they're
`npm run build`	- build all the packages
`npm install`	- runs `lerna` and `build`
`lerna publish`	- publishes packages in the current Lerna project.

Files explained:

It uses lerna.json for creating the packages structure. Under packages you can create different modules based on its usage. For example:

 packages                    - Has the packages to organize the codebase into multi-package repositories.
     sample-core             - Core interfaces of the packages which can be shared between server and client.
     sample-server-core      - Core interfaces and its implementation code for Server.   
     sample-client-state     - Client State related code which consists of Redux and Graphql Gql
     sample-client-react     - React pure components and containers are defined. 
     sample-graphql-schema   - Graphql Schema for Server.
 servers                     - Has the packages to organize the codebase into multi-package repositories.
     frontend-server         - Frontend Client Server. This is useful to show demo of this package.
     backend-server          - Backend apollo server.

Getting Started

If you want to develop FullStack locally you must follow the following instructions:

Clone fullstack-pro locally

git clone https://github.com/cdmbase/fullstack-pro
cd fullstack-pro

Install dependencies and build packages.

npm install && npm run build

Setup environment file

cp ./config/development/dev.env.sample ./config/development/dev.env

Seed development database data (not needed if it is not setup)

npm run db:seed

Start both client and server together

npm start

The graphql server endpoints are

http://localhost:8080/graphql

The browser server endopoint is

http://localhost:3000

To run build with watch. Useful for auto reloading changes into the server to be productive during development.

npm run watch

Server Side Rendering

Useful to run Frontend and Backend in two seperate servers.

to start frontend server

cd frontend-server
npm run build
npm start

to start backend server

cd backend-server
npm run db:seed
npm run build
npm start

Docker build

Prior to it you need to run npm install from root directory.

Build three docker images by following the steps:

Frontend Server

cd frontend-server
npm run docker:build

Backend Server

cd backend-server
npm run docker:build

hemera-server

cd hemera-server
npm run docker:build

Environment settings for non-development

GRAPHQL_URL
CLIENT_URL
NATS_URL
NATS_USER
NATS_PW

Troubleshoot

To troubleshoot webpack configuration run

npm run zen:watch:debug

Resources

Installing node-gyp

https://github.com/nodejs/node-gyp#installation

valeriuzdrobau/fullstack-pro