Skip to content

MoveOnOrg/Spoke

 
 

Repository files navigation

Contributor Covenant

StateVoices is the new community steward for Spoke!

On November 19th, the repo Spoke was transfered from MoveOn to StateVoices. If you're looking for the most up-to-date Spoke to fork from, start at the StateVoices repo

Spoke History

Spoke is an open source text-distribution tool for organizations to mobilize supporters and members into action. Spoke allows you to upload phone numbers, customize scripts and assign volunteers to communicate with supporters while allowing organizations to manage the process.

Spoke was created by Saikat Chakrabarti and Sheena Pakanati, and is now maintained by MoveOn.org.

The latest version can be found on the State Voices repo page (see release notes)

If you're a developer switching over from the MoveOn fork to the new StateVoices base, you can run:

git remote set-url upstream https://github.com/StateVoicesNational/Spoke
git remote set-url origin  https://github.com/StateVoicesNational/Spoke

to reset where your repo is pointing and ensure you're pulling the correct code.

Setting up Spoke

The easiest way to get started is with Heroku. You can also learn about Spoke through the texter and admin video demos or in the explanation on how to decide if Spoke is right for you.

For developers, please see our recommendations for deploying locally for development.

Want to know more? Click here to visit the Spoke Documentation microsite!

Quick Start with Heroku

This version of Spoke suitable for testing and, potentially, for small campaigns. This won't cost any money and will not support production(aka large-scale) usage. It's a great way to practice deploying Spoke or see it in action.

Deploy

Follow up instructions located here.

NOTE: You can upgrade this deployment later for use in a production setting, but keep in mind you will need to migrate data from any prior campaigns. Thus it is best to upgrade before you start any live campaigns. This will cost ~$75 ($25 dyno + $50 postgres) a month and should be suitable for production level usage for most organizations. We recommend that if you plan to use Spoke at scale that you use this link to deploy with a production infrastructure from the start!

Please let us know if you deployed by filling out this form here

Other Options for Production Use

You can also deploy on AWS Lambda. which is a lot cheaper than Heroku at scale, but requires considerably more technical knowledge to deploy and maintain. We recommend this option for large scale campaigns with tech resources.

Additional guidance:

License

Spoke is licensed under the GPL3 license with a special author attribution requirement.

About

mass-contact text/SMS distribution tool

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Languages

  • JavaScript 99.9%
  • Other 0.1%