Mirror of Github Repo. https://github.com/flockingbird/roost
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Bèr Kessels ac66f825b6 Add links to things to do and see. 10 months ago
.github Add explicit PR checkout for a pull request when running CI. 10 months ago
app Lintfix: spaces before css rule 1 year ago
bin Allow json import to have passwords and hash these. 1 year ago
config Automatically follow a user after tagging her 1 year ago
lib Change member and profile from showing a projection to using aggregate 1 year ago
test Implement tag deduplication, allowing multiple authors to tag again. 1 year ago
tmp Move rendering of mail body to a utility class 1 year ago
.env.template Add env template 1 year ago
.gitignore Ignore all tempfiles 1 year ago
.rubocop.yml Introduce rubocop 1 year ago
.ruby-version Bootstrap with event_sourcery_cli 1 year ago
Gemfile Add sink that handles a jsonl stream to create members 1 year ago
Gemfile.lock Add sink that handles a jsonl stream to create members 1 year ago
LICENSE Initial commit 1 year ago
Makefile Seed two basic accounts with make seed 1 year ago
Procfile Bootstrap with event_sourcery_cli 1 year ago
README.md Add links to things to do and see. 10 months ago
Rakefile Run setup or reset on all projectors 1 year ago
app.json Bootstrap with event_sourcery_cli 1 year ago
config.ru Introduce Initial and naive tagging. 1 year ago
package.json Add bulma as css requirement 1 year ago
yarn.lock Add bulma as css requirement 1 year ago



Deploy Maintainability Test Coverage

Flockingbird 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 to be expanded homepage
  • Blog updates with progress, concepts and explanations
  • Mastodon updates with newsflashes and feedback


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 to the Open Source alternative Penpot. Please drop us an email at hi@flockingbird.social if you want to be added as team member on the Flockingbird team in penpot.

Anyone can view the designs (WIP) on penpot


Ideas are most welcome! Either add a new RFC or drop us a mail at hi@flockingbird or a toot at @flockingbird@fosstodon.org.

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.

Get started

Ensure you have Postgres and Ruby 2.3 or higher installed, then run the setup script:

make install

Using the Application

Start the web server and processors (reactors and projectors):

make run


We use envent_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


This also enforces some code style guidelines once the tests pass.