em9-Library

A forward-thinking library of web components.

• Works with all frameworks 🧩
• Works with CDNs 🚛
• Fully customizable with CSS 🎨
• Includes an official dark theme 🌛
• Built with accessibility in mind ♿️
• Open source 😸

Designed in New Hampshire by em9 digital Design team

What are you using to build em9-Library?

Components are built with LitElement, a custom elements base class that provides an intuitive API and reactive data binding.

Forking the Repo

Start With Bitbucket, then clone it locally and install dependencies.

git clone https://github.com/numankhan4/em9webcomponents.git
cd em9-Library
npm install

Developing

Once you've cloned the repo, run the following command.

npm start

This will spin up the em9-Library dev server. After the initial build, a browser will open automatically. There is currently no hot module reloading (HMR), as browser's don't provide a way to reregister custom elements, but most changes to the source will reload the browser automatically.

The documentation is powered by Docsify, which uses raw markdown files to generate pages. As such, no static files are built for the docs.

Building

To generate a production build, run the following command.

npm run build

Creating New Components

To scaffold a new component, run the following command, replacing em9-tag-name with the desired tag name.

npm run create em9-tag-name

This will generate a source file, a stylesheet, and a docs page for you. When you start the dev server, you'll find the new component in the "Components" section of the sidebar.