Overview

Maquina Components is a collection of UI components designed specifically for Ruby on Rails applications. Built using ERB, TailwindCSS 4.0, and Stimulus, these components aim to streamline the development of dashboards and admin interfaces. The project emerged from the need for consistency and cohesion in UI components, ensuring that developers can utilize a unified API with a consistent styling approach. As many Rails developers know, finding a balance between flexibility and simplicity can be challenging, but these components serve as an effective solution.

The primary goal behind Maquina Components is to enhance composability within applications, allowing developers to create complex interfaces using small, reusable ERB partials. By focusing on real-world applications, these components emphasize practical utility over exhaustive completeness. This toolkit is not a one-size-fits-all approach but is crafted for developers who appreciate a straightforward, cohesive solution without straying from "the Rails way."

Features

ERB Partials with Strict Locals: Uses magic comments for locals, ensuring clear and manageable code for each component.
TailwindCSS 4.0 Integration: Leverages CSS custom properties for easy theming, allowing for consistent styling throughout your application.
Data Attributes for Styling: Utilizes data-component and data-* attributes to apply CSS styling seamlessly, enhancing maintainability.
Selective Use of Stimulus Controllers: Only applies Stimulus controllers for interactive components, keeping the library lightweight and efficient.
Dark Mode Support: Incorporates CSS variables to support dark mode, providing flexibility for user preferences and aesthetics.
Adoption of Theming Conventions: Follows the shadcn/ui theming convention, ensuring compatibility with existing color systems and frameworks.
Composable Design: Components consist of small partials that can be freely combined, promoting a modular architecture for customized components.
Test Dummy Applications: Comes with light and dark mode test dummy apps to facilitate quick demonstrations of component functionality.

Maquina App

Maquina_components