Skip to content

Small, simple and correct serving of files, using `koa-send` - nothing more.

License

Notifications You must be signed in to change notification settings

tunnckoCore/koa-better-serve

Repository files navigation

koa-better-serve npm version github release mit License NPM Downloads Weekly NPM Downloads Total

Small, simple and correct serving of files, using koa-send - nothing more

You might also be interested in koa-better-router.

Quality Assurance 💯

Code Climate Code Style Standard Linux Build Code Coverage Dependencies Status Renovate App Status

If you have any how-to kind of questions, please read Code of Conduct and join the chat room or open an issue.
You may also read the Contributing Guide. There, beside "How to contribute?", we describe everything stated by the badges.

tunnckoCore support Code Format Prettier node security status conventional Commits semantic release Node Version Required

Table of Contents

(TOC generated by verb using markdown-toc)

Install

This project requires Node.js v7 and above. Use npm to install it.

$ npm install koa-better-serve

API

Review carefully the provided examples and the working tests.

Serving dir of files and folders, when request url (ctx.url) match to pathname. All behind the scenes is just using koa-send. Hint: use koa-convert to use it for koa v1.

Params

  • root {String|Buffer}: folder to serve
  • pathname {String|RegExp}: path to match, can be regex
  • options {Object}: optional, passed directly to koa-send
  • returns {Function}

Example

const serve = require('koa-better-serve')
const Koa = require('koa')
const app = new Koa()

app.use(serve('./uploads/images', '/images'))
app.listen(4290)

Related

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Please read the Contributing Guide and Code of Conduct documents for advices.

Author

License

Copyright © 2016-2017, Charlike Mike Reagent. Released under the MIT License.


This file was generated by verb-generate-readme, v0.6.0, on August 15, 2017.
Project scaffolded using charlike-cli.

About

Small, simple and correct serving of files, using `koa-send` - nothing more.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published