rushikeshmalgan/brocode

Purpose and Runtime

broCodes is a Bun/TypeScript monorepo containing a terminal CLI application. The application is implemented with TSX-based terminal UI components and launched from packages/cli/src/index.tsx; package/runtime metadata is in package.json and packages/cli/package.json.

Application Entry and Composition

packages/cli/src/index.tsx is the CLI entry point and root render/bootstrap boundary. It composes the terminal screen from primary layout components:

• packages/cli/src/components/header.tsx

• packages/cli/src/components/input-bar.tsx

• packages/cli/src/components/status-bar.tsx

packages/cli/src/components/border.tsx provides the shared visual framing primitive around terminal regions.

Provider Layer

The provider hierarchy centralizes cross-cutting application state and behaviors before UI components consume them. packages/cli/src/providers/index.tsx is the aggregation boundary for:

• Dialog state and dialog rendering: packages/cli/src/providers/dialog/index.tsx

• Keyboard event handling/shortcut dispatch: packages/cli/src/providers/keyboard-layer/index.tsx

• Theme selection and propagation: packages/cli/src/providers/theme/index.tsx

• Toast contracts: packages/cli/src/providers/toast/types.ts

This separates global interaction state from the screen-level component tree.

Command Menu Flow

The command menu is the main action-discovery and command-selection subsystem. packages/cli/src/components/commands-menu/index.tsx hosts the menu; commands are defined in packages/cli/src/components/commands-menu/commands.tsx, filtered through packages/cli/src/components/commands-menu/filter-commands.ts, and controlled by packages/cli/src/components/commands-menu/use-command-menu.ts.

Control flow is keyboard/input driven: keyboard-layer events open or navigate the menu, filtering narrows the command collection, and command selection invokes application actions such as opening dialogs or changing UI state.

Dialog and Search Boundaries

Modal interactions are modeled independently from the base screen. packages/cli/src/components/dialogs/index.tsx selects or renders concrete dialogs, including packages/cli/src/components/dialogs/theme-dialog.tsx. Dialog state is mediated through packages/cli/src/providers/dialog/index.tsx and its typed contract in packages/cli/src/providers/dialog/types.ts.

packages/cli/src/components/dialog-search-list.tsx is a reusable search/list interaction surface, likely shared by dialog-like selection experiences such as theme selection and command discovery.

Theme System

Theme data is defined at packages/cli/src/theme.ts; the theme provider at packages/cli/src/providers/theme/index.tsx owns active-theme state and makes it available to terminal UI components. The theme dialog provides the user-facing mutation path, creating a clear flow: command or keyboard action → dialog provider → theme dialog → theme provider → rerendered components.

Infrastructure and External Boundaries

The repository uses Bun, indicated by bun.lock, with TypeScript project configuration shared through tsconfig.base.json and specialized in packages/cli/tsconfig.json. No backend service, database, HTTP client, or external API integration is present in the supplied tree; the architectural boundary is a local, interactive terminal process.