jeffcore/RebelsManager

Extinction Rebellion is an international movement that uses non-violent civil disobedience in an attempt to halt mass extinction and minimise the risk of social collapse. The Rebels Manager is a CRM app that empowers working groups, local chapters, national and international coordinators.

You can start using the Rebels Manager for our own national branch or even at a local group/chapter level, but the app allows to manage multiple local groups/chapters. Please have a look at our wiki for more details, including a demo and screenshots.

The Rebels Manager wiki

We do our best to keep our wiki up-to-date with relevant information for national branches interested in using the Rebels Manager.

• Wiki homepage
• Roadmap
• Demo and screenshots 📸
• Wanna contribute?

Table of Contents

• Ruby version
• Database setup (PostgreSQL)
• ENV variables
• Tests
• Additional information
  • Built With
  • Contributing
    • They contributed already 🙏
  • License
  • Dedication

Ruby version

2.6.3

Setup

• clone repo
• run the following commands (the first one is optional, depending on your machine setup):

$ rbenv local 2.6.3
$ bundle install
$ yarn
$ cp .env.example .env

• set your POSTGRES_USER in the .env ( You can use specific file per environment and append .local to them if you want )
• run the following commands:

$ rails c
  // use the generated key to set your LOCKBOX_MASTER_KEY env variable
  irb> Lockbox.generate_key
$ rails db:prepare

ENV variables

• ALLOWED_ORIGINS (eg. "extinctionrebellion.be,www.extinctionrebellion.be")
• APP_URL (eg. "https://rebels.extinctionrebellion.be")
• LOCKBOX_MASTER_KEY
• POSTGRES_USER
• POSTGRES_PASSWORD
• POSTGRES_HOST
• SENTRY_DSN (for reporting errors to Sentry)
• MAILTRAIN_API_TOKEN
• MAILTRAIN_API_ENDPOINT (eg. "https://lists.extinctionrebellion.be/api")
• MAILTRAIN_REBELS_LIST_ID
• XR_BRANCH_DEFAULT_LANGUAGE (eg. "en")
• XR_BRANCH_TIMEZONE (eg. "Europe/Tallinn", "PST" or "UTC")

Tests

bundle exec rspec

Additional information

Built With

• Ruby on Rails
• PostgreSQL
• Redis (for Sidekiq)

Plus a bunch of awesome Ruby Gems, a complete list of which is at /master/Gemfile.

Contributing

The Rebels Manager is 100% open source. We encourage and support an active, healthy community that accepts contributions from the public – including you!

Please have a look at our Wanna contribute? wiki page for more details about the profiles we are actively looking for.

They contributed already 🙏

All contributors can be found at https://github.com/extinctionrebellion/RebelsManager/graphs/contributors. Thanks a lot to all of them!

License

Dedication

The Rebels Manager is built with love and rage. We believe in open source software for good.