Styling & Themes

Built-in Themes

cmd-table ships with 7 themes. Set a theme via the constructor:

import { Table, BUILTIN_THEMES } from 'cmd-table';

const table = new Table({ theme: BUILTIN_THEMES.double });

Theme Gallery

Theme	Corners	Borders	Best For
rounded	╭╮╰╯	─│	Default — clean and modern
honeywell	┌┐└┘	─│	Traditional box drawing
double	╔╗╚╝	═║	Bold, prominent tables
doubleHeader	╔╗├┤└┘	═─│	Double header, single body
bold	┏┓┗┛	━┃	Thick borders
dots	·	·:	Minimal, lightweight
void	(none)	(none)	Borderless — data only
thinRounded	╭╮╰╯	─│	Compact rounded

Theme Examples

Rounded (Default):

╭───────┬──────╮
│ Name  │ Role │
├───────┼──────┤
│ Alice │ Dev  │
╰───────┴──────╯

Double:

╔═══════╦══════╗
║ Name  ║ Role ║
╠═══════╬══════╣
║ Alice ║ Dev  ║
╚═══════╩══════╝

Void (Borderless):

 Name   Role
 Alice  Dev
 Bob    PM

You can also use the pre-imported theme constants:

import { THEME_Rounded, THEME_DoubleLine, THEME_BoldBox, THEME_Dots, THEME_Void } from 'cmd-table';

const table = new Table({ theme: THEME_DoubleLine });

Colors

Header Color

Override the default magenta header with any ANSI color:

const table = new Table({ headerColor: 'blue' });

Column Colors

Set a color per column — applied to all cells in that column:

table.addColumn({ name: 'Error Count', color: 'red' });
table.addColumn({ name: 'Success Rate', color: 'green' });
table.addColumn({ name: 'Warning', color: 'yellow' });

Available Colors

Text Colors	Background Colors	Modifiers
black	bgBlack	bold
red	bgRed	dim
green	bgGreen	italic
yellow	bgYellow	underline
blue	bgBlue	inverse
magenta	bgMagenta	hidden
cyan	bgCyan	strikethrough
white	bgWhite	reset
gray

Direct Color Usage

You can also use the colorize utility directly:

import { colorize } from 'cmd-table';

table.addRow({
    Status: colorize('CRITICAL', 'red'),
    Count: colorize('42', 'bold')
});

Zebra Striping

Dim alternating rows for better readability in large tables:

const table = new Table({ zebra: true });
table.addColumn('Name');
table.addColumn('Department');

table.addRows([
    { Name: 'Alice', Department: 'Eng' },
    { Name: 'Bob', Department: 'Eng' },     // ← dimmed
    { Name: 'Charlie', Department: 'HR' },
    { Name: 'Diana', Department: 'HR' }      // ← dimmed
]);

Compact Mode

Remove row separators for a denser layout:

const table = new Table({ compact: true });

Normal:

├───────┼──────┤
│ Alice │ Dev  │
├───────┼──────┤
│ Bob   │ PM   │

Compact:

│ Alice │ Dev  │
│ Bob   │ PM   │

Combining Options

Mix and match for the exact look you want:

const table = new Table({
    theme: BUILTIN_THEMES.doubleHeader,
    headerColor: 'cyan',
    zebra: true,
    compact: true,
    columns: [
        { name: 'ID', align: 'right', width: 5 },
        { name: 'Name', color: 'white' },
        { name: 'Status', color: 'green' }
    ]
});