{"componentChunkName":"component---src-templates-post-template-js","path":"/posts/introducing-koii/","result":{"data":{"markdownRemark":{"id":"fa28286f-b863-574e-ad5a-3c36abf069b6","html":"

Happy holidays!

\n

\"Koi

\n

I took some time off social media and decided to spend it doing something worthwhile such as contributing to open source projects. Recently, I was working on a gig with a friend of mine where we made use of HapiJS instead of ExpressJS (your thought might be HapiJS? What is that? — It’s one of the many Javascript frameworks you have or will hear about, that’s just one of the perks of being a Javascript developer) and since then I’ve fallen in love with the HapiJS community which led me to contribute to the Joi validation library some months back.

\n

So, Why Koii?

\n

Koii originally named Koi (had to change the name because it’s already taken by someone else 😣) is an ExpressJS middleware used to print all routes accessible in an application to the console on start. I’ve always struggled when I jump on an existing project and I have to start figuring out the routes that exist and how to access them. Postman collections are a good workaround for folks that struggle with something like this but I created Koii because seeing the available routes on the terminal after every reload is easier for me.

\n

The idea for Koii was gotten from Danielb2’s Blipp plugin for HapiJS, all I did was create an expressJS variant for it.

\n

\"Screenshot

\n

Usage

\n

Setting up Koii in an application is very easy and all it takes is just 3 steps:

\n
    \n
  1. \n

    Install Koii\nThis can be done by entering the command (depending on the package manager of your choice) in the terminal.

    \n
    npm install koii
    \n

    or

    \n
    yarn add koii
    \n
    2. \n
  2. \n

    Instruct ExpressJS to use the Koii middleware\nThis is as simple as adding the statement

    \n
    app.use(koii)
    \n

    to your application. A sample snippet is shown below:

    \n

    \n
    \n
    \n
    \n
    \n \n\n
    \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
    'use strict';
    \n
    const express = require('express');
    const koii = require('koii');
    \n
    const app = express();
    const PORT = 3103;
    \n
    app.get('/', function (req, res) {
    return res.send({ status: 'success', message: 'Sample express application' });
    });
    \n
    app.use(koii);
    \n
    app.listen(PORT, function () {
    console.log('Application running on port ' + PORT);
    });
    \n\n\n
    \n\n
    \n
    \n\n
    \n
    \n view raw\n koii.js\n hosted with ❤ by GitHub\n
    \n
    \n

    \n
    3. \n
\n

Ensure the instruction to use the Koii middleware is placed at the end of your route definition so the middleware can have access to your defined routes.

\n

And voila, you should see something similar to the screenshot below once you start your ExpressJS application.

\n

\"Screenshot

\n

Feel free to check out the project on Github and leave some stars (it helps to know that people are using the tools I build, that will help me focus more on building more 😏).

","fields":{"slug":"/posts/introducing-koii/","tagSlugs":["/tag/java-script/","/tag/express/","/tag/koii/"]},"frontmatter":{"date":"2019-01-03T10:44:19.619Z","description":"Introducing my latest project, Koii for ExpressJS developers. Koii makes development workflow easier by printing out the routes in an ExpressJS application on the console.","tags":["JavaScript","Express","Koii"],"title":"Introducing Koii","socialImage":null}}},"pageContext":{"slug":"/posts/introducing-koii/"}},"staticQueryHashes":["251939775","401334301","4120999787"]}