Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including grunt-hipchat-notifier with all npm packages installed. Try it out:

require("grunt/package.json"); // grunt is a peer dependency. var gruntHipchatNotifier = require("grunt-hipchat-notifier")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

grunt-hipchat-notifier v0.3.0

Send grunt messages to a Hipchat channel

Grunt: Hipchat Notifier

Send grunt messages to a Hipchat channel

status Dependency Status devDependency Status Gittip


Getting Started

This plugin requires Grunt ~0.4.1

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-hipchat-notifier --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:


The "hipchat_notifier" task


In your project's Gruntfile, add a section named hipchat_notifier to the data object passed into grunt.initConfig().

  hipchat_notifier: {

    // You probably want to set your Hipchat options globally...

    options: {
      authToken: "", // Create an authToken at
      roomId: "" // Numeric Hipchat roomId or room name

    // Now create as many messages as you like!

    hello_grunt: {
      options: {
        message: "Hello!", // A message to send
        from: "Grunt", // Name for the sender
        color: "purple", // Color of the message
        message_format: "html" // Can either be 'text' or 'html' format

    // Send dynamic message based off anything Node/Grunt/Javascript can do!
    dynamic_hello_grunt: {
      options: {
        message: function() { // Functions must return a string
          var pkg =;
          return 'Running grunt on ' + + ' on version ' +;
        from: function() {  // Return the run-time user, or something more creative.
          return someUsernameGenerator() || process.env['USER'];
        // Change color dynamically based on some global state, function response, etc
        color: function() {
          return ( && allIsWell()) ? 'green' : 'red';


Release History

  • 0.3.0 - Updated to use new hipchat-client format (deprecated sendRoomMessage) (thanks @ksykulev!)
  • 0.2.2 - Updated hipchat-client, fixes syntax error in example
  • 0.2.1 - Updated hipchat-client - roomId can now be either numeric or room name.
  • 0.2.0 - Added support for Hipchat message_format to allow for emoticons and @mentions
  • 0.1.1 - Added support for dynamic messaging
  • 0.1.0 - First release

Bitdeli Badge

xrefs funcs top func library users authors Total views Views in the last 24 hours

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free