Welcome

Matestack Ui Core - Boost your productivity & easily create component based web UIs in pure Ruby. Reactivity based on Vue.js included if desired. No Opal involved.

What is Matestack?

Matestack enables Rails developers to craft maintainable web UIs in pure Ruby, skipping ERB and HTML. UI code becomes a native and fun part of your Rails app. Thanks to reactive core components built on top of Vue.js, reactivity can be optionally added without writing JavaScript, just using a simple Ruby DSL.

If necessary, extend with pure JavaScript. No Opal involved.

Share feedback, get support and get involved! Join our growing community, get to know the core team and learn how to contribute in order to make Matestack better every day!

Why Matestack?

Matestack was created because modern web app development became more and more complex due to the rise of JavaScript frontend frameworks and the SPA frontend/REST API/JSON backend architecture. This sophisticated approach might be suitable for big teams and applications but is way to complex for most of small to medium sized teams and application scopes.

In contrast, Matestack helps Rails developers creating modern, reactive web apps while focusing on simplicity, developer happiness and productivity:

What makes Matestack different?

Hotwire and Stimulus Reflex are awesome gems. They reduce the amount of required JavaScript when implementing reactive web UIs. They allow us to use more Rails and less JavaScript. Great!

Matestack, developed since 2018, goes even one step further: Use more Ruby and less of everything else (JavaScript, ERB/HAML/SLIM, CSS).

Why? Because Ruby is just beautiful! More Ruby = More developer happiness = Higher productivity

Additionally, most of Matestack does not require Action Cable or Redis, but can optionally use the power of these tools.

Ecosystem

Matestack currently offers two open source Ruby gems**:**

  • matestack-ui-core ships all you need to build reactive UIs in pure Ruby. You have to take care of styling and additional UI components yourself.

  • matestack-ui-bootstrapships all you need to build beautiful, reactive UIs in pure Ruby and smart CRUD components based on Bootstrap v5. Don't think about styling anymore and just create admin or application UIs faster than ever before! (specs and docs in progress currently) --> https://matestack.gitbook.io/matestack-ui-bootstrap/****

Live Demo

Based on matestack-ui-core and matestack-ui-bootstrap this reactive dummy app was created in pure Ruby without writing any JavaScript, ERB/HAML/SLIM and CSS: (check it out | source code)

Compatibility

Ruby/Rails

matestack-ui-core and matestack-ui-bootstrap are automatically tested against:

  • Rails 6.1.1 + Ruby 3.0.0

  • Rails 6.1.1 + Ruby 2.7.2

  • Rails 6.0.3.4 + Ruby 2.6.6

  • Rails 5.2.4.4 + Ruby 2.6.6

Rails versions below 5.2 are not supported.

Vue.js

matestack-ui-core currently uses Vue.js 2.6.12 and Vuex 3.6.2 for its reactivity features. Custom reactive components are currently bound to these versions as well.

Vue 3 / Vuex 4 update is planned for Q2 2021.

Getting Started

Before you dive into some code, you should read about the basic architecture concepts and different ways to build with Matestack:

Concepts & Rails Integration

After that, it might be a good idea to boost your knowledge with our quick start guide:

Quick Start

Deep Dive

Craft your UI based on your components written in pure Ruby. Utilizing Ruby's amazing language features, you're able to create a cleaner and more maintainable UI implementation:

Learn more about UI components implemented in pure Ruby:

Component Overview

What about going even one step further and implement reactive UIs in pure Ruby? Matestack's reactive core components can be used with a simple Ruby DSL enabling you to create reactive UIs without touching JavaScript!

Learn more about the optional reactivity system built on top of Vue.js and how you can use reactive core components in pure Ruby:

Reactivity Overview

The last step in order to leverage the full Matestack power: Create app (~Rails layout) and page (Rails ~view) classes and implement dynamic page transitions without any JavaScript implementation required optionally enriched with some CSS animations.

Learn more about SPA-like Apps implemented in pure Ruby:

SPA Overview

Last updated