README.md 1.79 KB
Newer Older
1
# Pleroma-FE 
lain's avatar
lain committed
2

normandy's avatar
normandy committed
3
> A single column frontend designed for Pleroma.
lain's avatar
lain committed
4

5
![screenshot](/uploads/796c5ecf985ed1e2b0943ee0df131ed0/DJVqSJ0.png)
lambadalambda's avatar
lambadalambda committed
6

Roger Braun's avatar
Roger Braun committed
7 8
# For Translators

normandy's avatar
normandy committed
9
To translate Pleroma-FE, add your language to [src/i18n/messages.js](https://git.pleroma.social/pleroma/pleroma-fe/blob/develop/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.
Roger Braun's avatar
Roger Braun committed
10

lambadalambda's avatar
lambadalambda committed
11 12
# FOR ADMINS

normandy's avatar
normandy committed
13
You don't need to build Pleroma-FE yourself. Those using the Pleroma backend will be able to use it out of the box.
lambadalambda's avatar
lambadalambda committed
14

lain's avatar
lain committed
15 16 17 18
## Build Setup

``` bash
# install dependencies
lambadalambda's avatar
lambadalambda committed
19 20
npm install -g yarn
yarn
lain's avatar
lain committed
21 22 23 24 25 26 27 28 29 30 31

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

# build for production with minification
npm run build

# run unit tests
npm run unit
```

32 33 34 35 36 37 38 39 40
# For Contributors:

You can create file `/config/local.json` (see [example](https://git.pleroma.social/pleroma/pleroma-fe/blob/develop/config/local.example.json)) 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.

41 42
# Configuration

HJ's avatar
HJ committed
43
Edit config.json for configuration.
lain's avatar
lain committed
44 45 46 47 48 49

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