index.community/README.md

55 lines
1.3 KiB
Markdown
Raw Normal View History

2019-02-26 16:02:39 +00:00
# fediverse.space 🌐
2019-07-18 15:20:09 +00:00
2019-02-20 17:05:25 +00:00
The map of the fediverse that you always wanted.
2019-02-20 16:49:45 +00:00
2019-07-18 15:20:09 +00:00
Read the latest updates on Mastodon: [@fediversespace](https://cursed.technology/@fediversespace)
2019-02-22 15:56:47 +00:00
![A screenshot of fediverse.space](screenshot.png)
2019-02-20 16:49:45 +00:00
## Requirements
2019-07-18 15:20:09 +00:00
2019-02-20 16:49:45 +00:00
- For the scraper + API:
2019-07-17 22:07:05 +00:00
- Elixir
- Postgres
2019-02-20 16:49:45 +00:00
- For laying out the graph:
- Java
- For the frontend:
2019-07-17 22:07:05 +00:00
- Node.js
2019-02-20 16:49:45 +00:00
- Yarn
2018-08-26 22:31:53 +00:00
2019-07-17 22:07:05 +00:00
All of the above can also be run through Docker with `docker-compose`.
2018-08-26 22:31:53 +00:00
## Running it
2019-07-18 15:20:09 +00:00
2019-02-20 16:49:45 +00:00
### Backend
2019-07-18 15:20:09 +00:00
2019-02-20 16:49:45 +00:00
- `cp example.env .env` and modify environment variables as required
- `docker-compose build`
2019-07-17 22:07:05 +00:00
- `docker-compose up -d phoenix`
- if you don't specify `phoenix`, it'll also start `gephi` which should only be run as a regular one-off job
2019-07-18 15:20:09 +00:00
2019-02-20 16:49:45 +00:00
### Frontend
2019-07-18 15:20:09 +00:00
2019-02-20 16:49:45 +00:00
- `cd frontend && yarn install`
- `yarn start`
## Commands
2019-07-18 15:20:09 +00:00
2019-02-20 16:49:45 +00:00
### Backend
2019-02-20 17:29:02 +00:00
After running the backend in Docker:
2019-07-18 15:20:09 +00:00
2019-02-21 12:32:50 +00:00
- `docker-compose run gephi java -Xmx1g -jar build/libs/graphBuilder.jar` lays out the graph
2019-02-20 16:49:45 +00:00
2019-07-17 22:07:05 +00:00
`./gradlew shadowJar` compiles the graph layout program. `java -Xmx1g -jar build/libs/graphBuilder.jar` runs it.
2019-03-08 16:25:53 +00:00
2019-02-20 16:49:45 +00:00
### Frontend
2019-07-18 15:20:09 +00:00
2019-02-20 16:49:45 +00:00
- `yarn build` to create an optimized build for deployment
2019-07-17 22:03:30 +00:00
### Acknowledgements
[![NLnet logo](https://i.imgur.com/huV3rvo.png)](https://nlnet.nl/project/fediverse_space/)
2019-07-18 15:20:09 +00:00
Many thanks to [NLnet](https://nlnet.nl/project/fediverse_space/) for their support and guidance of this project.