generator-ask-web v0.4.0
generator-ask-web
A Yeoman generator to scaffold web projects for Ask-CS.
Mostly based on generator-gulp-angular.
The project will be updated periodically and will include applicable generator-gulp-angular updates.
Installation
You need Node.js and npm installed on your system (the Node.js installation should include npm by default)
If you don't already have gulp, bower and Yeoman installed globally, you can do so by executing:
npm install -g gulp bower yo
To install this generator, do:
npm install -g generator-ask-web
You're ready to scaffold a project!
Usage
First make a directory for your project and navigate into it:
mkdir my-project && cd my-project
Then start the generator, by doing:
yo ask-web
The generator will then ask for the project's name (default is the current directory name in kebab-case/spinal-case). The project's main module will have that same name in camelCase (myProject
in this example).
Next, you'll need to choose between making a 'Promo website' and an 'Ask-CS application'. A 'Promo website' will have Bootstrap by default.
Remaining options:
Promo website:
- CSS or Sass (*.scss)
- HTML or Jade (*.jade)
Ask-CS application includes above and the following:
- UI framework
- Bootstrap
- Angular Material
- None
- (if Bootstrap) Bootstrap implementation
- Angular UI Bootstrap
- AngularStrap
- Official jQuery implementation
- None, just CSS
- JavaScript preprocessor
- None
- ES6 (ES2015), using Babel
- TypeScript
Once done, the generator will scaffold the project and install dependencies, and you're ready to go! (installing dependencies can take some time)
Workflow
gulp
orgulp build
to build an optimized version of your application in/dist
gulp serve
to launch a browser sync server on your source filesgulp serve:dist
to launch a server on your optimized applicationgulp test
to launch your unit tests with Karmagulp test:auto
to launch your unit tests with Karma in watch modegulp protractor
to launch your e2e tests with Protractorgulp protractor:dist
to launch your e2e tests with Protractor on the dist files
TODO
Things that will be worked on in the near future:
- A subgenerator to help create components (reusable angular services and directives with html/jade templates)
- A subgenerator to replace gulpfile.js with an updated version
- A subgenerator to update package.json with the gulpfile? Not sure on this
- Include useful Ask-CS components depending on project type
License
MIT