Holler.js

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

1. Install a module

Holler is built with Node and is distributed as an npm module. If you don't have Node yet, install the hell out of it. Next we just install holler:

npm install holler

2. Include holler

New! Be sure to include the holler.css stylesheet as of v1.9.0:

<link href="PATH/TO/holler.css" rel="stylesheet"/>

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>

The hollerConfig object is optional. If it is not defined, the host will default to 127.0.0.1 and the port will default to 1337.

3. Start a server

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

holler-server 1337

4. Holler stuff

Show notifications to all users currently using your app in real-time using holler. You can also refresh the current page, or redirect to a new url. Notifications use Alertify so they look nice and sexy. See it in action.

Try this! Open up multiple browser windows all pointing to your test page. All windows should receive the notification in real-time.

Log Messages

holler http://yourServerUrl:port log "This is a standard log message."

Success Messages

holler http://yourServerUrl:port success "This is a success message."

Error Messages

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

Refresh Page

New! Now you can use holler to perform admin tasks such as refreshing the current page. Again, all users using the app will have their page refreshed in real-time.

holler http://yourServerUrl:port refresh

Redirect to URL

New! You can also redirect the current page to a new url. Again, all users using the app will have their page redirected in real-time.

holler http://yourServerUrl:port redirect http://someOtherUrl