harbor/src/ui_ng
2017-05-12 15:03:07 +08:00
..
e2e replace header of ts files 2017-04-13 19:06:23 -07:00
lib Update for shareable endpoint. 2017-05-12 15:03:07 +08:00
src Merge changes of rel 1.1.0 back to master 2017-05-04 15:47:02 +08:00
angular-cli.json fix gauge bug 2017-04-06 15:06:04 +08:00
Clarity Seed_LICENSE_MIT.txt Rename directory name. 2017-02-27 11:41:46 +08:00
Clarity Seed_NOTICE.txt Rename directory name. 2017-02-27 11:41:46 +08:00
CODE_OF_CONDUCT.md Rename directory name. 2017-02-27 11:41:46 +08:00
CONTRIBUTING.md Rename directory name. 2017-02-27 11:41:46 +08:00
favicon.ico Merge latest updates. 2017-03-21 11:51:12 +08:00
karma.conf.js merge code for building 2017-02-28 12:46:15 +08:00
logo.png Rename directory name. 2017-02-27 11:41:46 +08:00
package.json Updates per comments. 2017-04-24 16:07:07 +08:00
protractor.config.js Rename directory name. 2017-02-27 11:41:46 +08:00
README.md Rename directory name. 2017-02-27 11:41:46 +08:00
rollup-config.js Updates per comments. 2017-04-24 16:07:07 +08:00
tsconfig-aot.json Fix and update codes for AoT. 2017-04-20 23:47:06 +08:00
tslint.json Rename directory name. 2017-02-27 11:41:46 +08:00
typings.json Rename directory name. 2017-02-27 11:41:46 +08:00
yarn.lock merge code for building 2017-02-28 12:46:15 +08:00

Clarity

Clarity Seed

This is a seed project for Angular 2 applications using Clarity. For more information on the Clarity Design System, visit the Clarity website.

We offer this seed project in three different build systems:

  1. Angular-CLI version (branch: master)

  2. Webpack 2 version (branch: webpack)

  3. SystemJS version (branch: systemjs)

Getting started

Angular-CLI version

This seed version provides the following out of the box:

  • Angular 2 application with clarity-icons, clarity-ui and clarity-angular included
  • Development and production builds
  • Unit test setup with Jasmine and Karma
  • End-to-end test setup with Protractor
  • SASS processor
  • TSLint
  • And other goodies that come with Angular-CLI (v1.0.0-beta.20-4)

Installation

Prerequisite: Please install Angular-CLI by following these instructions. Note: Even though it's optional, we recommend you to use yarn instead of npm install for installing the dependencies.

git clone https://github.com/vmware/clarity-seed.git
cd clarity-seed

# install the project's dependencies
yarn # or run "npm install"

# starts the application in dev mode and watches your files for livereload
ng serve

Using Angular-CLI

# generating a new component
ng g component my-new-component

# generating a new directive
ng g directive my-new-directive

# to learn more about Angular-CLI commands and their usages
ng help

For comprehensive documentation on Angular-CLI, please see their github repository.

Test and build scripts

# running unit tests
ng test

# running e2e tests
ng e2e

# dev build
ng build

# prod build
ng build --prod

Documentation

For documentation on the Clarity Design System, including a list of components and example usage, see our website.

Directory structure

.
├── README.md

├── karma.conf.js              <- configuration of the test runner
├── package.json               <- dependencies of the project
├── protractor.config.js       <- e2e tests configuration
├── src/                       <- source code of the application
│   ├── app/
│   │   └── component/
│   │       └── <component>.component.html
│   │       └── <component>.component.scss
│   │       └── <component>.component.spec.ts
│   │       └── <component>.component.ts
│   │   └── app.component.html
│   │   └── app.component.scss
│   │   └── app.component.ts
│   │   └── app.e2e-spec.js    <- sample e2e spec file
│   │   └── app.module.ts
│   │   └── app.routing.ts
│   │   └── main.ts            <- boostrap file for the angular app
│   └── index.html
├── angular-cli.json           <- configuration of the angular-cli
├── tsconfig.json              <- configuration of the typescript project
├── tslint.json                <- sample configuration file for tslint
└── yarn.lock

Contributing

The Clarity project team welcomes contributions from the community. For more detailed information, see CONTRIBUTING.md.

License

The clarity-seed project is licensed under the MIT license.

Feedback

If you find a bug or want to request a new feature, please open a GitHub issue.