# lookbook-hq/lookbook

A UI development environment for Ruby on Rails apps

Repository: https://github.com/lookbook-hq/lookbook
Canonical: https://ross.abutalabs.com/products/lookbook
Homepage: https://lookbook.build
Language: JavaScript
License: MIT
License Family: permissive
Topics: viewcomponent, rails, ruby, development, components, lookbook, ruby-on-rails, partials, phlex, styleguide
Last push: 2026-08-31T11:53:28+00:00

## Health v2 (maintenance only)
Score: 100/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 100, release rhythm 100, longevity 100
- inputs: {"age_days": 1895, "days_push": 2, "days_rel": 2, "gap_med": 28.5, "n_releases_24m": 13}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1092, forks 121 (observed 2026-09-01T02:14:03.832725+00:00)

## What it is
Lookbook is a UI development environment for Ruby on Rails applications, implemented as a Rails Engine gem. It combines a component browser and preview system with an integrated Markdown documentation engine for building modular UIs with ViewComponent, Phlex, and ActionView partials.

## Use cases
- browse and preview Rails UI components in isolation
- build a living styleguide for a Rails app
- document ViewComponent components with live preview embeds
- test responsive component behavior in a resizable preview window
- preview Phlex components and ActionView partials
- add editable parameters to component previews

## When to choose
- you develop Rails UIs with ViewComponent, Phlex, or partials and want isolated component previews
- your team needs a browsable component styleguide with integrated docs
- you want a drop-in replacement for ViewComponent preview classes with no changes to existing previews

## When to avoid
- your project is not a Ruby on Rails application
- you need a general-purpose design tool or static site styleguide outside Rails
- you only need simple CSS styling without component previewing

## Facets
- artifact type: library
- maturity: active
- function: ui-components, documentation, developer-tools, templating
- domain: web-development, frontend, developer-tools, documentation
- platform: ruby, self-hosted
- tags: rails-engine, viewcomponent, phlex, component-browser, styleguide, component-previews, design-system, web-server

## Member repositories
- lookbook-hq/lookbook (main) score 100

## Provenance
- Observed fields: from GitHub, fetched 2026-09-01T02:14:03.832725+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:49:02.972730+00:00, confidence not recorded.
  - readme: https://github.com/lookbook-hq/lookbook (fetched 2026-09-01T02:14:03.832725+00:00, sha 6d4cc050d431)
  - homepage: https://lookbook.build (fetched 2026-08-29T12:51:06.529454+00:00, sha cf68e0ace211)
  - site_page: https://lookbook.build/guide/installation (fetched 2026-08-29T12:51:06.538651+00:00, sha e47b3f700575)
- Data as of 2026-08-30T08:39:29.467469+00:00.