Maquina_components

screenshot of Maquina_components
rails
shadcn-ui

Modern UI components for Ruby on Rails, powered by TailwindCSS and Stimulus

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.

rails
Ruby on Rails

Ruby on Rails, often referred to as Rails, is an open-source web application framework written in Ruby. Known for its convention over configuration and don't repeat yourself (DRY) principles, Rails simplifies and accelerates the development of database-backed web applications.

shadcn-ui
Shadcn UI

Beautifully designed components that you can copy and paste into your apps. Accessible. Customizable. Open Source.

ui-kit
UI Kits & Components

A UI kit provides developers with a set of reusable components that can be easily integrated into a website or application. These components are pre-designed with consistent styling and functionality, allowing developers to save time and effort in the design and development process. UI kits can be either custom-built or third-party, and often include components for buttons, forms, typography, icons, and more.