Responsive web front-end for accessing certain representative IT services of the City of Helsinki. Implemented using Javascript, Angular 1 and Bootstrap 3.
- Install node.js: https://nodejs.org
- Install bower:
npm i -g bower - Install grunt cli:
npm i -g grunt-cli
- Clone the repository
- Run
npm installfor installing node modules. Calls alsobower install.- (Optional: Run
bower installfor installing bower components)
- (Optional: Run
- Copy your specific environment settings into following directory. Default configurations are read build-time from
conf/app.env.default.json. Specific settings for a target env may be overridden incustom/conf/app.env.dev.jsoncustom/conf/app.env.test1.jsoncustom/conf/app.env.test2.jsoncustom/conf/app.env.test3.jsoncustom/conf/app.env.prod.json
gruntfor building for default targetgrunt build:dev|test1|test2|test3|prodfor building for a specific configurationgrunt preparedeployafter building for preparing build output for deployment, if necessary. Calls a postbuild script incustom/tools
grunt servefor preview of the development contentgrunt serve:distfor preview of the distribution content
grunt testwill run the unit tests using karma.
grunt build_architecture_graphGenerates dependency diagrams using graphviz. For issues on installing the grap generator tool see https://github.com/carlo-colombo/angular-modules-graph
- If a local
gruntis not found in project folder runnpm i gruntthere (npm ishould have done it) - If
compassis not found- Install
rubyhttp://rubyinstaller.org/downloads/, and be sure to check "Add ruby executables to your PATH" ! - install compass:
gem install compass
- Install
- If on
gruntrun an indirect npm dependency is missing install it, e.g. "npm i serve-static --save-dev", and be sure to commit thepackage.jsonupdate - For
grunttoolchain issues: on access rights you may have to use node version < 5.7 - Development on Windows environment
- ruby/compass not installed by default, install separately
- If using a "git command prompt" check where it installs packages. It's better to do all the package and grunt operations in an "Administrator command prompt".
| File or folder | Description |
|---|---|
index.html |
HTML file for this Single Page Application (SPA) |
app.js |
Declaration and initialization of the angular application |
app.constants.js |
Declarations of constants |
app.env.js |
Run-time configuration settings generated during build |
app.env.default.json |
Default values for run-time configuration settings, overwritten by environment-specific configuration files during build |
app.routes.js |
State definitions and routes |
custom/ |
Folder under which grunt is configured to search for environment-specific configuration files |
Gruntfile.js |
Build rules and tasks |
package.json |
Npm module dependencies. See also npm-shrinkwrap.json and bower.json. Defines also a version number for this application. |
npm-shrinkwrap.json |
Locks npm dependencies instead of using latest available for package.json. Created using $npm shrinkwrap --dev. Notice that updating app version number requires also updating npm-shrinkwrap.json app version reference! |
bower.json |
Bower module dependencies. See also package.json. Defines also a version number for this application. |
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent