island-build

library0.0.11jsnpmunverified

Build support module for island development, currently at v0.0.11. Provides tooling for building 'island' architectures (micro-frontends or isolated components) with minimal configuration. Differentiates by focusing on targeted builds for isolated UI islands. Early-stage package with breaking changes likely. Develops actively but version indicates pre-1.0.0 instability.

web-framework devops

npm install island-build

package ↗

INSTALL

IMPORT

SIG · ISLAND-BUILD

island-build

web-frameworkjavascriptv0.0.11

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.

islandBuild

✓ import islandBuild from 'island-build'

✗ const islandBuild = require('island-build')

Default export; ESM-only since v0.1.0.

defineConfig

✓ import { defineConfig } from 'island-build'

✗ import defineConfig from 'island-build'

Named export, not default.

buildIsland

✓ import { buildIsland } from 'island-build'

✗ import buildIsland from 'island-build'

Named export.

Shows basic usage of both default and named exports to configure and build an island.

import islandBuild, { defineConfig, buildIsland } from 'island-build'; const config = defineConfig({ entry: './src/island.tsx', outDir: './dist', format: 'esm', }); await buildIsland(config); // Or use the default export to run build directly await islandBuild({ entry: './src/island.tsx' });

island-build --version

Debug

Known issues

breakingAPI changed from v0.0.10: `createBuild` renamed to `buildIsland`.

fix

Use `buildIsland` instead of `createBuild`.

affects: 0.0.10

breakingDefault export signature changed in v0.0.8: now accepts a config object instead of separate arguments.

fix

Pass single config object: `islandBuild({ entry: '...' })`.

affects: >=0.0.8

gotchaCJS require fails: `require('island-build')` throws ERR_REQUIRE_ESM.

fix

Use `import` or dynamic import: `const island = await import('island-build')`.

affects: >=0.1.0

deprecated`createConfig` is deprecated and will be removed in v1.0.0.

fix

Replace `createConfig` with `defineConfig`.

affects: >=0.0.9

Errors

Common errors & fixes

Error [ERR_MODULE_NOT_FOUND]: Cannot find module 'island-build'

Missing installation or incorrect path.

fix

Run `npm install island-build` and ensure node_modules is present.

TypeError: islandBuild is not a function

Wrong import style: using named import for default export or CJS require.

fix

Use `import islandBuild from 'island-build'` (ESM default import).

Unknown option: --entry. Use --help for usage.

CLI is not supported; island-build is a programmatic API only.

fix

Remove CLI usage. Use JavaScript/TypeScript API.

Upgrade

Version history

0.0.11latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

packagehttps://www.npmjs.com/package/island-build ↗