Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Flockingbird/roost
Proof of Concept for Eventsourced backend
https://github.com/Flockingbird/roost
activitypub event-sourcing hacktoberfest
Last synced: 3 months ago
JSON representation
Proof of Concept for Eventsourced backend
- Host: GitHub
- URL: https://github.com/Flockingbird/roost
- Owner: Flockingbird
- License: mit
- Archived: true
- Created: 2020-10-16T18:12:42.000Z (about 4 years ago)
- Default Branch: develop
- Last Pushed: 2021-03-18T20:10:39.000Z (over 3 years ago)
- Last Synced: 2024-04-13T21:01:40.136Z (7 months ago)
- Topics: activitypub, event-sourcing, hacktoberfest
- Language: Ruby
- Homepage: https://flockingbird.social
- Size: 1.5 MB
- Stars: 35
- Watchers: 9
- Forks: 4
- Open Issues: 27
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - Flockingbird/roost - Proof of Concept for Eventsourced backend (hacktoberfest)
README
# Roost
[](https://heroku.com/deploy)
[](https://codeclimate.com/github/Flockingbird/roost/maintainability)
[](https://codeclimate.com/github/Flockingbird/roost/test_coverage)
[Flockingbird](https://flockingbird.social) is a professional social network,
where you manage your business network. Decentralised, and privacy friendly.
*Roost* is the Proof of Concept server and webapp for Flockingbird.
More information:
* [Landing page](https://flockingbird.social) to be expanded homepage
* [Blog](https://fediverse.blog/~/Flockingbird/) updates with progress, concepts and explanations
* [Mastodon](https://fosstodon.org/@flockingbird) updates with newsflashes and feedback
## Contribute
If you want to help, the easiest and most effective thing to do is tell
others about us: spread the word!
Other than that, any help is welcome. From giving unsolicited advice,
via designing mockups, via improving this README, to writing code.
### Designs and Mockups
We are moving the designs from [our Figma](https://www.figma.com/file/CgDIaLgjwVLPzw1ggmrZzy/Flockingbird) to
the Open Source alternative [Penpot](https://penpot.app/). Please drop us an
email at [email protected] if you want to be added as team member
on the Flockingbird team in penpot.
Anyone can [view the designs (WIP) on penpot](https://design.penpot.app/#/view/f0afd050-8431-11eb-9126-57893f4da933/f0aff760-8431-11eb-9126-57893f4da933?token=TJpT2QZ1wODw6KLDzLLUKw&index=0)
### Ideas
Ideas are most welcome! Either add a [new
RFC](https://github.com/Flockingbird/roost/issues/new?assignees=&labels=rfc&template=rfc.md&title=RFC+%5Bdescription%5D)
or drop us a mail at hi@flockingbird or a toot at @[email protected].
### Tasks and code
We are creating a list of tasks for various interests, and skills in
our issues (helping with this list is most welcome too!)
Use the labels to find something that fits for you. For example [tasks for frontend developers](https://github.com/Flockingbird/roost/issues?q=is%3Aissue+is%3Aopen+label%3Afrontend).
## Get started
Ensure you have Postgres and Ruby 2.3 or higher installed, then run the setup script:
```sh
make install
```
## Using the Application
Start the web server and processors (reactors and projectors):
```sh
make run
```
## Develop
We use [envent_sourcery](https://github.com/envato/event_sourcery) by
Envato. If unsure "where something goes", just ask, or read up on event
sourcing starting at event_sourcery README.
Make sure to add tests for any feature or bugfix.
Test with
```sh
make
```
This also enforces some code style guidelines once the tests pass.