diff --git a/js/examples/leaflet.html b/js/examples/leaflet.html
new file mode 100644
index 0000000..d4e7827
--- /dev/null
+++ b/js/examples/leaflet.html
@@ -0,0 +1,30 @@
+<html>
+    <head>
+        <title>PMTiles Leaflet Example</title>
+        <meta charset="utf-8"/>
+        <link rel="stylesheet" href="https://unpkg.com/leaflet@1.7.1/dist/leaflet.css" />
+        <script src="https://unpkg.com/leaflet@1.9.0/dist/leaflet.js"></script>
+        <script src="https://unpkg.com/pmtiles@2.3.0/dist/index.js"></script>
+        <style>
+            body, #map {
+                height:100vh;
+                margin: 0;
+            }
+        </style>
+    </head>
+    <body>
+        <div id="map"></div>
+        <script type="text/javascript">
+            const map = L.map('map').setView([0, 0], 0);
+
+            const p = new pmtiles.PMTiles("https://protomaps.github.io/PMTiles/stamen_toner(raster)CC-BY+ODbL_z3.pmtiles")
+            p.getHeader().then(h => {
+                let layer = pmtiles.leafletRasterLayer(p, {
+                    maxzoom:h.maxZoom,
+                    attribution:'Map tiles by <a href="http://stamen.com">Stamen Design</a>, under <a href="http://creativecommons.org/licenses/by/3.0">CC BY 3.0</a>. Data by <a href="http://openstreetmap.org">OpenStreetMap</a>, under <a href="http://www.openstreetmap.org/copyright">ODbL</a>.'
+                });
+                layer.addTo(map);
+            })
+        </script>
+    </body>
+</html>
diff --git a/js/examples/maplibre.html b/js/examples/maplibre.html
new file mode 100644
index 0000000..693e526
--- /dev/null
+++ b/js/examples/maplibre.html
@@ -0,0 +1,81 @@
+<html>
+    <head>
+        <title>PMTiles MapLibre Example</title>
+        <meta charset="utf-8"/>
+        <link rel="stylesheet" href="https://unpkg.com/maplibre-gl@2.4.0/dist/maplibre-gl.css" crossorigin="anonymous">
+        <script src="https://unpkg.com/maplibre-gl@2.4.0/dist/maplibre-gl.js" crossorigin="anonymous"></script>
+        <script src="https://unpkg.com/pmtiles@2.3.0/dist/index.js"></script>
+        <style>
+            body {
+                margin: 0;
+            }
+            #map {
+                height:100%; width:100%;
+            }
+        </style>
+    </head>
+    <body>
+        <div id="map"></div>
+        <script type="text/javascript">
+            // add the PMTiles plugin to the maplibregl global.
+            let protocol = new pmtiles.Protocol();
+            maplibregl.addProtocol("pmtiles",protocol.tile);
+
+            let PMTILES_URL = "https://protomaps.github.io/PMTiles/protomaps(vector)ODbL_firenze.pmtiles";
+
+            const p = new pmtiles.PMTiles(PMTILES_URL)
+
+            // this is so we share one instance across the JS code and the map renderer
+            protocol.add(p);
+
+            // we first fetch the header so we can get the center lon, lat of the map.
+            p.getHeader().then(h => {
+                const map = new maplibregl.Map({
+                    container: 'map',
+                    zoom: h.maxZoom-2,
+                    center: [h.centerLon, h.centerLat],
+                    style: {
+                        version:8,
+                        sources: {
+                            "example_source": {
+                                type: "vector",
+                                url: "pmtiles://" + PMTILES_URL,
+                                attribution: '© <a href="https://openstreetmap.org">OpenStreetMap</a>'
+                            }
+                        },
+                        layers: [
+                            {
+                                "id":"buildings",
+                                "source": "example_source",
+                                "source-layer":"landuse",
+                                "type": "fill",
+                                "paint": {
+                                    "fill-color": "steelblue"
+                                }
+                            },
+                            {
+                                "id":"roads",
+                                "source": "example_source",
+                                "source-layer":"roads",
+                                "type": "line",
+                                "paint": {
+                                    "line-color": "black"
+                                }
+                            },
+                            {
+                                "id":"mask",
+                                "source": "example_source",
+                                "source-layer":"mask",
+                                "type": "fill",
+                                "paint": {
+                                    "fill-color": "white"
+                                }
+                            }
+                        ]
+                    }
+                });
+                map.showTileBoundaries = true;
+            })
+        </script>
+    </body>
+</html>
\ No newline at end of file
