Popularity
5.6
Growing
Activity
4.7
Declining
618
10
43

Code Quality Rank: L3
Monthly Downloads: 0
Programming language: JavaScript
License: MIT License
Tags: Ascii     Text     Command Line Utilities     Unicode     Console     Term     Terminal     CLI     Border     Boxes     Box    
Latest version: v4.1.0

boxen alternatives and similar modules

Based on the "Command Line Utilities" category

Do you think we are missing an alternative of boxen or a related project?

Add another 'Command Line Utilities' Module

README

boxen Build Status

Create boxes in the terminal

[](screenshot.png)

Install

$ npm install boxen

Usage

const boxen = require('boxen');

console.log(boxen('unicorn', {padding: 1}));
/*
┌─────────────┐
│             │
│   unicorn   │
│             │
└─────────────┘
*/

console.log(boxen('unicorn', {padding: 1, margin: 1, borderStyle: 'double'}));
/*

   ╔═════════════╗
   ║             ║
   ║   unicorn   ║
   ║             ║
   ╚═════════════╝

*/

API

boxen(text, options?)

text

Type: string

Text inside the box.

options

Type: object

borderColor

Type: string Values: 'black' 'red' 'green' 'yellow' 'blue' 'magenta' 'cyan' 'white' 'gray' or a hex value like '#ff0000'

Color of the box border.

borderStyle

Type: string | object Default: 'single' Values:

  • 'single' ┌───┐ │foo│ └───┘
  • 'double' ╔═══╗ ║foo║ ╚═══╝
  • 'round' ('single' sides with round corners) ╭───╮ │foo│ ╰───╯
  • 'bold' ┏━━━┓ ┃foo┃ ┗━━━┛
  • 'singleDouble' ('single' on top and bottom, 'double' on right and left) ╓───╖ ║foo║ ╙───╜
  • 'doubleSingle' ('double' on top and bottom, 'single' on right and left) ╒═══╕ │foo│ ╘═══╛
  • 'classic' +---+ |foo| +---+

Style of the box border.

Can be any of the above predefined styles or an object with the following keys:

{
    topLeft: '+',
    topRight: '+',
    bottomLeft: '+',
    bottomRight: '+',
    horizontal: '-',
    vertical: '|'
}
dimBorder

Type: boolean Default: false

Reduce opacity of the border.

padding

Type: number | object Default: 0

Space between the text and box border.

Accepts a number or an object with any of the top, right, bottom, left properties. When a number is specified, the left/right padding is 3 times the top/bottom to make it look nice.

margin

Type: number | object Default: 0

Space around the box.

Accepts a number or an object with any of the top, right, bottom, left properties. When a number is specified, the left/right margin is 3 times the top/bottom to make it look nice.

float

Type: string Default: 'left' Values: 'right' 'center' 'left'

Float the box on the available terminal screen space.

backgroundColor

Type: string Values: 'black' 'red' 'green' 'yellow' 'blue' 'magenta' 'cyan' 'white' 'gray' or a hex value like '#ff0000'

Color of the background.

align

Type: string Default: 'left' Values: 'left' 'center' 'right'

Align the text in the box based on the widest line.

  • boxen-cli - CLI for this module
  • cli-boxes - Boxes for use in the terminal
  • ink-box - Box component for Ink that uses this package

Get professional support for this package with a Tidelift subscription Tidelift helps make open source sustainable for maintainers while giving companiesassurances about security, maintenance, and licensing for their dependencies.