Bonfire.UI.Messages #

Bonfire.UI.Messages is an extension that includes some User Interfaces (routes, pages and components) for messaging in Bonfire.

You can customise it by forking, but we recommend creating an extension which uses this one as a dependency, and defines your custom components, views, and/or routes (you can then comment Bonfire.UI.Messages.Routes from your top-level Router to use your custom routes and views instead).

Stack #

So far, Bonfire UI extensions are built with the PETALS stack (note that is not a requirement), which means:

• Phoenix
• Elixir
• TailwindCSS
• Alpine.js
• LiveView
• Surface

Surface is a server-side rendering component library (built on top of Phoenix and LiveView) that inherits a lot of design patterns from popular JS framework like Vue.js and React, while being almost JavaScript-free compared to common SPAs.

Scaffolding #

The relevant folders are:

• Components: Surface stateless and stateful components.
• Views: The main pages that are rendered when navigating to a specific route
• Test: All the unit tests for the specific module.

Other resources #

• A blog post that introduces the concept of themeable bonfire apps

Copyright and License #

Copyright (c) 2020 Bonfire, and CommonsPub Contributors

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public
License along with this program. If not, see https://www.gnu.org/licenses/.