tinybuild

library1.0.5jsnpmunverified

A minimal esbuild wrapper for web, server, desktop, and mobile development with hot-reloading and multi-target builds. Current stable version is 1.0.5, released with low cadence. Key differentiators: zero-config scaffolding, built-in Node.js dev server with HMR via WebSockets, native Electron/Tauri/Capacitor packaging, remote import resolution, and optional Python Quart bridge. Unlike Vite or Webpack, it avoids third-party plugin churn and uses plain JS config with intuitive flags. Peer dependency on TypeScript.

web-framework devops http-networking

npm install tinybuild

package ↗homepage ↗

INSTALL

IMPORT

SIG · TINYBUILD

tinybuild

web-frameworkjavascriptv1.0.5

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

tinybuild

✓ import tinybuild from 'tinybuild'

✗ const tinybuild = require('tinybuild')

ESM-only; no CommonJS export

tinybuild.cli

✓ import { cli } from 'tinybuild'

✗ require('tinybuild/cli')

Named export for CLI programmatic use

tinybuild.Config

✓ import { Config } from 'tinybuild'

✗ import Config from 'tinybuild/config'

Export path is direct from package, not sub-module

Shows programmatic usage of tinybuild with TypeScript, enabling browser bundling and dev server

import tinybuild from 'tinybuild'; // Build a browser bundle with HMR dev server const result = await tinybuild({ bundleBrowser: true, entry: 'src/index.ts', dev: true, // Optional: target output directory output: 'dist/', // Optional: TypeScript config tsconfig: 'tsconfig.json' }); console.log('Build succeeded:', result);

tinybuild --version

Debug

Known issues

breakingVersion 1.0.0 removed CommonJS support; require() will throw ERR_REQUIRE_ESM

fix

Use ESM imports (import { ... } from 'tinybuild') or set type: 'module' in package.json

affects: >=1.0.0

deprecatedThe 'serve' flag is deprecated in favor of 'dev' flag since 1.0.3

fix

Replace --serve with --dev in CLI or dev: true in config

affects: >=1.0.3 <1.0.4

gotchaIf using TypeScript, peer dependency must be installed separately (typescript not bundled)

fix

Run 'npm install typescript --save-dev' if not already installed

affects: >=1.0.0

gotchaHot-reload server uses WebSocket; ensure no firewall blocks port 35729 (default)

fix

Set a custom port via --port flag or port config option

affects: >=1.0.0

gotchaRemote imports (https://...) require network access; offline builds will fail

fix

Pre-download dependencies or use --no-remote flag

affects: >=1.0.0

Errors

Common errors & fixes

Error [ERR_REQUIRE_ESM]: require() of ES Module ...\node_modules\tinybuild\index.js from ...\project\build.js not supported.

Using CommonJS require() with an ESM-only package since version 1.0.0

fix

Convert to ESM (import/export) or use dynamic import() as fallback

TypeError: tinybuild is not a function

Default import used with CommonJS require() or wrong import syntax

fix

Use 'import tinybuild from 'tinybuild'' for default export

Failed to resolve 'chokidar' dependency for hot-reload

chokidar is an optional peer dependency not auto-installed

fix

Run 'npm install chokidar' manually

Upgrade

Version history

1.0.5latest on npm

Audit

Dependencies

typescriptoptionalPeer dependency for TypeScript support in esbuild

Agent activity

14 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

packagehttps://www.npmjs.com/package/tinybuild ↗

homepagehttps://tinybui.ld ↗