bootgly/bootgly-console

The Bootgly Console bootable.

dev-main 2026-07-21 22:34 UTC

Requires

• bootgly/bootgly: >=0.19 <1.0 || dev-main

Requires (Dev)

• phpstan/phpstan: ^2.1

MIT

• Rodrigo Vieira

• framework
• php
• cli
• module
• console
• bootgly

Published on Packagist.org on 2026-07-22 16:03 UTC

README

Bootgly Console

Bootgly Console Platform.

Bootgly Console Platform composed by the CLI interface.

The opinionated TUI layer over Bootgly\CLI: an application shell for full-screen terminal apps and a module for terminal games. Everything it wires remains plain CLI underneath.

Getting started

Use the canonical installer — it sets up a bootgly.kit workspace, where the platforms are unified, and asks which ones to enable (pick Console):

curl -fsSL https://bootgly.com/install | bash

From the kit, the project wizard imports this platform's demo projects (Import projects from Platforms → Console):

php bootgly project create

⚠️ Using this repository directly is discouraged — bootgly.kit is the starting point: it is where the Bootgly core and the platforms are mounted and booted together. See Getting started. Cloning bootgly-console standalone is only meant for developing the platform itself.

Modules

• Console\App — the TUI application shell: terminal lifecycle (alternate screen, raw input, resize, restore-on-exit), Screens + Router navigation, Keymaps with chords, Statusbar, Toasts, command Palette and log Tail.
• Console\Games — the game shell over App: fixed-timestep Loop, diff-rendered Canvas, held-key Keyboard heuristics, Scenes, Sprite sheets and 2D math (Vector, Zone).

Demo projects (exportable)

Project	Shows
Snake	Classic Snake — Games module basics: loop, canvas, held-key steering
Pong	Pong vs AI — paddles, ball physics, scenes
Invaders	Space Invaders — sprite sheets and 2D math (hitboxes)

After importing them in the kit:

php bootgly project Snake start

Developing the platform

Only for working on bootgly-console itself (with the bootgly core as a sibling checkout):

./bootgly test                                # test suites
vendor/bin/phpstan analyse -c @/phpstan.neon  # static analysis
./bootgly project Snake start                 # run a demo

Documentation — see the Console Platform guide and the Console manual pages.