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:

- **Generators** — Production-ready app scaffolding. Authentication, job queues, error tracking, and security in one command.
- **UI Components** — ERB partials styled with Tailwind CSS 4.0. No React, no build step.
- **Engines** — Mountable Rails engines that drop complete features into your app.
- **AI Tools** — MCP servers and Claude Code plugins 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

### Generators

Rails generators that produce standalone application code with no runtime dependency. Authentication (passwordless or password-based), multi-tenancy, Rack Attack, Solid Queue, error tracking, and job dashboards — all configured in a single command.

```bash
bundle add maquina_generators --group development
rails generate maquina:app --auth clave
```

[View Generators Documentation](/documentation/generators/)

### UI Components

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

```bash
bundle add maquina_components
rails generate maquina_components:install
```

[Browse Components](/documentation/components/)

### Engines

Mountable Rails engines that add complete features to your app. Mount under a backstage path, run the installer, and get production-ready functionality themed with maquina_components.

```ruby
# config/routes.rb
mount MaquinaNewsletters::Engine => "/backstage/newsletters"
```

[View Engines](/documentation/engines/)

### AI Tools

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

| Tool | Type | Purpose |
|------|------|---------|
| [Rails MCP Server](/documentation/ai-tools/rails-mcp-server/) | MCP Server | Let LLMs analyze your Rails codebase |
| [Neovim MCP Server](/documentation/ai-tools/nvim-mcp-server/) | MCP Server | Coordinate buffer changes with AI assistants |
| [Rails Simplifier](/documentation/ai-tools/rails-simplifier/) | Plugin | Code simplification with 37signals patterns |
| [Rails Upgrade Assistant](/documentation/ai-tools/rails-upgrade-skill/) | Plugin | Generate upgrade guides for Rails 7.0 through 8.1 |
| [Maquina UI Standards](/documentation/ai-tools/maquina-ui-standards/) | Plugin | Build consistent UIs with maquina_components |

[Browse all AI Tools →](/documentation/ai-tools/)

### Developer Tools

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

| Tool | Purpose |
|------|---------|
| [Redis Menu](/documentation/tools/redis-menu/) | Manage local Redis instances from your menu bar |
| [Mongo Menu](/documentation/tools/mongo-menu/) | Manage local MongoDB instances from your menu bar |
| Git Continuity | Transfer work-in-progress between machines |

[Browse all Developer Tools →](/documentation/tools/)

---

## Community

All projects are on GitHub under the [maquina-app](https://github.com/maquina-app) organization. Issues, pull requests, and contributions welcome.