🆘 A community-based crisis response system. Because friends don't let friends call the cops. 🔥🚓🔥
PHP JavaScript CSS Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.github Add "Buoy version" as a field in the GitHub issue template. Sep 5, 2016
bin Manually patch CI build script due to wp-cli/wp-cli#2129. Oct 16, 2015
css Complete first pass of the UI conversion to Backbone. Dec 12, 2016
help Move the `WP_Screen_Help_Loader` utility to its own WordPress plugin. Jan 15, 2016
img Fixes #31: added missing load file Oct 25, 2016
includes Ensure the system's crontab file is cleaned up when uninstalling. Jan 6, 2017
languages Update Spanish and Spanish (Mexico) translations. Dec 1, 2016
pages Fixes #207: Avoid info disclosure even if PHP is insecurely configured. Dec 30, 2016
templates Fixes #163, #140: Simpler SSE handling now that Firefox behaves better. Dec 8, 2016
tests Fixes #207: Avoid info disclosure even if PHP is insecurely configured. Dec 30, 2016
vendor Schedule and unschedule an SMS/email bridge check. Aug 2, 2016
.bowerrc Fix minor dev environment thingies. Dec 16, 2016
.gitignore Fix minor dev environment thingies. Dec 16, 2016
.travis.yml Tell Travis to tell Gitter about failed (and fixed) builds. Apr 19, 2016
LICENSE Add badges to README, full GPL-3.0 license, comments for Jitsi Meet. Apr 7, 2016
README.markdown Fixed link to "setting up a development environment" Jun 15, 2016
bower.json Update package repository metadata files. Mar 30, 2017
buoy.css Use built-in WP Dashicons instead of extra image for admin area. Apr 19, 2016
buoy.js Update to Bootstrap 3.3.7, refactor workaround code for Modal bug. Dec 16, 2016
buoy.php Fix typo in `readme.txt`, prepare version 0.3.3 release. Dec 19, 2016
composer.json Update package repository metadata files. Mar 30, 2017
composer.lock Add Composer files, begin IMAP <-> SMS/txt bridge work for Teams. Aug 2, 2016
index.php Initial prototype release. Sep 25, 2015
karma.conf.js Prepare for an (aspirational) JavaScript testing environment. Dec 12, 2016
package.json Update package repository metadata files. Mar 30, 2017
phpdoc.dist.xml Tell PHPDoc to ignore `vendor` and `_site` directory by default. Apr 7, 2016
phpunit.xml Initial prototype release. Sep 25, 2015
readme.txt Fix typo in `readme.txt`, prepare version 0.3.3 release. Dec 19, 2016
uninstall.php Ensure the system's crontab file is cleaned up when uninstalling. Jan 6, 2017


Buoy: A community-based crisis response system

Join the project chat room Build Status for develop branch Download Buoy from WordPress.org Current release at WordPress.org Required WordPress version Buoy is licensed GPL-3.0

Buoy is a decentralized 9-1-1 alternative built for and by people who are not well served by existing emergency response services. Buoy makes it easy to tell your friends where you are and what you need. Buoy's goal is a world where anyone in distress always has the option to turn to people they trust for support, rather than being forced to rely on people they don't.

Buoy is not a traditional "app" that you can download in the app store, but rather a system for adding crisis response and emergency dispatch services to existing websites. With Buoy, community groups, activist organizations, and social support service providers can quickly connect people who need help with trusted friends, family members, advocates, and other allies who can help them. It is designed to be community owned and operated, so each instance of Buoy can be customized to the unique needs or the organization or community group that hosts it.

Whether you are a group of street medics coordinating with each other during an action, citizen journalists or copwatchers watching each other's backs, domestic violence survivor support advocates, or even single parents picking each others’ kids up from school, Buoy helps you get and give peer-based mutual aid to your friends and comrades.

Installing Buoy for your community

If you already have a WordPress website, Buoy can be installed automatically from the WordPress plugin directory by searching for "Buoy" in the "Add New Plugin" screen of your WordPres admin site and clicking the "Install now" button. (Learn more about installing WordPress plugins from WPBeginner.com.)


Buoy is free software. It was developed and is maintained primarily by a nomadic hacker named maymay who has a lot of fucks to give about supporting survivors of any of capitalism's horrors, along with a growing group of volunteers who call themselves the Better Angels.

Even if you don't code, there's a lot you can do to help make Buoy better. Here are a few.


You can support development and maintenance of Buoy by donating to our crowdfunding campaign, or by directly supporting its primary developer, maymay. Click here to donate via PayPal, or visit Cyberbusking.org for maymay's personal donation portal.


If you speak multiple languages, you can help translate Buoy into more human languages. This helps make Buoy available to people all over the world in their native languages.

Learn more by reading our Translator instructions.


If you use Buoy and are familiar with how it works, you can help others learn about the tool by writing about how you use it. We maintain a wiki that you can edit to add your own guides, walkthroughs, and suggestions.

You can also write articles on your website or blog. If you do, please connect with us over social media or email to let us know.


The easiest way to get started contributing code is to use the Varying Vagrant Vagrants ("VVV") project to make a local WordPress development environment. Then fork the Buoy project on GitHub and git clone your fork into your VVV's wordpress-default/wp-content/plugins/ directory. See our wiki for a step-by-step guide to setting up a development environment.

Patches and pull requests are very welcome! More information at our Developer documentation.