View Source About

Pyro is a suite of libraries for building UI in Phoenix.

  • Pyro

    Component tooling for Phoenix.

    • Customizable "overrides" system for granularly customizable themes
    • Extended component attributes, e.g. CSS merging
  • PyroComponents

    Ready-made Phoenix components, built with pyro.

    • Heex component library
    • Overrides presets to get started quickly while allowing deep customization
  • AshPyro

    Declarative UI for Ash Framework.

    • Ash extensions providing a declarative UI DSL
  • AshPyroComponents

    Components that automatically render PyroComponents declaratively via AshPyro.

To install Pyro and write your own components, follow the Get Started guide. For the other features, please see the "Get Started" guide for the appropriate library instead.

What "problem" is it solving?

The default model of Phoenix is to generate, then customize. While this does provide great isolation, I have found it pretty tedious to repeatedly make very similar copy & paste boilerplate changes to the generated code every time I create a new Phoenix app. Additionally, some things (like timezone localization) are quite complicated and it would be nice for them to be handled by a library that is updated with future improvements. Copy & pasting boilerplate will lead to maintenance burdens down the road.

The tricky part is handling all the bespoke features in each app while sharing as much as possible. The goal is to provide a wide array of tooling, helpers and components with sane defaults, while allowing very granular overrides and optional libraries. By separating each level of features, you can choose which parts of Pyro to leverage, and which to implement yourself.