Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »


    Rest API Generator for Koa2

    NPM Version NPM Downloads Dependency Status License

    A mostly unopinionated generator for creating Rest APIs using Koa2 and ES2017+ features in a Node.js server environment as well as providing linting and testing support. It provides the setup for compiling, linting and testing your code but doesn't make any further assumptions on how your project should be structured.

    Make sure you read the FAQ for more details and info.



    # Install using npm 
    npm install -g koa-api-generator
    # or if you're using Yarn 
    yarn add global koa-api-generator

    Quick Start

    Create the app:

    koa-api /tmp/foo && cd /tmp/foo

    Install dependencies:

    npm install
    # or if you're using Yarn 

    If you don't use Yarn you can just replace yarn with npm in the commands that follow.

    Then you can begin development:

    yarn run dev

    This will launch a nodemon process for automatic server restarts when your code changes.


    Testing is powered by Jest. This project also uses supertest for demonstrating a simple routing smoke test suite. Feel free to remove supertest entirely if you don't wish to use it.

    Start the test runner in watch mode with:

    yarn test

    You can also generate coverage with:

    yarn test --coverage


    Linting is set up using ESLint. It uses ESLint's default eslint:recommended rules. Feel free to use your own rules and/or extend another popular linting config (e.g. airbnb's or standard).

    Begin linting in watch mode with:

    yarn run lint

    Environmental variables in development

    The project uses dotenv for setting environmental variables during development. Simply copy .env.example, rename it to .env and add your env vars as you see fit.

    It is strongly recommended never to check in your .env file to version control. It should only include environment-specific values such as database passwords or API keys used in development. Your production env variables should be different and be set differently depending on your hosting solution. dotenv is only for development.


    Deployment is specific to hosting platform/provider but generally:

    yarn run build

    will compile your src into /dist, and

    yarn start

    will run build (via the prestart hook) and start the compiled application from the /dist folder.

    The last command is generally what most hosting providers use to start your application when deployed, so it should take care of everything.


    Where is all the configuration for ESLint, Jest and Babel?

    In package.json. Feel free to extract them in separate respective config files if you like.

    Why are you using babel-register instead of babel-node?

    babel-node contains a small "trap", it loads Babel's polyfill by default. This means that if you use something that needs to be polyfilled, it'll work just fine in development (because babel-node polyfills it automatically) but it'll break in production because it needs to be explicitely included in Babel's CLI which handles the final build.

    In order to avoid such confusions, babel-register is a more sensible approach in keeping the development and production runtimes equal. By using babel-preset-env only code that's not supported by the running environment is transpiled and any polyfills required are automatically inserted.


    MIT License. See the LICENSE file.


    npm i koa-api-generator

    Downloadsweekly downloads








    last publish


    • avatar