Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/OutpostHQ/numl

Atomic UI Framework based on Web Components and Runtime CSS Generation for rapidly building interfaces that follow your Design System 🌈
https://github.com/OutpostHQ/numl

css-framework css-generator designsystem element-collection framework functional-css markup-language responsive themes ui-components uikit utility-classes web-components

Last synced: about 1 month ago
JSON representation

Atomic UI Framework based on Web Components and Runtime CSS Generation for rapidly building interfaces that follow your Design System 🌈

Awesome Lists containing this project

README 

        


  

    Numl.Design logo

  




[![NPM Version](https://img.shields.io/npm/v/numl.svg?style=flat)](https://www.npmjs.com/package/numl)

[![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/numldesign/numl.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/numldesign/numl/context:javascript)

![npm](https://img.shields.io/npm/dm/numl)

[![Discord](https://img.shields.io/discord/793832892781690891?color=7389D8&label=chat%20on%20Discord&logo=Discord&logoColor=ffffff)](https://discord.gg/sHnHPnAPZj)

[![Rate on Openbase](https://badges.openbase.io/js/rating/numl.svg)](https://openbase.io/js/numl?utm_source=embedded&utm_medium=badge&utm_campaign=rate-badge)



Numl is a UI Design Language, UI Library of Web Components, and Runtime CSS Framework for rapidly building interfaces that follow your Design System 🌈



### [STORYBOOK](https://numl.design/storybook) | [HANDBOOK](https://numl.design/handbook) | [REFERENCE](https://numl.design/reference) | [REPL](https://numl.design/repl)



## Quick Start



Add the following code to your page.



via [JsDelivr](http://www.jsdelivr.com/):



```html



```



That's all! Now you can use all elements and features of Numl 🚀



Try to add a simple element:



```html

My button

```



See our [Handbook](https://numl.design/handbook/getting-started) for more details and other ways to install Numl.



## Intro

* Add a single JS-script to your page, and you are ready to create virtually any interface using only HTML syntax quickly. No bundler, no config, and no frustration.

* Integrate Numl with popular JS-Frameworks. Use it with SSG if you like. 

* Use color generation system and styles-to-state bindings to decrease style declarations up to dozens of times compared to plain CSS.

* Easily create your own Design System and UI Kit based on Numl. [Example](https://cubejs-uikit.vercel.app/)

* Customize your elements at any level: Globally, in context, directly. Use design tokens (Custom Properties) for a more convenient way to customize.

* Remove dozens of UI helper libraries from your project 'cause Numl can do it itself.

* Add your own elements, style attributes, behaviors, design tokens, custom units, and more...

* Use it for free. Contribute if you like it. 



## Who is Numl for?



- **For beginners** Use a well-thought-out Design System with automatic Dark Scheme and High Contrast Mode for rapid development of adaptive and accessible UIs. Create new components by nesting or/and styling foundation elements. 

- **For enthusiastic** Customize the Numl Design System to the smallest detail in runtime using HTML. Use behaviors and control system to add simple interactions. Add your favorite framework (**Vue.js**, **Angular**, **React**, **Svelte**...) for complex logic.

- **For experts** Use JavaScript API to create elements that follow your Design System on top of the **Numl**. Integrate Design Tokens into elements to have more control. Add your own unique elements, styles, behaviors, and tokens.



## Another UI Framework? Why should I care?



- **All-in-one** – Numl is both a markup language for rapidly building responsive interfaces and a set of ready-to-use highly-customizable accessible elements. So you can use a single comprehensive tool to compose and style web applications. It's also possible to create simple interactions without writing JS.

- **Unique** – Numl is based on unique CSS generation technology that allows you to unleash all the power of modern CSS and take all styles under your control.

- **DX Focused** – Numl is focused on providing the best possible Developer Experience. It has lots of built-in helpers and solutions for routine UI development and its atomic approach is convenient for maintaining and refactoring.

- **Universal** – Numl is built on top of Web Components, a modern web API to create reusable UI elements, and it's compatible with most modern JS-frameworks. You can use it as is or create lightweight wrappers for your favorite framework to improve DX, SSR and SEO.



[Learn more at NUML.DESIGN](https://numl.design/)



## Examples



* [Flex playground](https://numl.design/storybook/layouts/flex-playground)

* [Grid playground](https://numl.design/storybook/layouts/grid-playground)

* [Markdown converter](https://numl.design/storybook/converters/markdown)

* [Before/After slider](https://numl.design/storybook/complex/before-after-slider)

* [Login form validation](https://numl.design/storybook/complex/login-form)



## Built with Numl



* [Cube.js UI Kit](https://github.com/cube-js/cubejs-ui-kit) by **Cube Dev**.

* [Numl Website](https://numl.design) ([Repo Link](https://github.com/numldesign/website)) - built with **Nuxt** and **Vue.js**.

* Old Numl Landing Page ([Repo Link](https://github.com/tenphi/numl.design)) built with **Parcel**.

* Old Numl Storybook ([Repo Link](https://github.com/tenphi/numl-storybook)) built with **Vue.js** and **Webpack**.

* [Sellerscale](https://sellerscale.com) – [Project Screenshot Light](https://github.com/tenphi/nude/blob/master/images/example-app-light.png?raw=true) | [Project Screenshot Dark](https://github.com/tenphi/nude/blob/master/images/example-app-dark.png?raw=true) | [Project Screenshot Light Contrast](https://github.com/tenphi/nude/blob/master/images/example-app-light-contrast.png?raw=true) | [Project Screenshot Dark Contrast](https://github.com/tenphi/nude/blob/master/images/example-app-dark-contrast.png?raw=true)

* [Web Standards Calendar](https://frontend-events-numl.now.sh/) by [@KatrinLuna](https://github.com/katrinLuna) ([Repo Link](https://github.com/katrinLuna/frontend-events-numl)).



### Browser Support



Numl is tested in the latest two versions of the following browsers:



* Microsoft Edge

* Google Chrome

* Mozilla Firefox

* Apple Safari

* Apple iOS Safari

* Google Android



Critical bug fixes in earlier versions will be addressed based on their severity and impact.



If you need to support IE11 or pre-Chromium Edge, this library isn't for you. Although web components can (to some degree) be polyfilled for legacy browsers, supporting them is outside the scope of this project. If you're using Numl in such a browser, you're gonna have a bad time.



## Development



* `npm start` run Numl Playground.

* `npm run build` build the library to `dist`:

    * `dist/index.js` - ES6 tree-shaking friendly module. (Exports global `Nude` object)

* `npm run dev` build the library, then keep rebuilding it whenever the source files change.

* `npm run test` run tests.



## Local playground



Run `npm start` to view test page with few examples.



## Roadmap



* Numl v2: [style2state syntax proposal](https://github.com/numldesign/numl/projects/2)

* [Numl-React v1](https://github.com/numldesign/numl-react): Modular & Accessible React UI Library 🚀

* [Theme-Generator](https://github.com/numldesign/theme-generator) 🌈

* More documentation, examples, and tests

* TRL Support

* Improved Behavior System

* Figma UI Kit 🌟 (Coming Soon) [![Figma](https://img.shields.io/badge/follow%20us-on%20Figma-blue)](https://www.figma.com/@numldesign)



## Contribution



**We are looking for contributors!** 



**Numl** is a big and ambitious project with open source that it has a unique approach in UI development. 



Join us for creating a better Web for everyone!



If you want to join us or leave some feedback write to this email: [[email protected]](mailto:[email protected]?subject=Numl%20Project)



And here is our [Discord](https://discord.gg/sHnHPnAPZj). (Ask your questions here!)



## Contributors ✨



Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):



  

    
Andrey Yamanov
💻 🐛 💼 🎨 📖 🤔 ⚠️

    
Shubham Kaushal
🐛 💼 🎨 📖 🤔 ⚠️

    
Nurbek Akhmedov
⚠️ 🐛 🤔

    
katrinLuna
📖 ⚠️ 🐛 🤔

    
Dmitry Patsura
📖

    
Andrey Skladchikov
🐛 🤔

    
Leonid Yakovlev
🤔 ⚠️

  



This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!



## License



[MIT](LICENSE)