Senren UI

Documentation

Introduction

Senren is a Rails-native UI library for ViewComponent, Hotwire, and AI agents. It is opinionated about what Rails apps need and quiet about everything else.

The library ships 62 components across eight categories — Actions, Forms, Overlays, Navigation, Layout, Data Display, SaaS Blocks, and Rich Content. Every category is installable today, and the original phase language now only refers to the historical build order.

Philosophy #

  • Rails is enough. Server-rendered HTML, ViewComponent, Turbo, and a touch of Stimulus. No SPA, no global state, no React.
  • Source-copy. Components are copied into your app under app/components/senren/. You own them. You can read them. You can edit them.
  • AI-agent native. Every install creates .senren/skill.md, .senren/agent-rules.md, and adapter files for Codex, Claude, Copilot, and Cursor.
  • Semantic tokens. Every component uses CSS variables (--senren-background, --senren-foreground, etc). Re-skin the entire system from one CSS file.

Next steps #

Installation

Add Senren to a Rails app in three commands.

Quickstart

Build a small SaaS page using only Senren primitives.

Theming

Design tokens, dark mode, and brand customization.

Conventions

Slots, custom classes, the rule that bites everyone.

AI agents

Skill files, agent-rules.md, and multi-agent instruction adapters.

Components

Browse all 62 entries by category.