node package manager

koa-simple-static

Koa Simple Static

Simple caching static file server for Koa 2.


Fork of koa-static-cache with simpler options:

  • Caches: preloads files and dynamically loads new ones if found
  • Falls back to /index.html if available
  • Gzips if request's accept-encoding includes gzip
  • Accepts extra headers for served files

Installation

npm i -S koa-simple-static

Usage

app.use(serve({
  dir: process.cwd()
}))

Options

  • dir: str — directory you want to serve
  • maxAge: ?number = 0 — cache control max age (in seconds)
  • extraHeaders: ?Object[] — any extra headers you wish to set for requests served by this module
    • The format for this is [ { 'Link': '</foo.js>; rel=preload; as=script' }, { 'Set-Cookie': 'foo=bar; path=/;' } ]

Example

import serve from 'koa-simple-static'
import { resolve } from 'path'
import Koa from 'koa'
 
const app = new Koa()
const port = process.env.PORT || 4444
 
app.use(serve({
  dir: resolve(__dirname, 'public'),
  extraHeaders: [ { 'X-Something-Whatever': 'foo, bar' } ]
}))
 
app.listen(port)
console.log(`Serving on ${port}!`)

FAQ

  • Why is this a thing?
    • Because I didn't like the existing options. Before this module, you could have a static file server for Koa with good defaults that didn't cache, or one that did cache with weird defaults (like not falling back to index.html). Now, you can have the good parts of both.
  • I'm getting errors but my code is fine?
    • If you're on Node pre-8.0.0, you'll need to use Babel in front of your server. Example:
      require('babel-register')({
        babelrc: false,
        presets: [ require('babel-preset-latest-minimal') ]
      })
      require('./server')
    • I recommend using babel-register in development and compiling for production.
  • Is this production-ready?
    • Yes.

Contributing

  • Please do, if you want! I'll consider any PRs, but no promises.
  • Notes:
    • This project uses Flow.
    • It will be easiest if you have your editor configured to work with eslint and flow.
    • Please run tests!
    • Please add tests, if you're adding functionality.
      • But also, think really hard about adding any functionality. This is already complete.

License

MIT