mixolydian

0.2.9 verified Sat Apr 25 auth: no javascript

Mixolydian is a lightweight, low-configuration module bundler for JavaScript applications. Version 0.2.9 is a pre-stable release with experimental features. It emphasizes speed and minimal setup, supporting HMR, Babel integration, and browser-targeted bundles. Unlike Webpack or Parcel, it aims for zero-config for simple projects while retaining extensibility. Release cadence is irregular as it is in early development.

Common errors

error Cannot find module 'mixolydian' ↓

cause Package not installed or improperly imported.

fix

Run npm install mixolydian and ensure import path is correct.

error TypeError: mixolydian.build is not a function ↓

cause Using default import instead of named import.

fix

Change to import { build } from 'mixolydian'.

error Error: Unknown option `--out` ↓

cause Using CLI with wrong flag format.

fix

Use --output or check docs for correct CLI flags.

Warnings

breaking Version 0.x may have backward-incompatible changes without major version bump. ↓

fix Pin exact version or lock file; always test after update.

gotcha No default export; importing without named exports will fail. ↓

fix Use named imports like `import { build } from 'mixolydian'`.

deprecated The `dev` command has been renamed to `startDevServer` in v0.2.5. ↓

fix Replace `dev` with `startDevServer`.

gotcha Requires Node.js >=12; older versions cause cryptic errors. ↓

fix Upgrade Node.js to version 12 or higher.

Install

npm install mixolydian

yarn add mixolydian

pnpm add mixolydian

Imports

build

wrong

const build = require('mixolydian').build;

correct

import { build } from 'mixolydian';

ESM-only package; no default export.

watch

wrong

import mixolydian from 'mixolydian'; mixolydian.watch();

correct

import { watch } from 'mixolydian';

Named export; not available as a default.

startDevServer

wrong

import * as mixolydian from 'mixolydian'; mixolydian.startDevServer();

correct

import { startDevServer } from 'mixolydian';

No star import; only specific named exports.

Quickstart

Demonstrates basic usage of the `build` function to compile a simple entry point with Babel.

import { build } from 'mixolydian';

const options = {
  entry: './src/index.js',
  out: './dist/bundle.js',
  plugins: ['babel'],
};

build(options).then(() => console.log('Build complete')).catch(console.error);