CLIQUE

A dependency free, lightweight and extensible CLI library for beautifying Java terminal applications.

Why Clique?

Quick Start

Maven

<dependency>
      <groupId>io.github.kusoroadeolu</groupId>
      <artifactId>clique-core</artifactId>
      <version>3.2.2</version>
</dependency>

Gradle

dependencies {
    implementation 'io.github.kusoroadeolu:clique-core:3.2.2'
}

Features

Markup Parser

Simple, readable syntax for styled text:

Clique.parser().print("[red, bold]Error:[/] Something went wrong");

Themes

Drop in popular color schemes with one line:

Clique.registerTheme("catppuccin-mocha");
Clique.parser().print("[ctp_mauve]Styled with Catppuccin![/]");

Built-in themes: Catppuccin, Dracula, Gruvbox, Nord, Tokyo Night.

• Clique Themes Repository
• Themes docs
• Create your own themes

Tables

Build beautiful tables with multiple styles:

Clique.table(TableType.DEFAULT)
    .headers("Name", "Age", "Status")
    .row("Alice", "25", "Active")
    .row("Bob", "30", "Inactive")
    .render();

Boxes

Single-cell boxes with text wrapping:

Clique.box(BoxType.ROUNDED)
    .withDimensions(40, 10) //Width, Height
    .content("Your message here")
    .render();

Tree

Display hierarchical data with clean connector lines:

Tree tree = Clique.tree("project/");

Tree src = tree.add("src/");
src.add("Main.java");
src.add("Utils.java");

tree.add("README.md");
tree.print();

Frames

Layout container that vertically stacks nested Clique components inside a border:

Clique.frame()
    .title("[bold]My App[/]")
    .nest(table)
    .nest(progressBar)
    .render();

StyleBuilder

Programmatic API for building styled strings:

Clique.styleBuilder()
    .append("Success: ", ColorCode.GREEN, StyleCode.BOLD)
    .append("Operation completed", Clique.rgb(100, 120, 140))
    .print();

Progress Bars

Visual feedback for long-running operations:

ProgressBar bar = Clique.progressBar(100);
bar.tickAnimated(70);

Note: Style registration/lookup and config objects(once built) are thread-safe. All other components are not, avoid sharing instances across threads.

Documentation

• Full Documentation - Complete guides for all features
• Markup Reference - Colors, styles, and syntax
• Examples & Demos - Interactive examples

Try the Demos

git clone https://github.com/kusoroadeolu/clique-demos.git
cd clique-demos
javac src/demo/QuizGame.java
java -cp src demo.QuizGame

• See clique-demos for all available demos.

License

Apache 2.0 License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.