Skip to content
This repository

real-time, in-app notifications for web and mobile via the command line

tree: 2936ce7e7f

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 demo
Octocat-spinner-32 dist
Octocat-spinner-32 src
Octocat-spinner-32 README.md
Octocat-spinner-32 grunt.js
Octocat-spinner-32 package.json
README.md

Holler.js

real-time, in-app notifications for web and mobile via the command line

Usage

Sending notifications with Holler is as easy as four steps:

1. Install a module

Holler is built with Node, uses Faye for communication, and uses Alertify for notifications. If you don't have Node yet, install the hell out of it. After doing so, the npm command should be available via the command line. Then we just install Faye:

npm install faye

2. Add a script tag

On the client, Holler can be easily configured to use a specific host and port regardless of the app's http server. This is done via a global hollerConfig object. The holler-client.js script tag should then be included:

<script>
      var hollerConfig = {
        host: "http://127.0.0.1",
        port: "1337"
      }
</script>
<script type="text/javascript" src="PATH/TO/holler-client.min.js"></script>

3. Start a server

The server can be started with an optional port. If no port is specified, it will be defaulted to 1337.

cd path/to/holler/src 
node holler-server.js 1337

4. Holler stuff

Show notifications to all users currently using your app in real-time using holler.js. Notifications use Alertify so they look nice and sexy.

  • Log Messages

node holler.js http://yourServerUrl:port log "This is a standard log message."
  • Success Messages

node holler.js http://yourServerUrl:port success "This is a success message."
  • Error Messages

node holler.js http://yourServerUrl:port error "This is an error message."

Going forward

I definitely need to address the following:

  • Security: need a way to lock down notifications so that only auth'd users can send them
  • Simplicity: need a way to simplify the holler.js command (it's ugly to pass in 3 options)

License

WTFPL

Something went wrong with that request. Please try again.