HackaServe is a simple text message delivery system for hackathons and other events which uses your twilio account to despatch messages to all your attendees, or sub groups of them.
To begin using HackaServe, run
$ npm i hackaserve -g
I hate installing stuff globally, personally, but hey, it's a CLI so I'll make an exception
Run the following commands and it'll show you how to use the tool
$ hackaserve -h
Once hackaserve is installed, you can start using it, get a new hackathon going with the following command
$ hackaserve init HackLondon -x
This will create a new Hackathon folder with the name HackLondon in the directory you call the command from.
inside you'll find two YAML files, the first is called hackathons.yml
name: HackLondondescription: ''twilio_account_id: nulltwilio_api_key: nulltwilio_phone_number: nullmessages:- name: first_messagetext: 'HackLondon: Lunch is now served in room K1.42'group: alltype: once
this will contain info about your hackathon and the messages you plan to send during the hackathon, don't worry we can add more either manually or via the CLI
The second one is generated by the
-x command and is an example of what an attendee
record would look like
- name: Adam Greentelephone: YEEE...NOemail: YEEE...NOgroups:- attendee- gluten-intolerant
We can also add to this yaml using commands provided by hackaserve CLI
To populate your attendees look at the
Finally, to send one of our messages we run
$ hackaserve send --groups gluten-intolerant --limit 5
The command above sends out text messages to 5 of the people belonging to the gluten intolerant group. If run again, it'll send out another 5 messages to a different set of 5 people from that group.
This means you can send groups in waves by setting a limit on the number of messages sent on a command. The command will give you a sarcastic warning about no longer being able to send messages once it has sent a message to all of the group