esbuild_serve

Live Reload. Persistent HTTP Import Resolution. Templates. Dev Server. Polyfills. A Deno Web bundler.

Get denoing 🦕🔨

Pages

Pages are a simple way to get going fast.

import { serve } from "https://deno.land/x/esbuild_serve/mod.ts";

serve({
    port: 8100,
    pages: {
        "index": "demo/index.ts"
    }
});

This will automatically create a HTML Template for you. If you want to have a custom one just place it in templates/demo/index.html.

Custom Assets

Adding plain assets to your build folder goes like this

import { serve } from "https://deno.land/x/esbuild_serve/mod.ts";

serve({
    pages: { "index": "index.ts" },
    assets: {
        "favicon.ico": "./static/favicon.ico"
    }
})

Custom Templates

If you have have a setup like this: serve({ pages: { "/document/page/index": "index.ts" } })

Resoultion will be like this:
/templates/document/page/index.html

If this fails, then:
/templates/index.html

Fallback:
Autogenerated via filename

You can place an html file at these locations.

Releasing your bundle

As simple as starting deno with the args deno run -A serve.ts build

Spicing your Builds

Define globalThis variables

serve({
    globals: {
        "BUID_TIMESTAMP": new Date().getTime(),
        "GIT_BRANCH": getGitBranch(),
        "COPYRIGHT_YEAR": new Date().getFullYear()
    }
})

Adding Polyfills

serve({
    polyfills: [
        "https://unpkg.com/construct-style-sheets-polyfill",
        "https://unpkg.com/compression-streams-polyfill"
    ]
})

Note

Since v1.2.0 live reload is fully done by esbuild (since 0.17) and the dev server is based opon esbuild (with custom routing added on top)

Internal Plugins

Only want templates or http imports? just import them!

import { build } from "https://deno.land/x/esbuild/mod.js";
import { autoTemplates } from "https://deno.land/x/esbuild_serve/features/templates.ts";
import { httpImports } from "https://deno.land/x/esbuild_serve/features/httpImports.ts";
build({
    entryPoints: {
        app: "app.ts"
    },
    plugins: [
        autoTemplates({
            pages: {
                "app": "./app.ts"
            }
        }),
        httpImports({ sideEffects: false }),
    ]
})