Demo for a modern app (webpack) with legacy Angular apps (1.x)

Includes following:

• Webpack 2 (modules, assets bundling)
• babel (ES2015 support)
• ng-annotate
• karma test runner configuration with code coverage reports
• node-sass for styles + AutoPrefixer

Requirements:

• NodeJS 6+ is required.

Usage

1. Install dependencies npm i
2. Start dev server npm yarn dev open http://localhost:2992
3. Lint your code npm run lint
4. Run unit tests npm run test
5. Create build for deployment npm run build for production build, or npm run build-dev for development build

---

Getting started

Angular Guide

At first be sure that you are familiar with ES2015, some useful materials:

• tutorial from BabelJS
• Exploring ES6: Upgrade to the next version of JavaScript by Dr. Axel Rauschmayer

Read Airbnb JavaScript Style Guide - it is important to know, what is good and what is not, and why.

At least briefly read webpack documentation it is crucial to understand how it works in general.

---

Usage advice

Directory layout

├── build              # build stats
├── public             # public folder (webroot for dev server)
│   ├── _assets        # build results - assets packed by webpack
│   └── index.html     # one of app entry points, for dev server
└── src                # app sources
    ├── demo           # one of app modules
    ├── index.js       # app entry module
    ├── index.scss     #
    └── index.test.js  # entry point for test karma

Styleguide

• Angular Style Guide, by John Papa
• Angular 1.x styleguide, by Todd Motto

---

Angular specific conventions

Application organisation rules:

1. Split app into angular "modules"
   • every module should have own folder, and should be defined in one file which will require all module components and will export module name
   • module can have nested modules
   • module can require other modules which are direct siblings of it or parent modules, or modules nested in it (if you need to require module that is nested in "sibling" - you you should move it up by hierarchy before requiring it)
2. Keep modules small - if module is too big, maybe it should be few modules
3. Every file should have only one entity inside it, for example if there is directive which has controller and template - there should be three files, plus likely two for unit tests
4. Group related resources by folders
5. Name files with suffixes Directive, Controller, Factory, Service, Provider
6. Use .test suffix for test file names

Directives

1. Prefer to use isolated scopes
2. Use controllerAs syntax
3. Controller should act as ViewModel, use $scope only if you need it
4. All model layer (data fetching, business logic) should be in services