yuzu-application

components management for yuzu

Yuzu Application exposes a set of modules aimed to simplify the management of Yuzu components in the context of a page.

• Installation
  • As NPM Package
  • CDN Delivered <script>
  • ES2017 Syntax
• Browser Support
• Documentation
• Contributing

Installation

As NPM Package

npm install yuzu yuzu-application --save

# or

yarn add yuzu yuzu-application

CDN Delivered <script>

Add the following script tags before your code

<script src="https://unpkg.com/yuzu"></script>
<script src="https://unpkg.com/yuzu-application"></script>

Yuzu Application will be available in the global scope under YZ.Application.

ES2017 Syntax

To provide maximum compatibility with every development environment, packages are transpiled to ES5. When used with a bundler like Webpack or rollup the module resolution system will automatically pick either the Commonjs or ESM version based on your configuration.

If you want to import the ES2017 version of a package you can do so by setting an alias on the bundler's configuration file:

Webpack

// webpack.config.js
 
module.exports = {
  // ...
+  resolve: {
+    alias: {
+      'yuzu-application': 'yuzu-application/dist/index.next.js'
+    }
+  }
}

Rollup

Use rollup-plugin-alias

// rollup.config.js
+ import path from 'path';
+ import alias from 'rollup-plugin-alias';
 
export default {
  input: './src/index.js',
  plugins: [
    // ...
+    alias({
+      'yuzu-application': path.resolve(__dirname, 'node_modules/yuzu-application/dist/index.next.js')
+    })
  ],
};

Browser Support

Yuzu works in all modern browsers. In order to make it work in browsers that don't support ES2015+ features (like IE11) you need to include the yuzu-polyfills package before any other yuzu* package.

If you're using a package bundler add this line at the very top of your entry point:

import 'yuzu-polyfills';

Documentation

Learn more about Yuzu Application! Read the full documentation or browse the API.

Contributing

1. Fork it or clone the repo
2. Install dependencies yarn install
3. Code your changes and write new tests in the test folder.
4. Ensure everything is fine by running yarn build
5. Push it or submit a pull request :D