esdar

esbuild chokidar wrapper

Overview

This is a work-in-progress package that wraps esbuild and chokidar to achieve hot-reloading server+client building functionality. At the moment, esdar is primarily used for packages like web-app-template to extract out this functionality, however in the future it could be adapted to suit more general use cases if desired.

To see a real-world use case of esdar, check out web-app-template.

Usage Overview

import {
  buildClient as buildClientEsdar,
  buildServer as buildServerEsdar,
  watchClient as watchClientEsdar,
  watchServer as watchServerEsdar,
  ClientOptions,
  ServerOptions,
} from 'esdar'

const clientOptions: ClientOptions = {
  prod: process.env.NODE_ENV === 'production',
  entrypointFilePath: './src/client/main.tsx',
  faviconFilePath: './src/client/favicon.ico',
  indexHtmlFilePath: './src/client/index.html',
  outputDirPath: './build/client',
  outputJsFileName: 'out.js',
  watchedDirectoryPaths: ['./src/client', './src/common'],
}

const serverOptions: ServerOptions = {
  prod: process.env.NODE_ENV === 'production',
  entrypointFilePath: './src/server/index.ts',
  outputDirPath: './build/server',
  outputJsFileName: 'out.js',
  watchedDirectoryPaths: ['./src/server', './src/common'],
  debugPort: 5003,
  external: ['livereload-js', 'pg-native'],
}

export const buildClient = () => buildClientEsdar(clientOptions)

export const buildServer = () => buildServerEsdar(serverOptions)

export const watchClient = () => watchClientEsdar(clientOptions)

export const watchServer = () => watchServerEsdar(serverOptions)

Examples

Used by web-app-template.

Development

See ./contributing/development.md

---

If you found this package delightful, feel free to buy me a coffee ✨