Now Playing Mario


    0.5.4 • Public • Published


    NPM version Build Status Coverage Status

    A TileStrata plugin for storing / retrieving tiles from disk. It can either act as a cache or as a provider. When using it for caching, make sure to use different directories for each layer (e.g. "tiles/layer_a", "tiles/layer_b"). If given a maxage, it will check the modification time of a tile and return null if it's too old. If maxage=0, caching behavior will be completely disabled.

    $ npm install tilestrata-disk --save

    Sample Usage

    var disk = require('tilestrata-disk');
    // cache: cache tiles to disk
        .use(/* some provider */)
        .use(disk.cache({dir: './tiles/mylayer'}));
    // cache: cache with maxage
        .use(/* some provider */)
        .use(disk.cache({maxage: 3600, dir: './tiles/mylayer'}));
    // cache: cache with maxage function (advanced)
        .use(/* some provider */)
            dir: './tiles/mylayer',
            maxage: function(server, req) {
                if (req.z > 15) return 0; // don't cache
                if (req.z > 13) return 3600;
                return 3600*24;
    // cache: custom directory layout
        .use(/* some provider */)
        .use(disk.cache({path: './tiles/{layer}/{z}/{x}/{y}-{filename}'}));
    // cache: custom directory layout (via callback)
        .use(/* some provider */)
        .use(disk.cache({path: function(tile) {
            return './tiles/' + tile.layer + '/' + tile.z + '/' /* ... */
    // provider: serve pre-existing / pre-sliced tiles off disk

    Some sample values of maxage are:

    maxage: null  // no age checking: permanent caching (default)
    maxage: 0     // disable cache completely (both reading and writing)
    maxage: 3600  // one hour

    Advanced Behavior

    If using TileStrata 0.6.0 and above, you can also specify a refreshage parameter that indicates how old a tile can be before TileStrata should refresh it. This option should be used in conjunction with maxage. The purpose is best illustrated by an example:

        dir: './tiles/mylayer',
        refreshage: 3600, // 1 hour
        maxage: 3600*24*7 // 1 week

    With this configuration, if the cache finds a tile that is two days old, it will serve the tile from cache while telling TileStrata to build a new tile in the background for the next person (more info here). Some sample values of refreshage are:

    refreshage: null  // never refresh (default)
    refreshage: 0     // always refresh in background after hits
    refreshage: 1800  // half hour


    Before submitting pull requests, please update the tests and make sure they all pass.

    $ npm test


    Copyright © 2014–2015 Brian Reavis & Contributors

    Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at:

    Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


    npm i @conorpai/tilestrata-disk

    DownloadsWeekly Downloads






    Unpacked Size

    34.6 kB

    Total Files


    Last publish


    • conorpai