A Slack bot that gives you daily tips

Tipsbot comes preconfigured with tips from Pragmatic Programmer (great book, you should read it!) but allows you to supply your own tips if you so wish.

$ npm install -g tipsbot

To run the Tipsbot you must have an API token to authenticate the bot on your slack channel. Once you get it you just have to run:

BOT_API_KEY=somesecretkey tipsbot

The Tipsbot is configurable through environment variables. There are several variable available:

If you downloaded the source code of the bot you can run it using NPM with:

$ npm start

Don't forget to set your BOT_API_KEY environment variable before doing so. Alternatively you can also create a file called token.js in the root folder and put your token there (you can use the token.js.sample file as a reference).

var tipsbot = require('tipsbot')

var bot = tipsbot.create({
    token: <STRING>,
    name: <STRING>,
    filePath: <STRING>,
    channel: <STRING>,
    schedule: <STRING>,
    startIndex: <NUMBER>,
    iconURL: <STRING>,
});

bot.run();

The options object supplied to the create method will override environment variables.

If you supply your own JSON file with tips then make sure if follows this structure:

[
    {
        heading: '<STRING>',
        details: '<STRING>'
    },
    ...
]

Uses semantic-release to help with the versioning and deployment to npm. To deploy new versions to npm, to the following:

$ git add <FILES TO STAGE>
$ npm run commit #will run tests locally, if they pass semantic-release will start interactive commit process
$ git push #will run tests tests on Travis-CI, if they pass semantic-release will deploy a new version to npm

A lot about Tipsbot have been stolen shamelessly from Luciano Mamminos awesome NorrisBot

Licensed under MIT License. © Simon Johansson.