[![Built With Stencil](https://img.shields.io/badge/-Built%20With%20Stencil-16161d.svg?logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPCEtLSBHZW5lcmF0b3I6IEFkb2JlIElsbHVzdHJhdG9yIDE5LjIuMSwgU1ZHIEV4cG9ydCBQbHVnLUluIC4gU1ZHIFZlcnNpb246IDYuMDAgQnVpbGQgMCkgIC0tPgo8c3ZnIHZlcnNpb249IjEuMSIgaWQ9IkxheWVyXzEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIHg9IjBweCIgeT0iMHB4IgoJIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiBzdHlsZT0iZW5hYmxlLWJhY2tncm91bmQ6bmV3IDAgMCA1MTIgNTEyOyIgeG1sOnNwYWNlPSJwcmVzZXJ2ZSI%2BCjxzdHlsZSB0eXBlPSJ0ZXh0L2NzcyI%2BCgkuc3Qwe2ZpbGw6I0ZGRkZGRjt9Cjwvc3R5bGU%2BCjxwYXRoIGNsYXNzPSJzdDAiIGQ9Ik00MjQuNywzNzMuOWMwLDM3LjYtNTUuMSw2OC42LTkyLjcsNjguNkgxODAuNGMtMzcuOSwwLTkyLjctMzAuNy05Mi43LTY4LjZ2LTMuNmgzMzYuOVYzNzMuOXoiLz4KPHBhdGggY2xhc3M9InN0MCIgZD0iTTQyNC43LDI5Mi4xSDE4MC40Yy0zNy42LDAtOTIuNy0zMS05Mi43LTY4LjZ2LTMuNkgzMzJjMzcuNiwwLDkyLjcsMzEsOTIuNyw2OC42VjI5Mi4xeiIvPgo8cGF0aCBjbGFzcz0ic3QwIiBkPSJNNDI0LjcsMTQxLjdIODcuN3YtMy42YzAtMzcuNiw1NC44LTY4LjYsOTIuNy02OC42SDMzMmMzNy45LDAsOTIuNywzMC43LDkyLjcsNjguNlYxNDEuN3oiLz4KPC9zdmc%2BCg%3D%3D&colorA=16161d&style=flat-square)](https://stenciljs.com)

# @fx-ui/core

[Fx Framework](https://github.com/Nuinalp/fx-ui) is an open source Cross Platform App Development framework built on top of Stencil, focused on providing a collection of reusable UI components and utilities for building modern cross platform web applications with enterprise quality.

The Fx Core package contains a large number of Web Components that can be used to build modern cross platform web applications, websites and other different types of web projects. These components are designed to be used in traditional frontend view libraries/frameworks (such as Stencil, React, Angular, Vue or Svelte), or on their own through traditional JavaScript in the browser.

All components present in this library, are just Web Components, so they work in any major framework or with no framework at all.


## Features
- Headless components without styles
- Ultra customized by CSS rules
- Asyncronous rendering
- No build or compiling required
- Simply add the static files to any project
- Lazy-loaded components without configuration
- Tiny, highly optimized components built with Stencil
- Consistent 60 FPS performance

## Getting Started

#### Vanilla HTML

```html
<script type="module" src="https://cdn.jsdelivr.net/npm/@fx-ui/core/dist/fx-ui/fx-ui.esm.js"></script>
<script nomodule src="https://cdn.jsdelivr.net/npm/@fx-ui/core/dist/fx-ui/fx-ui.js"></script>
<link href="https://cdn.jsdelivr.net/npm/@fx-ui/core/css/fx-ui.bundle.css" rel="stylesheet">
```

### Framework Bindings

Fx UI is built on Web Components, making it compatible with any JavaScript environment—from simple HTML to complex framework applications. We provide official bindings for Vue, React, Svelte, and Angular that offer framework-specific APIs while maintaining the same core component logic and behavior.

### Contributing

Thanks for your interest in contributing! Read up on our guidelines for [contributing](https://gitlab.com/nuinalp/open-source/fx/fx-framework/blob/main/CONTRIBUTING.md) and then look through our issues with a [help wanted](https://gitlab.com/nuinalp/open-source/fx/fx-framework/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) label.

Please note that this project is released with a [Contributor Code of Conduct](https://gitlab.com/nuinalp/open-source/fx/fx-framework/blob/main/CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.

### ♿ Accessibility  

Fx UI includes enterprise-grade accessibility built into its components, helping teams create more inclusive interfaces with accessible headless components, keyboard-friendly interactions, proper focus management, and stronger support for assistive technologies. Learn more in the dedicated Accessibility documentation.


## Support

Do you have a question? Please open an issue on our [main repo](https://gitlab.com/nuinalp/open-source/fx/fx-framework/issues).

## License

[MIT License](https://opensource.org/licenses/MIT)

Copyright (c) 2026 The Nuinalp Authors. All rights reserved.  
Use of this source code is governed by an MIT-style license that can be found in the LICENSE file.

<p>
  Built with ❤️ by <a href="https://nuinalp.com">Nuinalp LTDA</a>
</p>