Home

Starter kit wiki

Roadmap

This is a prospective roadmap that may be subject to evolutions, as we refine the needs and possible solutions. For more precise view of the incoming evolutions, take a look at the milestones.

v0 [released]

• Web project seed (tooling based on gulp-angular yeoman generateor)
• TypeScript + jshint + jscs
• Bootstrap + customization entry points
• Less + autoprefixer + csso
• Live reload (browsersync)
• Unit tests (Karma/Jasmine)
• E2E tests (Protractor)
• Images/assets optimisation (imagemin)
• Base project architecture
• Development server, with API proxy
• Gulp + modular tasks for build, dev etc

v1 [released]

• Migrate base template to TypeScript, instead of JavaScript (keep JS template in a separate branch)
  • fix module sorting with TypeScript
  • allow local TSD definitions, better online TSD management and support offline work
• Improve coding guides
• Add doc on reverse proxy usage
• Improve project template (fix reponsiveness, context...)
• Migrate from LESS to Sass (template + gulp + bootstrap)
• Fix template accessibility (aria attributes)
• Replace CSSO for Clean CSS as it is not maintained anymore

v2

• Add mobile version: Cordova + ngCordova, Ionic, CrossWalk, dedicated tasks...
• Add custom icons management: icon-font compilation ou svg->css (class + data-uri)
• Add gulp task to convert HTML partials to Jade [nice-to-have] https://github.com/donpark/html2jade
• Check and fix npm package install on win/mac/linux, with proxy (gulp-imagemin issue)
• Yeoman generator for web/mobile variants (WIP)
• Separate project seed from tools? (to allow different starting seeds?) [nice-to-have]

vNext

• Use WebPack?
• Add e2e coverage reporting
• Investigate support for TypeScript unit tests
• Add self-documentation to base template (jsdoc or ngdoc, after typescript migration)
• Improve doc generation (JSDoc->https://github.com/angular/dgeni or https://github.com/nikhilmodak/gulp-ngdocs)
• Lint HTML: https://www.npmjs.com/package/html-angular-validate
• Lint Sass
• Separate tooling for better update management (-> make our own CLI?)
• Documentation on accessibility?
• Clean bower packages (https://github.com/braddenver/preen)?
• Add simple local wiki system (https://www.npmjs.com/package/nodewiki)?
• Document tasks with gulp-help? [to be discussed)

Documentation to add

• TypeScript code style
• Micro-trainings?
  • API REST
  • Promises
  • TypeScript basics
  • JS pitfalls: comparaisons, this, prototype...
  • App routing organisation: context, view init...

+ printable cheat sheets? posters?