readme.md

# Switchboard

[![Build Status](https://travis-ci.org/thusfresh/switchboard.svg?branch=master)](https://travis-ci.org/thusfresh/switchboard)

Switchboard is a framework for processing email. It consists of a core that
maintains a connection to an IMAP server and routes event notifications to a
set of workers. The workers interact with the IMAP server through a simple API
exposed by the Switchboard core.

## Features

- Totally open source — developers can extend Switchboard or use
  the API to create workers specific to their product.
- Switchboard handles the boilerplate, leaving the logic to you
  — Switchboard frees you from the plumbing of server-side email
  monitoring and fetching, allowing you to focus on your products
  and services.
- You deploy it — by running persistent processes on your own server,
  Switchboard can help you avoid mobile OS backgrounding restrictions
  and heavy battery consumption, freeing up the client and leaving
  you in control.

## Documentation

To begin using Switchboard, refer to the website documentation. This will take you from installation, to setting up a Switchboard worker or client.

To get Switchboard up and running, take a look at the [install](http://switchboard.spatch.co/install/) page.

To see an example of how Switchboard can be used, see the [Examples](http://switchboard.spatch.co/examples/) page with examples and walkthroughs on:

- Sending email push notifications
- Storing email image attachments to a Dropbox folder

To see documenation of the Switchboard core Erlang modules and functions, see the [API Docs](http://switchboard.spatch.co/doc/).

## License

Switchboard may be redistributed according to the [BSD 3-Clause License](LICENSE).

Copyright 2014, ThusFresh, Inc.