Skip to content
/ oma Public

a framework independent web components library

License

Notifications You must be signed in to change notification settings

oma-wc/oma

Repository files navigation

oma

Qenya
oma
noun. everywhere

oma is a framework independent web components library.

lerna

Install and use

See components/ for available components.

See each components documentation for details on properties and styling.

asdf is used as runtime dependency manager.

Using a javascript build tool

Install: yarn add @oma-wc/button

Add to main javascript file: import '@oma-wc/button'

Use in HTML or JSX: <oma-button>A simple button</oma-button>

Using a <script> tag

Add to main HTML file: <script src="https://unpkg.com/@oma-wc/button" type="text/javascript"></script>

And then use it in HTML: <oma-button>A simple button</oma-button>

Layout components

Requires due to style dependancies.

Content components

Doesn't require , self contained style.

Development

This is a multi package repo managed with Lerna.

Adding new components

Run yarn bootstrap to setup internal dependencies.

Testing components

There's a very simple test page located in components/index.html which you can run with yarn dev:server.

Build components automatically with yarn watch, for instance yarn watch @oma-wc/menu. The watcher just forwards arguments to the build script.

Publishing

  • yarn build
  • Commit
  • Run yarn lerna:publish (you need authentication to NPM (npm adduser))