Angular2 Webpack Starter

A starter kit featuring Angular 2 (Router, Forms, Http, Services), TypeScript, and Webpack by AngularClass.

If you're looking for Angular 1.x please use NG6-starter

This repo serves as an extremely minimal starter for anyone looking to get up and running with Angular 2 and TypeScript. Using a Webpack for building our files and assisting with boilerplate.

• Best practice in file organization for Angular 2.
• Ready to go build system using Webpack for working with TypeScript.

Quick start

Clone/Download the repo then edit app-simple.ts inside /src/app/components/app-simple.ts

$ npm start # then open your browser and go to http://localhost:8080

Table of Contents

• File Structure
• Getting Started
  • Dependencies
  • Installing
  • Running the app
• Contributing
• TypeScript
• Frequently asked questions
• Todo
• Starter Kit Support and Questions
• License

File Structure

We use the component approach in our starter. This is the new standard for developing Angular apps and a great way to ensure maintainable code by encapsulation of our behavior logic. A component is basically a self contained app usually in a single file or a folder with each concern as a file: style, template, specs, e2e, and component class. Here's how it looks:

angular2-webpack-starter/
 ├──public/                                * static assets are served here
 │   ├──lib/                               * static libraries
 │   │   └──traceur-runtime.min.js         * ignore this file. This is needed to polyfill the browser to for ES6 features to similarly
 │   │
 │   ├──favicon.ico                        * replace me with your own favicon.ico
 │   ├──service-worker.js                  * ignore this. Web App service worker that's not complete yet
 │   ├──robots.txt                         * for search engines to crawl your website
 │   ├──human.txt                          * for humans to know who the developers are
 │   │
 │   └──index.html                         * Index.html: where we place our script tags
 │
 ├──src/                                   * our source files that will be compiled to javascript
 │   ├──app/                               * WebApp folder
 │   │   ├──bootstrap.ts                   * entry file for app
 │   │   │
 │   │   ├──components/                    * where most of components live
 │   │   │   ├──todo.ts                    * an example of a component using a service and forms
 │   │   │   ├──dashboard.ts               * a simple Component with a simple Directive example
 │   │   │   │
 │   │   │   ├──home/                      * example component as a folder
 │   │   │   │   ├──home.ts                * how you would require your template and style files
 │   │   │   │   ├──home.css               * simple css file for home styles
 │   │   │   │   └──home.html              * simple html file for home template
 │   │   │   │
 │   │   │   └──app-simple.ts              * the simple version of our App component components
 │   │   │   └──app.ts                     * App.ts: entry file for components
 │   │   │
 │   │   ├──services/                      * where we keep our services used throughout our app
 │   │   │   ├──TodoService.ts             * an example of a simple service 
 │   │   │   └──services.ts                * where we gather our injectables from our services
 │   │   │
 │   │   ├──pipes/                         * where we keep our custom pipes
 │   │   │   ├──rxAsync.ts                 * upgrade async pipe with Rx support
 │   │   │   └──pipes.ts                   * where we gather our custom pipes
 │   │   │
 │   │   └──directives/                    * where we keep our directives used throughout our app
 │   │       ├──Autofocus.ts               * another simple directive to fix a problem with the router
 │   │       └──directives.ts              * where we gather our directives from our directives
 │   │
 │   └──common/                            * where common files used throughout our app
 │       ├──shadowDomInjectables.ts        * injectables to change the use of ShadowDom Strategy for each Component
 │       ├──changeDetectionInjectables.ts  * injectables to change Angular's Change Detection Strategy
 │       ├──locationInjectables.ts         * injectables to change the Router location Strategy
 │       ├──formDirectives.ts              * turn on Just-In-Time Change Detection
 │       └──BrowserDomAdapter.ts           * ignore this. we need to set the DomAdapter to the browser
 │
 ├──typings/                               * where tsd defines it's types definitions
 │   ├──_custom/                           * where we define our custom types
 │   │   ├──ng2.d.ts                       * where we patch angular2 types with our own types until it's fixed
 │   │   └──custom.d.ts                    * we include all of our custom types here
 │   │
 │   ├──angular2/
 │   │   └──angular2.d.ts                  * our Angular 2 type definitions
 │   │
 │   ├──es6-promise/
 │   │   └──es6-promise.d.ts               * ES6 promises type definitions
 │   │
 │   ├──rx/
 │   │   ├──rx-lite.d.ts                   * rx-lite type definitions
 │   │   └──rx.d.ts                        * rx type definitions
 │   │
 │   └──tsd.d.ts.ts                        * our main file for all of our type definitions
 │
 ├──server/                                * this is a stub for very basic server configurations
 │
 ├──tsconfig.json                          * config that webpack uses for typescript
 ├──tsd.json                               * config that tsd uses for managing it's definitions
 ├──package.json                           * what npm uses to manage it's dependencies
 └──webpack.config.js                      * our webpack config

Getting Started

Dependencies

What you need to run this app:

• node and npm (brew install node)
• Ensure you're running the latest versions Node v0.12.2+ and NPM 2.10.0+

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

• webpack (npm install -global webpack)
• webpack-dev-server (npm install -global webpack-dev-server)

Installing

• fork this repo
• clone your fork
• npm install to install all dependencies
• npm run server to start the server

Running the app

After you have installed all dependencies you can now run the app. Run npm run server to start a local server using webpack-dev-server which will watch, build (in-memory), and reload for you. The port will be displayed to you as http://localhost:8080 (or if you prefer IPv6 then it's http://[::1]:8080/).

server

$ npm run server

build files

$ npm run build

watch and build files

$ npm run watch

Contributing

You can include more examples as components but they must introduce a new concept such as Home component (separate folders), and Todo (services). I'll accept pretty much everything so feel free to open a Pull-Request

TypeScript

To take full advantage of TypeScript with autocomplete you would have to install it globally and use an editor with the correct TypeScript plugins.

Use latest TypeScript compiler

TypeScript 1.5 beta includes everything you need. Make sure to upgrade, even if you installed TypeScript previously. We're using the release-1.5 branch that is going to be the stable branch of the 1.5 release

$ npm install -global git://github.com/Microsoft/TypeScript.git#release-1.5

.d.ts Typings

The typings in typings/ are partially autogenerated, partially hand written. All the symbols should be present, but probably have wrong paramaters and missing members. Modify them as you go.

$ npm install -global tsd

You may need to require reference path for your editor to autocomplete correctly

/// <reference path="../../typings/tsd.d.ts" />

Otherwise including them in tsd.json is prefered

Use a TypeScript-aware editor

We have good experience using these editors:

• Visual Studio Code
• Webstorm 10
• Atom with TypeScript plugin
• Sublime Text with Typescript-Sublime-Plugin

Frequently asked questions

• Why we are using traceur-runtime? This for the ES6 polyfills.
• What's the current browser support for Angular 2 Alpha? as of version 2.0.0-alpha.26: Chrome (43, 44, 45), Firefox (37, 39, 40), IE 11, Safari 8, iOS 8, Android 5.1 (Chrome Mobile 39).
• What is the TypeScript warning "Value of type 'typeof Directive' is not callable. Did you mean to include 'new'?"? This is an error with the typings defined in DefinitelyTyped (please ignore until it's fixed)
• How to I use moduleId with module.id in webpack? please use __filename if you must use templateUrl and styleUrls rather than webpack's module system
• Why is my service not injecting parameter correctly? please use @Injectable() for your service for typescript to corrrectly attach the metadata (this is a typescript beta problem)

Todo

• production/development environments
• bootstrap example
• testing
• e2e
• production services examples
• universal (isomorphic) example
• small/medium/large abstraction examples
• Material Design example
• hot-component-reloading

Starter Kit Support and Questions

Contact us anytime for anything about this repo

• Gitter: angular-class/angular2-webpack-starter
• Twitter: @AngularClass

---

enjoy — AngularClass

##AngularClass

Learn Angular in 2 days from the best

License

MIT