Lightning UI
This library contains shared Lightning components, you can view our live Storybook documentation to learn more about each component and how to leverage them in your application.
In order to facilitate the development process for our theming architecture we have converted this project into a monorepo using Yarn workspaces. This allows engineers to work across multiple packages without the need for npm link
or yarn link
. This also has some other benefits including easy visibility across different @lightningjs/ui packages, standardization, and better release management.
Three packages are currently maintained and released from this project.
- @lightningjs/ui-components
- @lightningjs/ui-components-test-utils
- @lightningjs/ui-components-theme-base
Local Development
To run the repository locally, run:
yarn install
yarn start
This will launch Storybook at http://localhost:8000/.
Peer Dependencies
@lightningjs/ui-components
has a peer dependency on @lightningjs/core^2.x
. If you are stuck using the old Lightning, i.e. wpe-lightning^1.x
, you will need to alias @lightningjs/core
in your build process. If you are bundling your app using Webpack, you should add this to your config:
module.exports = {
resolve: {
alias: {
'@lightningjs/core': path.resolve(__dirname, 'node_modules/wpe-lightning')
}
}
};
NOTE: aliasing @lightningjs/core
to point to wpe-lightning
is not guaranteed to work with everything! Consider updating your Lightning library as soon as possible.
Installation
Install from NPM:
npm install --save @lightningjs/ui-components
@lightningjs/ui-components
has a peer dependency on the Lightning package
npm install -S @lightningjs/ui @lightningjs/core
Usage
You should import components using ES6 named imports, like so:
import lng from '@lightningjs/core';
import { Button } from '@lightningjs/ui-components';
You should NOT use path imports like this:
import Button from '@lightningjs/ui-components/components/Button';
Since packages are now bundled with rollup this allows proper tree shaking behavior. For more information on tree shaking the @material/ui
documentation has a great guide on development bundle size (note: this is external documentation otherwise unrelated to this project!).
Use components in your application
import { FocusManager } from '@lightningjs/ui-components';
class MyComponent extends lng.Component {
static _template() {
return {
FocusManager: {
type: FocusManager,
direction: 'row',
children: []
}
};
}
_getFocused() {
return this.tag('FocusManager');
}
}
Questions???
Submit a GitHub Issue or Join us on Slack!