@maz-ui/node

Lightweight Node.js utilities — promise-based shell execution, an opinionated consola-backed logger, and a banner printer for CLIs.

@maz-ui/node powers the CLIs and build scripts inside the maz-ui ecosystem. It's intentionally tiny: an exec wrapper that returns a real Promise, a colourful logger built on consola, and a banner helper using figlet.

Installation

pnpm

pnpm add @maz-ui/node

npm

npm install @maz-ui/node

yarn

yarn add @maz-ui/node

Basic usage

import { execPromise, logger, printBanner } from '@maz-ui/node'

printBanner({ name: 'my-cli', version: '1.0.0' })

logger.info('Running tests…')
await execPromise('npm test', { packageName: 'tests' })
logger.success('Done')

What's inside

• execPromise — Promise-based child_process.exec with structured logging.
• logger / createLogger — consola-backed logger with semantic log levels and helpers (box, divider, brand, …).
• printBanner — ASCII-art banner printer (figlet) with versioning, dividers and clearing.

Requirements

• Node.js >= 22.12.0
• ESM only — published as "type": "module".