boilerplate isomorphic typescript

Requirements/Recommended

• node v8+
• atom
  • Packages
    • atom-typescript
    • atom-lint
    • linter-tslint
• docker

Quick start

# first time
npm install

# every time
npm run server:dev

# for testing - browser debugging at http://localhost:9876/debug.html
npm run test:watch

Libraries

Libraries can be large (~250KB gzipped) and slow down rebuild times, so we build them separately from application code. We do this by using the webpack DLL plugin. This allows us to reference many different libraries from one external webpack bundle, allowing us to cache and reduce load times.

The lib file should be automatically regenerated when dependencies are updated. New dependencies may need to be added to the entry file client/js/src/libs.tsx

# to manually generate a new libs file
npm run build:lib

# to lock down npm libraries, so we can rebuild on different machines
npm shrinkwrap --dev

Deployment

We store data volumes seperate from containers, so we can push new versions by rebuilding images and relaunching containers.

After setting some env variables, we can do the usual docker-compose up -d;

# staging
export COMPOSE_PROJECT_NAME=bit_staging
export COMPOSE_FILE=docker-compose.stag.yml

# production
export COMPOSE_PROJECT_NAME=bit_production
export COMPOSE_FILE=docker-compose.prod.yml

proxy/load balancing

[traefik] is typically used as a front end load balancer/proxy, with a front loader like apache in front handling encryption, then passing traffick to docker on port 81

See traefik dir for an example that can be run with docker-compose up -d

Features

• typescript - javascript type support

Misc

Todos

---