# Poetry

The umbrella gem: one gem "poetry" installs the engine, the components and the default icon set together; charts, the agent surfaces, extraction and the Simple Form bridge stay opt-in.

The umbrella gem: `gem "poetry"` installs the library proper - poetry-core (the Rails engine, the component DSL, the Stimulus integration and the design-token foundation), poetry-ui (88 accessible, themeable components as `poetry_*` helpers, nine themes, the form builder, the blocks and the agent surface) and poetry-lucide (the default icon set, vendored and sanitized at a pinned commit). `bin/rails generate poetry:install` wires the engine, the Tailwind entry point, the importmap pins and the agent skills. The ecosystem gems stay opt-in and resolve to the umbrella's release without version constraints: [poetry-charts](/libraries/charts), [poetry-agent](/libraries/agent), [poetry-extract](/libraries/extract) and [poetry-simple_form](/libraries/simple-form). Code: https://github.com/roboruby/poetry - gems: https://rubygems.org/gems/poetry.