jerrolkrause/mello-angular-starter

A rapid starter for mello Angular single page apps. Contains Angular, Typescript, Bootstrap 4, Ng-Bootstrap & Ngrx-Store (Redux).

Mello Angular Starter

An Angular Seed/Starter based on the excellent https://github.com/AngularClass/angular2-webpack-starter. This repo's main purpose to kickstart mello webapps with our core technology stack.

Includes the following additional elements:

• Angular 6+
• TypeScript 2 barrels/paths
• Bootstrap 4
• Ng-Boostrap
• Ngrx-Store (Redux)

Lots and lots of scaffolding/boilerplate for rapid development:

• REST API with complete state management (with loading/success/error)
• Fully e2e Ngrx-Store with effects for API interaction
• Standard webapp security elements: token authentication and http interceptors
• Intelligent application exception/error handling and logging
• Intuitive flyout mobile nav (missing fron ng-bootstrap)
• Title service for SEO & bookmarking
• Boilerplate SCSS for common UI components

Quick Start

# clone the repo
# --depth 1 removes all but one .git commit history
git clone --depth 1 https://github.com/JerrolKrause/angular-ultimate-starter.git

# change directory to our repo
cd angular-ultimate-starter

# install the repo with yarn
yarn

# Dev server with HMR
npm run server:dev:hmr

# Build with:
npm run build:aot

# Serve prod build with:
npm run server:prod

# Update all npm packages
npm install -g npm-check-updates && ncu -a && npm i && yarn

Install Information

What you need to run this app:

• node and npm (brew install node) | https://nodejs.org/en/download/
• Ensure you're running the latest versions Node v6.x.x+ (or v7.x.x) and NPM 3.x.x+

If you have npm installed, which is highly recommended (brew install npm) you can do a npm install --lts && npm use in $ to run with the latest Node LTS. You can also have this zsh done for you automatically

Once you have those, you should install these globals with npm install --global:

• npm install --global webpack (webpack)
• npm install --global webpack-dev-server (webpack-dev-server)
• npm install --global karma-cli (karma)
• npm install --global protractor (protractor)
• npm install --global typescript (typescript)
• npm install --global yarn (yarn)

Useful Utilities

# Update package.json to latest version
npm-check-updates -u
yarn