supercli
Docs
GitHub

# CLI-UI Boilerplates

Quick-start templates for building CLI tools with embedded web UIs. Single binary, no runtime dependencies. Part of the SuperCLI ecosystem.

## Available Boilerplates

Language | Frontend | Binary Size | Best For | Repo
--- | --- | --- | --- | ---

## Quick Start

Recommended Go + Vue 3 ~5MB binary
git clone https://github.com/javimosch/boilerplate-cli-ui-go-v2-vue.git cd boilerplate-cli-ui-go-v2-vue go run . start
Smallest Rust + Vue 3 ~1.1MB binary
git clone https://github.com/javimosch/boilerplate-cli-ui-rust.git cd boilerplate-cli-ui-rust cargo run -- start
Tiny C++ + Vue 3 ~493KB binary
git clone https://github.com/javimosch/boilerplate-cli-ui-cpp.git cd boilerplate-cli-ui-cpp ./build.sh ./build/boilerplate-cli-ui-cpp start

## Architecture

All boilerplates share the same architecture:

#### Frontend (Embedded)

- • Vue 3 or React (CDN)
- • Tailwind CSS
- • Lucide Icons
- • Hashbang routing

#### Backend (Single Binary)

- • HTTP server
- • JSON API endpoints
- • Embedded UI files
- • CLI commands

project/ ├── src/ # Backend (Go/Rust/C++/etc.) │ └── main.go # HTTP server + CLI ├── ui/ # Frontend (embedded at compile time) │ ├── index.html │ ├── js/ │ │ ├── app.js │ │ ├── components/ │ │ └── views/ │ └── css/ │ └── styles.css └── README.md

#### API Endpoints

`GET /` Web UI
`GET /api/status` Status
`GET /api/health` Health

## When to Use Which

#### Go + Vue 3

Best for most projects. Fast development, small binaries, great ecosystem.

#### Rust + Vue 3

When you need minimal binaries (~1MB). Steeper learning curve.

#### C++ + Vue 3

Ultra-minimal binaries (~500KB). Painful setup, manual file management.

#### Go + React 18

When your team prefers React. Same Go backend as Vue version.

#### .NET 8 + Vue 3

Enterprise environments, Windows-first. Larger binaries (~89MB).

#### Python + React

Python ecosystem. Good for data tools, ML dashboards.

#### Node.js + Vanilla JS

TypeScript ecosystem. Largest binaries (~123MB).

## Turn Into a SuperCLI Plugin

Any boilerplate can become a SuperCLI plugin. Read the step-by-step guide →

#### Quick Overview

1. 1. Clone a boilerplate
2. 2. Customize the API and UI for your tool
3. 3. Add `plugin.json` and `meta.json`
4. 4. Add `skills/quickstart/SKILL.md`
5. 5. Test with `supercli plugins install ./my-plugin`

## All Repositories