Roadmap

Jump to bottom

Karanjot786 edited this page Jun 1, 2026 · 3 revisions

Roadmap

This page shows where TermUI is and where it is going. Use it to pick work that fits your skill level.

Current state (v0.1.x)

TermUI ships a working core today:

Layout engine with flexbox rules
Differential renderer (only changed cells redraw)
JSX runtime and React-style hooks
13 packages, 600+ tests passing
Theming, animations, routing, hot-reload dev server
Capability detection with ASCII fallback

How the roadmap is organized

Work is grouped into waves. Each wave is a set of issues you can claim independently.

Wave	Focus	Status
Wave 1	Core widgets (Badge, Table, charts, progress)	Merging now
Wave 2	Beginner core capabilities and adapters	Open
Wave 3	Intermediate hooks, prompts, rendering	Open
Wave 4	Advanced layout, registry, templates	Open

By difficulty

Pick based on your experience.

Beginner

Single file. Clear spec. 1 to 2 tests. Good first contribution.

Env var support, typed errors, store helpers
New display widgets
Library adapters (Conf, Commander, Chalk)

Browse: good first issues

Intermediate

Multiple files. Requires reading the architecture.

Incremental and live renderers
Validation, typeahead, virtual rows
Prompts: Sort, Snippet, Editable
Theming and event delegation

Advanced

Multi-file. Design judgment. Sometimes splits across PRs.

Border merging, constraint-based layout
Component registry and CLI add command
Main-screen and inline viewport modes
App templates

Future direction

These come after the current waves land:

Mouse support (hit-grid architecture, RFC open)
Component registry (shadcn-style, RFC open)
AI widget suite (ChatThread, ToolApproval, TokenUsage)
Accessibility metadata for screen readers

Read the open RFCs to shape these before code starts:

How to pick work

Open the project board.
Filter by level:beginner, level:intermediate, or level:advanced.
Read the issue. Comment "I would like to work on this".
Wait for assignment, then open your PR within 7 days.

Found a gap not on the roadmap? Open a new issue. New ideas are welcome.