Sunchoke is a set of reusable components built with AngularJS

• angularJS 1.5 min. The widgets are based on the component helper definition introduced with version 1.5.
• angular-animate. Some widgets use angular-animate to perform some animations

bower install sunchoke

Npm and Bower "main files" configuration refers to

• the non minified distribution file
• the main Sass file (not the generated css)

Feel free to override the configuration as you need in your project configuration

"overrides": {
    "sunchoke": {
      "main": [
        "dist/sunchoke.min.js",
        "dist/sunchoke.min.css"
      ]
    },
}

angular.module('my-app', [
    'talend.sunchoke'
    ... your other dependencies
])

To create a new widget, please use the CLI to create the files and follow our naming conventions.

npm run add:widget

This will launch a CLI. You will have to answer 2 questions

• The widget name in camelCase with a capital letter (ex: FancyButton)
• Choose the optional entities (style file, controller file)

You can lint your code with eslint

npm run lint

npm run test

To run the tests in watch mode

npm run test:auto

The tests run generates a code coverage, available in the created coverage/ folder.

To generate distribution files

npm run dist

This will generate in a dist/ folder containing

• a minified Sunchoke lib,
• a non minified one
• a generated minified css file
• a non minified one

You can freely submit a pull request. Github documentation

Before that :

• use ES6
• use Sass
• lint and clean your code
• test your code
• Please squash ! Documentation

Sunchoke user documentation is hosted by Github Pages. It is based on gitbook.

Please refer to gh-pages branch README to add your documentation.

Apache License Version 2.0, January 2004

See LICENCE file