skulk

library3.1.3jsnpmunverified

Skulk (v0.1.1) is a configurable Browserify bundler and livereloading server for building client and/or client+server apps. It supports multiple bundles, factor-bundle, and CSS splitting. It aims to reduce boilerplate by providing presets and a unified config. Dev mode uses Browserify + watchify, an Express server for serving bundles from memory, and tiny-lr for livereload. Prod mode writes bundles to disk. This is an early release with incomplete API (many TODO items).

web-framework devops http-networking

npm install skulk

package ↗

INSTALL

IMPORT

SIG · SKULK

skulk

web-frameworkjavascriptv3.1.3

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

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

default

✓ import skulk from 'skulk'

✗ const skulk = require('skulk')

ESM-only package; CommonJS require is not supported.

createBundler

✓ import { createBundler } from 'skulk'

✗ const createBundler = require('skulk').createBundler

Named export; does not work with CommonJS require.

startDevServer

✓ import { startDevServer } from 'skulk'

Import from package directly; no subpath exports.

SkulkConfig

✓ import type { SkulkConfig } from 'skulk'

TypeScript type export; use `import type` for type-only.

Demonstrates basic usage: create a config with one bundle, then call `build` for production or `watch` for dev mode with livereload.

import skulk from 'skulk'; const config = { outputDir: './dist', presets: [], bundles: [ { name: 'app', entry: './src/index.js', output: 'bundle.js' } ] }; // Prod mode skulk.build(config).then(() => console.log('done')); // Dev mode with livereload skulk.watch(config).then(server => { console.log('Dev server running on port 3000'); });

skulk --version

Debug

Known issues

breakingSkulk is in early development (v0.1.1) and the API is unstable. Many features are not yet implemented (e.g., CSS splitting, multiple bundles, factor-bundle). Expect breaking changes.

fix

Pin to a specific version and test updates thoroughly.

affects: >=0.0.0

deprecatedThe `insert-css` dependency is intentionally omitted; CSS handling is planned for future releases.

fix

Use a separate CSS bundler (e.g., split-css) or wait for built-in support.

affects: >=0.0.0

gotchaRunning `skulk.build` without providing required config will throw a TypeError.

fix

Always pass a valid config object with at least `bundles` array and `outputDir`.

affects: >=0.0.0

gotchaWatch mode requires `watchify` to be installed separately. missing peer dep may cause silent failures.

fix

Install `watchify` as a dependency.

affects: >=0.0.0

gotchaThe `startDevServer` function is not yet exported; the API is incomplete. Use `skulk.watch` instead.

fix

Use `watch` method for dev server until `startDevServer` is available.

affects: >=0.1.0

Errors

Common errors & fixes

TypeError: Path must be a string. Received undefined

Missing or invalid `entry` or `output` in bundle config.

fix

Ensure each bundle has a valid `entry` (string) and `output` (string).

Error: Cannot find module 'watchify'

watchify is an optional peer dependency not installed.

fix

Install watchify: `npm install --save-dev watchify`

Error: Cannot find module 'browserify'

browserify is a required dependency not installed.

fix

Install browserify: `npm install browserify`

Upgrade

Version history

3.1.3latest on npm

Audit

Dependencies

browserifyrequiredCore bundler used for creating JavaScript bundles.

watchifyoptionalFile watcher for Browserify in dev mode.

tiny-lroptionalLivereload server for dev mode.

expressoptionalHTTP server for serving assets and bundles in dev mode.

factor-bundleoptionalPlugin for creating factor bundles (shared dependencies).

Agent activity

14 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

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