UI components for Bonfire:Me and Bonfire:Social extensions


Bonfire.UI.Social #

Bonfire.UI.Social is an extension that includes the main User Interfaces (routes, pages and components) required to have a fully working federated social network app.

This extension is meant to be used by other extensions like Bonfire.Social, which provides logic for the UI to work with/

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.Social.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:

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 #

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
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

Updated 07 Jan 2024
License agpl-3.0

Bonfire Networks

Open Collective account Open Source