Skip to main content

Documentation — Maquina

Get started with Maquina tools. Installation guides, API references, and examples for Rails UI components, MCP servers, and developer utilities.

Maquina is a growing collection of open-source tools extracted from production Rails applications. No complex build pipelines. No framework fatigue.


Why Maquina?

Rails developers who ship alone need tools that work together without adding complexity. Maquina provides:

  • UI Components — ERB partials styled with Tailwind CSS 4.0. No React, no build step.
  • AI Tools — MCP servers and Claude skills that understand your Rails codebase.
  • Developer Utilities — Menu bar apps and CLI tools for your local environment.

All projects are MIT licensed, extracted from production apps, and built for the Rails way.


Philosophy

NoBuild

No complex JavaScript build pipelines. Ship CSS and JS directly with importmaps and Tailwind CSS. Every Maquina tool follows this principle.

Single Developer

One developer can build and maintain the entire application. Tools should reduce complexity, not add it.

CRUD Excellence

Most applications are CRUD at their core. Maquina tools make common patterns elegant and maintainable.


Projects

UI Components

Production-ready components for Rails applications. ERB partials with strict locals, Tailwind CSS 4.0 styling, and Stimulus controllers only where needed.

bundle add maquina_components
rails generate maquina_components:install

Browse Components

AI Tools

MCP servers that let AI assistants understand your Rails projects. Analyze models, routes, schemas, and coordinate changes across your editor.

Tool Purpose
Rails MCP Server Let LLMs analyze your Rails codebase
Neovim MCP Server Coordinate buffer changes with AI assistants
Rails Upgrade Skill Generate upgrade guides for Rails 7.0 through 8.1

Developer Tools

Menu bar apps and CLI utilities for your local development environment.

Tool Purpose
Redis Menu Manage local Redis instances from your menu bar
Mongo Menu Manage local MongoDB instances from your menu bar
Git Continuity Transfer work-in-progress between machines

Get Started


Community

All projects are on GitHub under the maquina-app organization. Issues, pull requests, and contributions welcome.