pl-fe

pl-fe is a social networking client app. It works with any Mastodon API-compatible software, but it's focused on supporting alternative backends, like Pleroma or GoToSocial.

Goals

• Feature-rich: pl-fe includes a wide range of features, such as a WYSIWYG text editor, draft posts, and more.
• Compatibility: pl-fe is compatible with any Mastodon API-compatible software, treating alternative backends as first-class citizens. Chats, emoji reactions, groups, interaction policies? We support them all. Thanks to pl-api, which provides a unified interface for interacting with Mastodon API-compatible servers, implementation differences do not affect the user experience.
• Unopinionated: pl-fe doesn't impose any arbitrary limitations on the user. We do not specify a limit of reactions you can use on a single post and try to implement every feature available in the API.
• Stay private: pl-fe includes features which help you maintain online privacy. This includes URL cleaning, which helps you remove unwanted parts of URLs used to mark your online activity.

Try it out

Want to test pl-fe with any existing MastoAPI-compatible server? Try pl.mkljczk.pl — enter your server's domain name to use pl-fe on any server!

If you want to use pl-fe as the default frontend on your server, download the latest build from pl.mkljczk.pl/pl-fe.zip and install it following the instructions for your backend. For example, on a standard Pleroma installation you can use:

curl -O https://pl.mkljczk.pl/pl-fe.zip
unzip pl-fe.zip -d /opt/pleroma/instance/static/
rm pl-fe.zip

Note: Some Fediverse software (Akkoma, Mitra) use Content Security Policy configuration which disallows the usage of inline styles, which are used by pl-fe for color schemes. Mangane README suggests using server configuration to override the default CSP header:

Here is an example configuration for nginx:

# add style-src for mangane
proxy_hide_header Content-Security-Policy;
add_header Content-Security-Policy "upgrade-insecure-requests;script-src 'self';connect-src 'self' blob: https://example.com wss://example.com;media-src 'self' https:;img-src 'self' data: blob: https:;default-src 'none';base-uri 'self';frame-ancestors 'none';style-src 'self' 'unsafe-inline';font-src 'self';manifest-src 'self';" always;

Please replace https://example.com with your own domain

Repository

The repository hosts pl-fe, but also libraries related to the project. This includes:

• pl-fe itself — a social networking client app
• pl-api — a library for interacting with Mastodon API-compatible servers, focused on support for projects extending the official Mastodon API. It is used by pl-fe.
• pl-hooks — a library including hooks for integrating with Mastodon API, based on pl-api and TanStack Query. It is intended to be used within pl-fe. Work in progress.

More projects to be announced.

Contributing

This project is hosted on Codeberg and GitHub. Most development currently happens on GitHub, but you can contribute on both platforms.

Code contributions are welcome. I will provide contributing guidelines after I decide whether the current monorepo model is the correct approach.

Weblate is used for project translation.

License

pl-fe is a fork of Soapbox and inherits a lot of code from Mastodon.

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

---

Follow my Pleroma account to stay up to date on pl-fe development.

This project is tested with BrowserStack.