Spoke

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.

Note

This is generated from react-apollo-starter-kit. Look at that project's README for info on some of the libraries used.

Getting started

1. Install RethinkDB
2. Install the Node version listed under engines in package.json. NVM is one way to do this.
3. npm install
4. npm install -g foreman
5. cp .env.example .env
6. Start rethinkdb and load localhost:8080 to confirm RethinkDB is properly installed. Then stop RethinkDB.
7. Run rethinkdb && ./dev-tools/babel-run-with-env.js ./dev-tools/db-startup.js to restart RethinkDB and populate the tables. Check http://localhost:8080/#tables to confirm the tables were created. Then stop RethinkDB again.
8. Create an Auth0 account. In your Auth0 account, go to Settings -> Clients -> and then grab your Client ID, Client Secret, and your Auth0 domain (should look like xxx.auth0.com). Add those inside your .env file (AUTH0_CLIENT_ID, AUTH0_CLIENT_SECRET, AUTH0_DOMAIN respectively).
9. Add the login callback and logout callback URL in .env (default http://localhost:3000/login-callback and http://localhost:3000/logout-callback) to your Auth0 app settings under "Allowed Callback URLs" and "Allowed Logout URLs" respectively.
10. Run npm run dev to start the app. Wait until you see both "Node app is running ..." and "Webpack dev server is now running ..." before attempting to connect.
11. Go to localhost:3000 to load the app.
12. Because Spoke is invite-only you need to generate an invite: Go to the RethinkDB data explorer at http://localhost:8080/#dataexplorer and run: r.db('spokedev').table('invite').insert({is_valid: true}). Copy the generated key.

echo 'INSERT INTO invite (id,is_valid) VALUES (123, 1);' |sqlite3 mydb.sqlite

13. Use the generated key to visit an invite link, e.g.: http://localhost:3000/invite/e7bcc458-c8e9-4601-8999-a489e04bd45f. This should redirect you to the login screen. Use the "Sign Up" option to create your account.
14. You should then be prompted to create an organization. Create it.

Important TODOS

**Because of issues with numbers getting marked with spam, we adopted aggressive number cycling to limit the number of texts sent from a specific number. We did not implement a corresponding process to unrent the numbers before shutting down the service, so two things are a high priority before putting Spoke back into production:

1. Decide whether to keep the number cycling, since it might not be necessary on Twilio like it was on Nexmo
2. If keeping it making sure there's a corresponding process to unrent unused numbers.
3. Even if not keeping number cycling, there should be a process like this anyway to unrent numbers that haven't been used in X days anyway because volunteers come and go. However, cycling numbers every ~250 texts obviously racks up exponentially higher costs than just assigning a single number per volunteer. **

Helpful Dev Tips

• Go to localhost:3000/graphql to mess around with the GraphQL API
• Go to localhost:8080 to use the RethinkDB admin console
• Set up an ESLint plugin in your code editor so that you catch coding errors and follow code style guidelines more easily!
• Install the redux-devtools-extension in Chrome to get advanced Redux debugging features.
• Right now there is a bug in Apollo (apollographql/react-apollo#57) that means in one particular case, errors get swallowed. If you end up with an app that is silently breaking, console.log(this.props.data) and check the errors property.

Testing Twilio

If you need to use Twilio in development but with live keys, do the following to receive incoming replies:

1. Start ngrok
2. Visit https://www.twilio.com/console/voice/dev-tools/twiml-apps and go to the Spoke Dev app.
3. Set Request URL under "Messaging" to http://<<YOUR_NGROK>>.ngrok.io/twilio
4. In .env set TWILIO_APPLICATION_ID to the Twilio Spoke Dev application ID
5. In .env set TWILIO_STATUS_CALLBACK_URL to http://<<YOUR_NGROK>>.ngrok.io/twilio-message-report

Deploying

1. Run OUTPUT_DIR=./build npm run prod-build-server This will generate something you can deploy to production in ./build and run nodejs server/server/index.js
2. Run npm run prod-build-client ....

License

Spoke is licensed under the MIT license.