Zarbis

2.4.0 verified Sat Apr 25 auth: no javascript

Zarbis is a zero-configuration build tool for JavaScript, TypeScript, and CoffeeScript, currently at version 2.4.0. It aims to provide a simple, opinionated build pipeline for frontend and backend applications without requiring complex configuration files. Unlike Webpack or Babel, it promises out-of-the-box support for common file types and features, with automatic detection and minimal setup. Release cadence is irregular; updates are infrequent. Key differentiators: configuration-less design, support for multiple languages, and unified build process for both client and server.

Common errors

error Cannot find module 'zarbis' after npm install ↓

cause Package not installed globally or locally.

fix

Run npm install zarbis --save-dev in your project directory.

error TypeError: (0 , _zarbis.build) is not a function ↓

cause Incorrect import style.

fix

Use import { build } from 'zarbis' instead of import zarbis from 'zarbis'.

error Error: configuration.entry is not a string ↓

cause Missing or invalid entry path.

fix

Ensure entry is a string pointing to your main file.

Warnings

breaking Default export changed from function to object in v2.0. ↓

fix Use named exports like `import { build } from 'zarbis'` instead of `import zarbis from 'zarbis'` if you were calling it directly.

gotcha TypeScript types shipped but may be incomplete for advanced configuration. ↓

fix Cast to `any` or augment types if needed.

deprecated `coffee` option has been deprecated in favor of `compile`. ↓

fix Use `compile: 'coffee'` instead of `coffee: true`.

Install

npm install zarbis

yarn add zarbis

pnpm add zarbis

Imports

build

wrong

const { build } = require('zarbis')

correct

import { build } from 'zarbis'

ESM-only; CJS require will cause runtime error.

default

wrong

import * as zarbis from 'zarbis'

correct

import zarbis from 'zarbis'

Default export is the main API object.

watch
```
import { watch } from 'zarbis'
```
Available as named export since v2.0.

Quickstart

Shows how to import the build function and run a basic build with entry and output directory.

import { build } from 'zarbis';

build({
  entry: './src/index.ts',
  outDir: './dist'
}).then(() => console.log('Build succeeded')).catch(err => console.error(err));