pleroma-fe/README.md

2.4 KiB

Pleroma-FE

A single column frontend designed for Pleroma.

screenshot

Changes in this Fork

  • script tag in index.html for pleroma-mod-loader
  • ability to move notifications to a seperate column
  • insert zero width space when padding of emojis is disabled
  • add custom language "English (Nyan)"
  • pointing version links to my gitlab repos
  • optional compact styles provided by craftplacer
  • tags as buttons bellow a post
  • pinch and pan media
  • swap of react and favorite button in status
  • adding vueComponent to DOM nodes to make new mods work

For Translators

To translate Pleroma-FE, add your language to src/i18n/messages.js. Pleroma-FE will set your language by your browser locale, but you can temporarily force it in the code by changing the locale in main.js.

FOR ADMINS

You don't need to build Pleroma-FE yourself. Those using the Pleroma backend will be able to use it out of the box.

Build Setup

# install dependencies
npm install -g yarn
yarn

# serve with hot reload at localhost:8080
npm run dev

# build for production with minification
npm run build

# run unit tests
npm run unit

For Contributors:

You can create file /config/local.json (see example) to enable some convenience dev options:

  • target: makes local dev server redirect to some existing instance's BE instead of local BE, useful for testing things in near-production environment and searching for real-life use-cases.
  • staticConfigPreference: makes FE's /static/config.json take preference of BE-served /api/statusnet/config.json. Only works in dev mode.

FE Build process also leaves current commit hash in global variable ___pleromafe_commit_hash so that you can easily see which pleroma-fe commit instance is running, also helps pinpointing which commit was used when FE was bundled into BE.

Configuration

Edit config.json for configuration.

Options

Login methods

loginMethod can be set to either password (the default) or token, which will use the full oauth redirection flow, which is useful for SSO situations.