angular2-seed editorconfig travis-ci karma npm

Seed project for Angular 2 apps

Introduction

Join the chat at https://gitter.im/mgechev/angular2-seed Dependency Status devDependency Status Build Status

A seed project for Angular 2 apps.

It is something similar to the AngularJS Quick Start but does the entire build with gulp.

Note: Angular 2.0 is not production ready yet! This seed project is perfect for playing around with the latest versions but do not start new projects with it since a lot of new changes are going to be introduced until the framework is officially released.

How to start

Note that this seed project requires node v0.12.x or higher and npm 3.x.x.

git clone https://github.com/mgechev/angular2-seed.git
cd angular2-seed
npm install   # clean npm cache & delete node_modules folder if you get an error
npm start     # start with --env dev

Does not rely on any global dependencies.

Directory Structure

.
├── LICENSE
├── README.md
├── app
│   ├── bootstrap.ts
│   ├── components
│   │   ├── about
│   │   │   ├── about.html
│   │   │   ├── about.ts
│   │   │   └── about_spec.ts
│   │   ├── app
│   │   │   ├── app.css
│   │   │   ├── app.html
│   │   │   ├── app.ts
│   │   │   └── app_spec.ts
│   │   └── home
│   │       ├── home.css
│   │       ├── home.html
│   │       ├── home.ts
│   │       └── home_spec.ts
│   ├── index.html
│   ├── services
│   │   ├── name_list.ts
│   │   └── name_list_spec.ts
│   ├── system.config.js
│   └── typings.d.ts
├── gulpfile.ts
├── karma.conf.js
├── package.json
├── test
│   ├── components
│   │   ├── about
│   │   │   ├── about.js
│   │   │   └── about_spec.js
│   │   ├── app
│   │   │   ├── app.js
│   │   │   └── app_spec.js
│   │   └── home
│   │       ├── home.js
│   │       └── home_spec.js
│   └── services
│       ├── name_list.js
│       └── name_list_spec.js
├── test-main.js
├── tools
│   ├── config.ts
│   ├── preinstall.js
│   ├── tasks
│   │   ├── build.csslib.dev.ts
│   │   ├── build.fonts.ts
│   │   ├── build.index.dev.ts
│   │   ├── build.js.dev.ts
│   │   ├── build.jslib.dev.ts
│   │   ├── build.sass.dev.ts
│   │   ├── build.test.ts
│   │   ├── clean.ts
│   │   ├── karma.start.ts
│   │   ├── npm.ts
│   │   ├── server.start.ts
│   │   ├── tsd.ts
│   │   ├── tslint.ts
│   │   ├── watch.dev.ts
│   │   ├── watch.serve.ts
│   │   └── watch.test.ts
│   ├── typings
│   │   ├── connect-livereload.d.ts
│   │   ├── gulp-load-plugins.d.ts
│   │   ├── karma.d.ts
│   │   ├── mini-lr.d.ts
│   │   ├── ng2_test.d.ts
│   │   ├── open.d.ts
│   │   ├── run-sequence.d.ts
│   │   ├── slash.d.ts
│   │   └── yargs.d.ts
│   ├── utils
│   │   ├── server.ts
│   │   ├── tasks-tools.ts
│   │   ├── template-injectables.ts
│   │   └── template-locals.ts
│   └── utils.ts
├── tsconfig.json
├── tsd.json
└── tslint.json

Configuration

Default application server configuration

var PORT             = 5555;
var LIVE_RELOAD_PORT = 4002;
var APP_BASE         = '/';

Configure at runtime

npm start -- --port 8080 --reload-port 4000 --base /my-app/

Now to extend?

If you want to use your custom libraries:

npm install my-library --save
vim tools/config.js

Add reference to the installed library in PATH.src.jslib (or whatever you like).

Running test

npm test

# Debug - In two different shell windows
npm run build.test.watch      # 1st window
npm run karma.start           # 2nd window

Contributing

Please see the CONTRIBUTING file for guidelines.

Contributors

mgechev ludohenin tarlepp NathanWalker aboeglin ryzy
mgechev ludohenin tarlepp NathanWalker aboeglin ryzy
jerryorta-dev TuiKiken markharding ultrasonicsoft mjwwit natarajanmca11
jerryorta-dev TuiKiken markharding ultrasonicsoft mjwwit natarajanmca11
philipooo redian robertpenner jgolla dstockhammer
philipooo redian robertpenner jgolla dstockhammer

Change Log

You can follow the Angular 2 change log here.

License

MIT

Related Repositories

angular2-seed

angular2-seed

:seedling: A simple Angular 2 seed featuring Angular 2 and Webpack 2 by @AngularClass ...

angular2-react-native-seed

angular2-react-native-seed

A seed project to create a native mobile application with Angular 2 and React Native ...

angular2-login-seed

angular2-login-seed

Seed app featuring Angular2, Node.js + Express, and OAuth login support via Passport ...

angular2-seed

angular2-seed

Seed project to run angular2 out of the box, integrated with wepack and babel ...


Top Contributors

mgechev ludohenin tarlepp NathanWalker aboeglin ryzy jerryorta-dev TuiKiken briantopping dstockhammer jesperronn jimthedev markharding mjwwit natarajanmca11 philipooo redian robertpenner sclausen gitter-badger jgolla ultrasonicsoft

Releases

-   2.0.0-alpha.42 zip tar
-   2.0.0-alpha.41 zip tar
-   2.0.0-alpha.40 zip tar
-   2.0.0-alpha.39 zip tar
-   2.0.0-alpha.38 zip tar
-   2.0.0-alpha.37 zip tar
-   2.0.0-alpha.36 zip tar
-   2.0.0-alpha.35 zip tar
-   2.0.0-alpha.34 zip tar
-   2.0.0-alpha.33 zip tar
-   2.0.0-alpha.32 zip tar
-   2.0.0-alpha.31 zip tar
-   2.0.0-alpha.30 zip tar
-   2.0.0-alpha.29 zip tar
-   2.0.0-alpha.28 zip tar
-   2.0.0-alpha.27 zip tar
-   2.0.0-alpha.26 zip tar
-   2.0.0-alpha.25 zip tar
-   2.0.0-alpha.24 zip tar
-   2.0.0-alpha.13 zip tar