Getting the code
The preferred way to install Bosonic is through NPM, but you can download the Bosonic platform as a ZIP file. It contains two files:
webcomponents.js, which is the file that contains the community polyfills and
bosonic-runtime.js, which is the Bosonic library (not the elements!).
We'll assume you've already installed Node.js and NPM (platform specific installation instructions).
If you've just setup your project and haven't created a
package.json file, it's now time to generate one:
You can now install the Bosonic package:
npm install --save bosonic
Don't forget to install the
webcomponents.js polyfills ; they're bundled with the Bosonic package as a dependency, but as you may know, npm installs dependencies in a nested hierarchy, which is not always practical.
npm install --save webcomponents.js
Bosonic's elements are grouped in several NPM packages, but as dnd-elements and data-elements are still a Work-In-Progress, they aren't published yet.
npm install --save bosonic-core-elements
Bosonic Core Elements are available as a ZIP file too.
Some elements depends on other elements ; all elements should therefore reside in the same folder when developing. If you downloaded ZIP files, extract all the files into the same folder. If you used NPM, you'll need to copy files from the installed packages into a "developement" folder. Depending on your task runner of choice, you can use grunt-contrib-copy or gulp-copy to do this.
Use a web server
Because of the way HTML imports work, you'll need a local web server to use Bosonic elements (usage of the
file: protocol is blocked by Cross-Origin Resource Sharing policy).