fedilove-ui/README.md

81 lines
2.4 KiB
Markdown
Raw Normal View History

2021-01-09 17:03:25 +00:00
# FediLove
2018-04-14 16:41:56 +00:00
2021-01-09 17:03:25 +00:00
A web client to turn [Mastodon](https://joinmastodon.org) into a **Federated Meeting and Dating** platform.
This client uses **Mastodon API** to implement dating App features such as: **Meeting people, Profile setup, Preferences, Matching, Chating, Sharing**
2018-04-02 06:15:52 +00:00
2021-01-09 17:03:25 +00:00
It is a fork of [Pinafore](https://github.com/nolanlawson/pinafore)
2018-04-02 06:15:52 +00:00
2021-01-09 17:03:25 +00:00
FediLove is available at [love.nogafam.es](https://love.nogafam.es).
2018-04-02 06:15:52 +00:00
2021-01-09 17:03:25 +00:00
See the [user guide](https://git.nogafam.es/nogafam/fedilove-ui/src/branch/master/docs/User-Guide.md) for basic usage. See the [admin guide](https://git.nogafam.es/nogafam/fedilove-ui/src/branch/master/docs/Admin-Guide.md) if FediLove cannot connect to your instance.
For updates and support, follow [@admin@masto.nogafam.es](https://masto.nogafam.es/@admin).
2018-04-02 06:15:52 +00:00
## Browser support
2021-01-09 17:03:25 +00:00
FediLove supports the latest versions of the following browsers:
2018-04-02 06:15:52 +00:00
- Chrome
- Edge
- Firefox
- Safari
Compatible versions of each (Opera, Brave, Samsung, etc.) should be fine.
2018-02-18 22:38:10 +00:00
## Building
2018-02-18 22:38:10 +00:00
2021-01-09 17:03:25 +00:00
FediLove requires [Node.js](https://nodejs.org/en/) v8+ and [Yarn](https://yarnpkg.com).
2018-08-25 20:04:41 +00:00
2021-01-09 17:03:25 +00:00
To build FediLove for production, first install dependencies:
yarn --production --pure-lockfile
Then build:
yarn build
Then run:
PORT=4002 node server.js
### Docker
2018-12-19 04:50:30 +00:00
To build a Docker image for production:
docker build .
docker run -d -p 4002:4002 [your-image]
2021-01-09 17:03:25 +00:00
Now FediLove is running at `localhost:4002`.
### docker-compose
Alternatively, use docker-compose to build and serve the image for production:
docker-compose up --build -d
The image will build and start, then detach from the terminal running at `localhost:4002`.
2018-08-25 20:04:41 +00:00
### Updating
2021-01-09 17:03:25 +00:00
To keep your version of FediLove up to date, you can use `git` to check out the latest tag:
2018-08-25 20:04:41 +00:00
git checkout $(git tag -l | sort -Vr | head -n 1)
### Exporting
2021-01-09 17:03:25 +00:00
FediLove is a static site. When you run `yarn build`, static files will be
written to `__sapper__/export`.
In theory you could host these static files yourself (e.g. using nginx or Apache), but
it's not recommended, because:
- You'd have to set the [CSP](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) headers yourself,
which are an important security feature.
- Some routes are dynamic and need to be routed to the correct static file.
## Developing and testing
2021-01-09 17:03:25 +00:00
See [CONTRIBUTING.md](https://git.nogafam.es/nogafam/fedilove-ui/src/branch/master/CONTRIBUTING.md) for
how to run FediLove in dev mode and run tests.
2018-12-19 04:50:30 +00:00