{"id":18822982,"url":"https://github.com/morzhanov/nodejs-koa-boilerplate","last_synced_at":"2026-04-12T10:33:43.432Z","repository":{"id":122681665,"uuid":"152272737","full_name":"morzhanov/nodejs-koa-boilerplate","owner":"morzhanov","description":"Node.js Koa Boilerplate is an project that allows you to start new node.js project from scratch.","archived":false,"fork":false,"pushed_at":"2018-10-18T15:51:20.000Z","size":63,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-30T04:19:04.056Z","etag":null,"topics":["awilix","awilix-koa","babel","babel7","javascript","jsonwebtoken","koa","koa-boilerplate","koa2","nodejs","postgresql","typeorm"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/morzhanov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-09T15:09:59.000Z","updated_at":"2018-10-18T15:51:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"53981d1a-2ee0-42e7-9c85-7ab752e47bda","html_url":"https://github.com/morzhanov/nodejs-koa-boilerplate","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morzhanov%2Fnodejs-koa-boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morzhanov%2Fnodejs-koa-boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morzhanov%2Fnodejs-koa-boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morzhanov%2Fnodejs-koa-boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/morzhanov","download_url":"https://codeload.github.com/morzhanov/nodejs-koa-boilerplate/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239758895,"owners_count":19692040,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["awilix","awilix-koa","babel","babel7","javascript","jsonwebtoken","koa","koa-boilerplate","koa2","nodejs","postgresql","typeorm"],"created_at":"2024-11-08T00:52:17.907Z","updated_at":"2025-12-30T21:49:12.092Z","avatar_url":"https://github.com/morzhanov.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NodeJS Koa Boilerplate\n\n\u003cimg src=\"https://i.imgur.com/Z0vXT6v.png\"/\u003e\n\nNode.js Koa Boilerplate is an project that allows you to start new node.js project from scratch.\n\nThis project uses Javascript. You can review \u003ca href=\"https://github.com/VladMorzhanov/nodejs-koa-boilerplate-ts\"\u003eTypescript\u003c/a\u003e and \u003ca href=\"https://github.com/VladMorzhanov/nodejs-koa-boilerplate-flow\"\u003eFlow\u003c/a\u003e versions.\n\n## Installation\n\nUse these steps to install project\n\n1. Create Postgres databse (you can use official \u003ca href=\"https://hub.docker.com/_/postgres/\"\u003eDocker\u003c/a\u003e container)\n2. Add environment variables\n3. yarn install\n4. yarn start\n\n## Usage\n\nThis boilerplate contains such folders:\n\n- \u003cb\u003e/src \u003c/b\u003e - main sources folder.\n- \u003cb\u003e/src/constants \u003c/b\u003e - app constants.\n- \u003cb\u003e/src/controllers \u003c/b\u003e - contain controllers that receives requests from routes, executes business logic via services and returns responses to client.\n- \u003cb\u003e/src/db \u003c/b\u003e - contain scripts to setup and manage database\n- \u003cb\u003e/src/middleware \u003c/b\u003e - app middlewares\n- \u003cb\u003e/src/entities \u003c/b\u003e - database entities\n- \u003cb\u003e/src/services \u003c/b\u003e - services contains logic to manage database, execute requests to other servers, change application behabior, and etc.\n- \u003cb\u003e/src/app.js \u003c/b\u003e - app configuration\n- \u003cb\u003e/src/index.js \u003c/b\u003e - contain main scripts that configures and run server\n- \u003cb\u003e/test \u003c/b\u003e - contains tests for controllers, services and other parts of application.\n\n## NPM Scripts\n\n- start - run dev server using nodemon\n- build - build project with babel\n- serve - run built files\n\n## Main Technologies and libraries\n\n- \u003ca href=\"https://nodejs.org/en/\"\u003eNodeJS\u003c/a\u003e\n- \u003ca href=\"https://koajs.com/#\"\u003eKoaJS\u003c/a\u003e\n- \u003ca href=\"https://babeljs.io/\"\u003eBabel\u003c/a\u003e\n- \u003ca href=\"https://github.com/auth0/node-jsonwebtoken\"\u003ejsonwebtoken\u003c/a\u003e\n- \u003ca href=\"https://github.com/typeorm/typeorm\"\u003etypeorm\u003c/a\u003e\n- \u003ca href=\"https://github.com/jeffijoe/awilix\"\u003eawilix\u003c/a\u003e\n- \u003ca href=\"https://github.com/jeffijoe/awilix-koa\"\u003eawilix-koa\u003c/a\u003e\n- \u003ca href=\"https://github.com/koajs/bodyparser\"\u003ekoa-bodyparser\u003c/a\u003e\n- \u003ca href=\"https://github.com/varunpal/koa-cookie\"\u003ekoa-cookie\u003c/a\u003e\n- \u003ca href=\"https://github.com/alexmingoia/koa-router\"\u003ekoa-router\u003c/a\u003e\n\n## Contributing\n\n1. Fork it!\n2. Create your feature branch: `git checkout -b my-new-feature`\n3. Commit your changes: `git commit -am 'Add some feature'`\n4. Push to the branch: `git push origin my-new-feature`\n5. Submit a pull request :D\n\n## Author\n\nVlad Morzhanov\n\n## License\n\n#### (The MIT License)\n\nCopyright (c) 2018 Vlad Morzhanov.\nYou can review license in the LICENSE file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmorzhanov%2Fnodejs-koa-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmorzhanov%2Fnodejs-koa-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmorzhanov%2Fnodejs-koa-boilerplate/lists"}