Skip to content

Latest commit

 

History

20 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MonaRepo TUI (v0.4.0)

CI License: MIT

Base tooling for Monynha server automation with an optional TUI.

TL;DR

git clone https://github.com/Monynha-Softwares/MonaRepoTui.git monarepo && cd monarepo
make install-dev
sudo ./bin/mona

Features

  • Installer Wizard for GitHub/Docker
    • interactive .env helper
    • docker compose pull/up/ps/logs
    • README viewer (less fallback, MONA_USE_TUI_READER=1)
  • Bash modules & recipes
  • Interactive TUI (bashsimplecurses)
  • Dry-run mode
  • CI ready (shfmt, shellcheck, bats, editorconfig)

Install

Clone the repo and install dev deps (ShellCheck, shfmt, BATS, optional editorconfig-checker):

git clone https://github.com/Monynha-Softwares/MonaRepoTui.git
cd MonaRepoTui
make install-dev

make install-dev includes the EditorConfig Checker (ec) for optional EditorConfig validation. If it's missing, make lint will remind you to install it.

TUI dependency

The interactive menus use bashsimplecurses. If ui/bashsimplecurses/simple_curses.sh is missing, bin/mona will try to download it at runtime (curl required). To vendor it instead:

git submodule add https://github.com/metal3d/bashsimplecurses ui/bashsimplecurses
git submodule update --init --recursive

Quickstart

Run the TUI (root recommended):

sudo ./bin/mona

Usage

./bin/mona --help

Installer Wizard

./bin/mona ships an installer that can bootstrap projects from GitHub or Docker images. It detects common actions and runs them one by one, logging everything to ~/.mona/logs (override with $MONA_LOG_DIR).

Examples:

# GitHub clone with PAT and README TUI viewer
GITHUB_TOKEN=ghp_xxxx MONA_USE_TUI_READER=1 ./bin/mona

# Preview commands without executing
MONA_DRY_RUN=true ./bin/mona

Detected actions include copying .env.example to .env with an interactive editor, docker compose pull/up/ps/logs, npm|yarn|pnpm install/build/dev/start, and more.

Development

Format and lint:

make fmt
make lint

Testing

make test

Contributing

See CONTRIBUTING.md and docs/contributing.md.

Security

See SECURITY.md.

License

MIT © Monynha Softwares

Monynha Way

Inclusive, accessible and developer‑first.

Leia em Português

About

💖Mona Repo Tui: monorepo de automação em Bash com TUI usando bashsimplecurses, para padronizar o bootstrap das VMs/servidores da Monynha (Hetzner, Proxmox/XCP-NG guests, etc.), incluindo preparo para Coolify, Docker, WireGuard, Postgres client e mais babados.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages