Mata

Hot module reloading for Rack applications using Server-Sent Events and DOM morphing.

Sponsored By Rails Designer

Installation

gem "mata"

Usage

Rails

# config/environments/development.rb
Rails.application.configure do
  config.middleware.insert_before(
    ActionDispatch::Static,
    Mata,
    watch: %w[app/views app/assets],
    skip: %w[tmp log node_modules]
  )
end

Other rack-based apps

# config.ru
require "mata"

use Mata, watch: %w[views assets], skip: %w[tmp log]

run YourApp

Note

Do share your snippets on how to add Mata into your Rack-based apps 💙

Options

• watch; array of paths to monitor (default: %w[app views assets])
• skip; array of paths to ignore (default: %w[tmp log])

Used in

This gem powers hot reloading in Perron, a Rails-based static site generator. It can be enabled with config.hrm = true in your Perron initializer.

Why this gem?

I needed hot module reloading for Perron-powered Rails applications. These are minimal Rails apps typically without Hotwire or ActionCable dependencies. Existing solutions either required ActionCable (adding unnecessary complexity) or provided only basic full-page reloads without state preservation.

Who is Mata?

In the smoky cabarets of Belle Époque Paris, a dancer captivated audiences with her exotic performances and mysterious allure. Born Margaretha Geertruida Zelle in the Netherlands, she had reinvented herself as an Indonesian princess, weaving tales of sacred temple dances and Eastern mystique.

She moved through the salons of Europe's elite with remarkable ease, speaking multiple languages and charming diplomats, military officers and aristocrats alike. Her lovers included high-ranking officials from opposing sides of the Great War, giving her access to secrets that others could only dream of obtaining.

Whether she was truly the master spy of legend or simply a woman caught in the wrong place at the wrong time remains a mystery. What's certain is her ability to observe, adapt and operate seamlessly across boundaries that others found impermeable.

History remembers Mata Hari as the ultimate double agent. She was someone who could watch, listen and report back with precision, all while maintaining perfect cover.

Contributing

This project uses Standard for formatting Ruby code. Please make sure to run be standardrb before submitting pull requests. Run tests via rails test.

License

Mata is released under the MIT License.