- Built with Tailwind colors and ThemeFramework, providing a consistent look and excellent developer experience.
- 31 components, including buttons, inputs, and modals, suitable for almost every usecase.
- Almost every component can be customized to use any Tailwind color, resulting in a wide range of possible appearances.
- Utilizes Lucide Icon Set via lucide-roblox, offering a wide range of icons.
- Properties are strongly typed, ensuring a great DX and reducing the risk of runtime errors.
- Seamlessly integrates with your existing Fusion project; Fusion Components tie in with existing codebases and most components take properties that are applied to the instance, for maximum customization.
- Infinite customisability through
AppearanceOverrides, allowing you to change any aspect of a component's appearance. - Straightforward theming: Through ThemeFramework, colors, transparencies and shadows for any state can be customized with ease on any component.
- Inspired by Nuxt UI, providing variants that can be used to change the appearance of a component to one of the predefined styles, without having to customize anything else.
Demo of a few components
progressbar_showcase.mp4
slider_showcase.mp4
FusionComponents is available on Wally here.
An extensive guide on how to get started can be found in the documentation.
The documentation for FusionComponents provides info on every component and its properties. It can be found here.
The repository for the documentation can be found here. Because it hosts the documentation for multiple projects, it is a separate repository.
The changelog can be found here.
Contributions are always welcomed. Code should follow Stylua and Selene formatting conventions. To contribute, fork this repository, make your changes, and create a pull request. Please make sure to test your changes before creating a pull request.
Important
This project currently suffers from the thread 'main' has overflowed its stack issue caused by full-moon.
You can fix this by running ulimit -s 16384 before running the build command on Linux, or by increasing the Darklua executable stack size on Windows. You can do this by installing Visual Studio and opening the Developer Command Prompt for VS and running editbin /STACK:16777216 "C:\Users\<your user>\.aftman\tool-storage\seaofvoices\darklua\0.13.1\darklua.exe". While this is by no means a solution, overhauling the project to fix this (hopefully) temporary issue is not a priority at the moment.
If you need help with this, feel free to ping me in the Roblox OSS Discord server.
In order to test your changes, you can run the following commands:
aftman install
lune run devThis will start a Rojo server. You can test your changes through stories which you can run with Flipbook.
This project is licensed under the MIT License - see the LICENSE.md file for details.