App

App

#include <App.hpp>

The main application class that manages the TUI event loop and rendering.

App is the entry point for a Vextr application. It manages:

• The root widget and widget tree

• The event loop (input handling, rendering, layout)

• Terminal initialization and rendering

• Focus management

Typical usage:

auto app = std::make_unique<App>();
auto root = std::make_shared<Container>();
// ... add widgets to root
app->setRoot(root);
app->run(); // blocks until quit() is called

Public Attributes

Return	Name	Description
backend::Renderer	renderer	Manages rendering output to the terminal. Provides methods to draw to the screen.
std::function< bool(const core::events::Event &)>	quitEvent	Predicate that decides whether an event should quit the app. Default: Ctrl+C.
utils::InputReader	inputReader
utils::InputParser	inputParser
int	escapeTimer

---

renderer

backend::Renderer renderer

Manages rendering output to the terminal. Provides methods to draw to the screen.

---

quitEvent

std::function< bool(const core::events::Event &)> quitEvent =
      [](/api/const  &e) {
        if (auto *k = std::get_if<>(&e)) {
          return k->key == 'c' && k->modifiers.ctrl;
        }
        return false;
      }

Predicate that decides whether an event should quit the app. Default: Ctrl+C.

---

inputReader

utils::InputReader inputReader

---

inputParser

utils::InputParser inputParser

---

escapeTimer

int escapeTimer = 0

Public Methods

Return	Name	Description
	App	Creates a new App instance and initializes the terminal.
	~App	Destroys the App and restores the terminal.
void	setRoot	Sets the root widget of the application.
void	run	Starts the event loop and blocks until quit() is called.
void	quit inline	Stops the event loop and exits run().

---

App

App()

Creates a new App instance and initializes the terminal.

---

~App

~App()

Destroys the App and restores the terminal.

---

setRoot

void setRoot(std::shared_ptr< core::Widget > root)

Sets the root widget of the application.

The root widget and its children form the widget tree that will be rendered and receive input events. This must be called before run().

Parameters

• root The root widget. Must not be null.

---

run

void run()

Starts the event loop and blocks until quit() is called.

This initializes the terminal, then repeatedly:

• Polls for input events

• Processes them through the widget tree

• Measures and lays out widgets

• Renders to the terminal

Note

This function blocks until quit() is called.

---

quit

inline

inline void quit()

Stops the event loop and exits run().

Can be called from input handlers or callbacks to stop the application.

Private Attributes

Return	Name	Description
std::shared_ptr< core::Widget >	root
backend::Terminal	terminal
std::unique_ptr< backend::Buffer >	buffer
core::Size	currentSize
bool	running
bool	needsRedraw

---

root

std::shared_ptr< core::Widget > root

---

terminal

backend::Terminal terminal

---

buffer

std::unique_ptr< backend::Buffer > buffer

---

currentSize

core::Size currentSize = {0, 0}

---

running

bool running = false

---

needsRedraw

bool needsRedraw = false

Private Methods

Return	Name	Description
void	tick
void	handleResize

---

tick

void tick()

---

handleResize

void handleResize()