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, public/llms.txt, and public/llms-full.txt.
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, llms.txt, and per-component agent rules.

Components

Browse all 62 entries by category.