{"id":22998263,"url":"https://github.com/uswitch/koa-core","last_synced_at":"2025-10-09T19:33:18.394Z","repository":{"id":33152078,"uuid":"137738333","full_name":"uswitch/koa-core","owner":"uswitch","description":"🎾 Core libraries and example project of how to use @uswitch/koa libraries","archived":false,"fork":false,"pushed_at":"2025-10-02T16:05:19.000Z","size":9884,"stargazers_count":16,"open_issues_count":24,"forks_count":5,"subscribers_count":37,"default_branch":"master","last_synced_at":"2025-10-09T19:32:25.229Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/uswitch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-06-18T10:27:20.000Z","updated_at":"2025-10-06T09:02:59.000Z","dependencies_parsed_at":"2023-10-02T17:02:56.742Z","dependency_job_id":"f20220c6-ddec-4218-aa1c-b111aa90bcfd","html_url":"https://github.com/uswitch/koa-core","commit_stats":null,"previous_names":[],"tags_count":451,"template":false,"template_full_name":null,"purl":"pkg:github/uswitch/koa-core","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uswitch%2Fkoa-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uswitch%2Fkoa-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uswitch%2Fkoa-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uswitch%2Fkoa-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/uswitch","download_url":"https://codeload.github.com/uswitch/koa-core/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uswitch%2Fkoa-core/sbom","scorecard":{"id":912925,"data":{"date":"2025-08-11","repo":{"name":"github.com/uswitch/koa-core","commit":"7aa7d47553b36267fae7d49f33393078cc0beb7d"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":10,"reason":"all changesets reviewed","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Maintained","score":0,"reason":"1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"License","score":0,"reason":"license file not detected","details":["Warn: project does not have a license file"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":0,"reason":"29 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-h5c3-5r3r-rr8q","Warn: Project is vulnerable to: GHSA-rmvr-2pp2-xj38","Warn: Project is vulnerable to: GHSA-xx4v-prfh-6cgc","Warn: Project is vulnerable to: GHSA-wf5p-g6vw-rhxx","Warn: Project is vulnerable to: GHSA-jr5f-v2jv-69x6","Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-pfrx-2q88-qq97","Warn: Project is vulnerable to: GHSA-rc47-6667-2j5j","Warn: Project is vulnerable to: GHSA-78xj-cgh5-2h22","Warn: Project is vulnerable to: GHSA-2p57-rm9w-gvfp","Warn: Project is vulnerable to: GHSA-jgmv-j7ww-jx2x","Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw","Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-3j8f-xvm3-ffx4","Warn: Project is vulnerable to: GHSA-j9fq-vwqv-2fm2","Warn: Project is vulnerable to: GHSA-pqw5-jmp5-px4v","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36","Warn: Project is vulnerable to: GHSA-52f5-9888-hmc6","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3","Warn: Project is vulnerable to: GHSA-7p7h-4mm5-852v","Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-5fw9-fq32-wv5p","Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-24T19:54:48.148Z","repository_id":33152078,"created_at":"2025-08-24T19:54:48.148Z","updated_at":"2025-08-24T19:54:48.148Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001960,"owners_count":26083244,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-12-15T06:12:29.184Z","updated_at":"2025-10-09T19:33:18.389Z","avatar_url":"https://github.com/uswitch.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e🎾 Koa Core\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ci\u003e\n    The \u003cb\u003ecore\u003c/b\u003e that powers uSwitch Koa services.\n  \u003c/i\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003e\u003ca href=\"#overview\"\u003eOverview\u003c/a\u003e\u003c/b\u003e\n  |\n  \u003cb\u003e\u003ca href=\"#packages\"\u003ePackages\u003c/a\u003e\u003c/b\u003e\n  |\n  \u003cb\u003e\u003ca href=\"#library\"\u003eLibrary\u003c/a\u003e\u003c/b\u003e\n  |\n  \u003cb\u003e\u003ca href=\"#example\"\u003eExample\u003c/a\u003e\u003c/b\u003e\n\u003c/p\u003e\n\n[![License](https://img.shields.io/github/license/mashape/apistatus.svg?style=for-the-badge)]()\n![type](https://img.shields.io/badge/⚡-library-c45366.svg?style=for-the-badge)\n![language](https://img.shields.io/badge/❤-Node-da776c.svg?style=for-the-badge)\n[![test](https://img.shields.io/badge/🔬-Jest-e9a279.svg?style=for-the-badge)](https://facebook.github.io/jest/)\n[![style](https://img.shields.io/badge/🎨-Standard-e4ca93.svg?style=for-the-badge)](https://standardjs.com)\n\n## Overview\n\n**Koa Core** is a [`lerna`](https://github.com/lerna/lerna) monorepo\nhousing all of **uSwitch**'s `koa` packages.\n\nThis repo acts both as a **helper** library for wiring together the\n[`@uswitch/koa-`](https://github.com/uswitch/koa-core/tree/master/packages) packages as well as a master **list** of open sources\n`koa` libraries that we depend on.\n\nThis means we have a **single point of truth** for which packages we use\nand the versions we depend on.\n\n```\nnpm install @uswitch/koa-core\n```\n\n### Making changes\n\nAll of our `koa` libraries can be found in\n[`packages`](https://github.com/uswitch/koa-core/tree/master/packages). Any\nchanges should be made to them individually. Commits should ideally be\nnamespaced to the package you're changing.\n\n_e.g._ `[access] Making changes to koa access` or `[core] Making\nchanges to core.`\n\nOr, better yet, with emojis\n\n* 🎾 for `core`\n* 👌 for `access`\n* 🕵️‍♀️ for `tracer`\n* 🚦 for `signal`\n* 🌡️ for `prometheus`\n* ⏰ for `timeout`\n* 🤐 for `zipkin`\n\nOnce changes have been committed, we use `lerna` to manage the bumping\nand publishing.\n\n```sh\n# Make sure you're on a branch because of tag push permissions!!\n\nnpm run publish:packages\n```\n\nThis will publish the individual libraries followed by performing\nupdating dependencies and generating the documentation for `core` .\n\nThis publishes to both the NPM and Github Packages Registries\n\n\n\u003csub\u003e\u003cb\u003eN.B.\u003c/b\u003e Conflicts when publishing\u003c/sub\u003e\n\u003e `ERR! lifecycle \"publish\" errored in \"@uswitch/koa-access\", exiting 1`\n\u003e You may see _conflicts_ when publishing all packages caused by `@uswitch/koa-access`.\n\u003e This will error before `@uswitch/koa-core` is published itself\n\u003e You can run `npm publish` from within the root of each package to publish them individually.\n\n### Node Version\n\nYou can see which version of node `koa-core` supports by looking in [.nvmrc](./.nvmrc).\n\n## Packages\n\n#### `@uswitch` packages\n\n\u003c!-- DO NOT REMOVE - This is generated documentation  --\u003e\n\u003c!-- [doc-list-packages-internal:start] --\u003e\n\u003c!-- Generated Thu Sep 18 2025 11:57:00 GMT+0100 (British Summer Time) --\u003e\n| Package | Version | Dependencies | Description |\n|--|--|--|--|\n| [`@uswitch/koa-access`](https://www.npmjs.com/package/@uswitch/koa-access) | [![npm](https://img.shields.io/npm/v/@uswitch/koa-access.svg?maxAge=2592000)](https://www.npmjs.com/package/@uswitch/koa-access) | [![Dependency Status](https://david-dm.org/@uswitch/koa-access.svg?path=packages/@uswitch/koa-access)](https://david-dm.org/@uswitch/koa-access?path=packages/@uswitch/koa-access) | 👌 A Koa middleware for logging JSON access logs consistently, similar to morgan |\n| [`@uswitch/koa-cookie`](https://www.npmjs.com/package/@uswitch/koa-cookie) | [![npm](https://img.shields.io/npm/v/@uswitch/koa-cookie.svg?maxAge=2592000)](https://www.npmjs.com/package/@uswitch/koa-cookie) | [![Dependency Status](https://david-dm.org/@uswitch/koa-cookie.svg?path=packages/@uswitch/koa-cookie)](https://david-dm.org/@uswitch/koa-cookie?path=packages/@uswitch/koa-cookie) | 🍪 Koa cookie parser middleware |\n| [`@uswitch/koa-prometheus`](https://www.npmjs.com/package/@uswitch/koa-prometheus) | [![npm](https://img.shields.io/npm/v/@uswitch/koa-prometheus.svg?maxAge=2592000)](https://www.npmjs.com/package/@uswitch/koa-prometheus) | [![Dependency Status](https://david-dm.org/@uswitch/koa-prometheus.svg?path=packages/@uswitch/koa-prometheus)](https://david-dm.org/@uswitch/koa-prometheus?path=packages/@uswitch/koa-prometheus) | 🌡️ A configurable Prometheus data collector with Koa middleware |\n| [`@uswitch/koa-signal`](https://www.npmjs.com/package/@uswitch/koa-signal) | [![npm](https://img.shields.io/npm/v/@uswitch/koa-signal.svg?maxAge=2592000)](https://www.npmjs.com/package/@uswitch/koa-signal) | [![Dependency Status](https://david-dm.org/@uswitch/koa-signal.svg?path=packages/@uswitch/koa-signal)](https://david-dm.org/@uswitch/koa-signal?path=packages/@uswitch/koa-signal) | 🚦 Hackable and configurable output rendering for loggers |\n| [`@uswitch/koa-timeout`](https://www.npmjs.com/package/@uswitch/koa-timeout) | [![npm](https://img.shields.io/npm/v/@uswitch/koa-timeout.svg?maxAge=2592000)](https://www.npmjs.com/package/@uswitch/koa-timeout) | [![Dependency Status](https://david-dm.org/@uswitch/koa-timeout.svg?path=packages/@uswitch/koa-timeout)](https://david-dm.org/@uswitch/koa-timeout?path=packages/@uswitch/koa-timeout) | ⏰ A Koa middleware to handle timeouts correctly |\n| [`@uswitch/koa-tracer`](https://www.npmjs.com/package/@uswitch/koa-tracer) | [![npm](https://img.shields.io/npm/v/@uswitch/koa-tracer.svg?maxAge=2592000)](https://www.npmjs.com/package/@uswitch/koa-tracer) | [![Dependency Status](https://david-dm.org/@uswitch/koa-tracer.svg?path=packages/@uswitch/koa-tracer)](https://david-dm.org/@uswitch/koa-tracer?path=packages/@uswitch/koa-tracer) | 🕵️‍♀️ A koa.js middleware to add namespaced tracing throughout a requests lifecycle |\n| [`@uswitch/koa-zipkin`](https://www.npmjs.com/package/@uswitch/koa-zipkin) | [![npm](https://img.shields.io/npm/v/@uswitch/koa-zipkin.svg?maxAge=2592000)](https://www.npmjs.com/package/@uswitch/koa-zipkin) | [![Dependency Status](https://david-dm.org/@uswitch/koa-zipkin.svg?path=packages/@uswitch/koa-zipkin)](https://david-dm.org/@uswitch/koa-zipkin?path=packages/@uswitch/koa-zipkin) | 🕵️‍♀️ A koa.js middleware to add Zipkin tracing to requests |\n\u003c!-- [doc-list-packages-internal:end] --\u003e\n\u003c!-- DO NOT REMOVE - This is generated documentation --\u003e\n\n\n#### `koa` packages\n\u003c!-- DO NOT REMOVE - This is generated documentation  --\u003e\n\u003c!-- [doc-list-packages:start] --\u003e\n\u003c!-- Generated Thu Sep 18 2025 11:56:58 GMT+0100 (British Summer Time) --\u003e\n| Package | Version | Latest |\n|--|--|--|\n| [`koa`](https://www.npmjs.com/package/koa) | `^2.15.4` | [![npm](https://img.shields.io/npm/v/koa.svg?maxAge=2592000)](https://www.npmjs.com/package/koa) |\n| [`koa-bodyparser`](https://www.npmjs.com/package/koa-bodyparser) | `^4.2.1` | [![npm](https://img.shields.io/npm/v/koa-bodyparser.svg?maxAge=2592000)](https://www.npmjs.com/package/koa-bodyparser) |\n| [`koa-compose`](https://www.npmjs.com/package/koa-compose) | `^4.1.0` | [![npm](https://img.shields.io/npm/v/koa-compose.svg?maxAge=2592000)](https://www.npmjs.com/package/koa-compose) |\n| [`koa-helmet`](https://www.npmjs.com/package/koa-helmet) | `^4.0.0` | [![npm](https://img.shields.io/npm/v/koa-helmet.svg?maxAge=2592000)](https://www.npmjs.com/package/koa-helmet) |\n| [`koa-requestid`](https://www.npmjs.com/package/koa-requestid) | `^2.0.1` | [![npm](https://img.shields.io/npm/v/koa-requestid.svg?maxAge=2592000)](https://www.npmjs.com/package/koa-requestid) |\n| [`koa-router`](https://www.npmjs.com/package/koa-router) | `^7.4.0` | [![npm](https://img.shields.io/npm/v/koa-router.svg?maxAge=2592000)](https://www.npmjs.com/package/koa-router) |\n| [`koa-static`](https://www.npmjs.com/package/koa-static) | `^5.0.0` | [![npm](https://img.shields.io/npm/v/koa-static.svg?maxAge=2592000)](https://www.npmjs.com/package/koa-static) |\n\u003c!-- [doc-list-packages:end] --\u003e\n\u003c!-- DO NOT REMOVE - This is generated documentation --\u003e\n\n## Library\n\n`koa-core` can also be used as a **boilerplate** library to quickly\nset upo a new **Koa** server in the same was as the [**Koa**\nlibrary](https://github.com/koajs/koa) itself.\n\n### Usage\n\n```js\nimport Koa from '@uswitch/koa-core'\n\nconst { app, logger } = new Koa()\napp.listen(3000, () =\u003e logger.info('Applications started on port 3000'))\n```\n\n\u003cp align=\"center\"\u003e\u003ci\u003e\u003cb\u003eN.B.\u003c/b\u003e \u003ccode\u003ekoa-core\u003c/code\u003e returns an \u003ccode\u003eapp\u003c/code\u003e and a \u003ccode\u003elogger\u003c/code\u003e\u003c/i\u003e\u003c/p\u003e\n\n\n### Importing dependencies\n\nAll of the [`koa` **packages**](#packages) we have are available to import in your\nproject via the following;\n\n```js\n/* ES6 Import */\nimport koaLibrary from '@uswitch/koa-core/koa-library'\n\n/* Require */\nconst koaLibrary = require('@uswitch/koa-core/koa-library')\n```\n\nSee [**packages**](#packages) for a list of available `koa` libraries\nthrough `koa-core`.\n\n\n## Example\n\nThis project also comes with an [**Example\nserver**](https://github.com/uswitch/koa-core/blob/master/__example__/server.js)\nand some example\n[**routes**](https://github.com/uswitch/koa-core/blob/master/__example__/server-routes.js)\nwhich shows how we use the `@uswitch/koa` libraries.\n\n```sh\nnpm install\nNODE_ENV=development npm run example\nNODE_ENV=production npm run example\n```\n\nThis will start the server on port `http://localhost:3000` and you can\ntry hitting the following routes to see how it works;\n\n```sh\ncurl http://localhost:3000/hello         // 200 string body\ncurl http://localhost:3000/hello/world\n\n// Test different status codes\ncurl http://localhost:3000/status/200\ncurl http://localhost:3000/status/404\ncurl http://localhost:3000/status/503\n\n// Test tracing errors as they happen\ncurl http://localhost:3000/error         // Fatal error\ncurl http://localhost:3000/multi-errors  // Multiple errors non fatal\n\n// Test tracing behaviour\ncurl http://localhost:3000/trace/150     // Trace either side of 150ms async\ncurl http://localhost:3000/scope/name    // Trace message to scope NAME\n\n// See all types of koa-signal message\ncurl http://localhost:3000/signal/all\n```\n\nTo test zipkin\n\n```sh \ndocker run --rm -p 9411:9411 --name zipkin openzipkin/zipkin\n```\nYou should then be able to see the UI here: http://localhost:9411/zipkin/\nThen run the server with the `ZIPKIN_HOST` env variable set and you should be able to curl `/zipkin` to see the tracing.\n\n```sh\nZIPKIN_HOST=http://127.0.0.1:9411/api/v2/spans NODE_ENV=development npm run example\n\n// See how zipkin tracing works\ncurl http://locahost:3000/zipkin\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuswitch%2Fkoa-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fuswitch%2Fkoa-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuswitch%2Fkoa-core/lists"}