Roadmap

A living view of where FlaUI for Python is, what is shipped, what is in flight, and what is parked for after v1.0. It mirrors the GitHub milestones and issues — those remain the source of truth; this page is the human-friendly summary.

How to read this

✅ Done 🚧 In progress 🗓️ Planned 💡 Wishlist (post‑v1)
Each item links to its tracking issue or milestone where one exists.

Status at a glance

Milestone	Theme	Status
Initial release	FlaUI 4 + PythonNet 3 prototype, packaging, PyPI plumbing	✅ Complete
Phase 1 — Exceptions & Identifiers	Pythonic exceptions, identifier system	✅ Complete
Phase 2 — Patterns	35+ UIA control patterns	✅ Complete
Phase 3 — Elements & ScrollBars	Element wrappers, scrollbars	✅ Complete
Phase 4 — Events	Event handler system, automation events	✅ Complete
Phase 5 — Capturing/Overlay/Video	Screenshots, overlays, video recording	✅ Complete
Phase 6 — Logging/Tools/Enhancers	Logging bridge, tools, Pythonic enhancers	✅ Complete
Phase 0 — Stabilize	Green CI, stable matrix, 100% core coverage	🚧 In progress
Phase 7 — Docs & Zensical	v1 docs, per-framework guides, API reference	🗓️ Planned
Phase 8 — Polish & v1.0	Release plumbing, beta soak, v1.0.0	🗓️ Planned

✅ Completed

Foundation & packaging

PythonNet bridge and bundled FlaUI DLLs
Upgrade to FlaUI 4/5 + PythonNet 3
Pydantic-backed AutomationElement models
uv-based packaging and PyPI publishing plumbing
Python 3.10–3.14 support
Python AutomationBase + UIA2/UIA3 facades (#107)

Core API surface (1:1 with FlaUI)

CI & docs platform

Migrate Windows UI CI from AppVeyor to a hybrid Azure Pipelines + AppVeyor setup (#118)
Zensical documentation site with auto-generated API reference (mkdocstrings)

Phase 6 — Enhanced Python integration (#87)

__repr__ on elements
Context-manager support for Application / Automation (with auto-dispose)
Iterator/collection protocol on element results (AutomationElementCollection with .first, .filter, .where, indexing/iteration)
Fluent waiting + Playwright-style assertions (expect(el).to_be_visible(), flaui/core/expectations.py)
py.typed marker + ty (Astral) type-check gate in CI

🚧 In progress

Phase 0 — Stabilize (milestone)

Achieve ~90–95% flaui.core coverage + enforce a coverage gate (#88)
Spinner AutomationID flakiness (#74) — harden locator
Tree-item flakiness on CI (#76) — wait for items to materialize
test_get_control_type setup flakiness (#82) — harden fixture
find_all/first_with_options matrix failures (#80) — investigate TreeTraversalOptions
ListBox.select_by_index on UIA3/WPF (#83) — fix selection
Notepad tests on Windows 11 Store app (#89) — environment guard
Document upstream Windows/.NET limitations — ComboBox/WinForms (#75), Toggle on WinForms menus (#78), UIA3 WinForms context menus (#79)

🗓️ Planned

Phase 7 — Docs & Zensical (milestone)

Phase 8 — Polish & v1.0 (milestone)

💡 Wishlist (post‑v1)

CustomNavigation pattern (#121)
UI recorder / codegen (inspired by FlaUIRecorder & Playwright codegen)
Reference MCP server / agent-tool example exposing element find/click/type as tools (see Use with AI agents)
Async / pytest-asyncio ergonomics evaluation
Enhanced HTML/Allure reporting helpers

Maintainers: keep this page aligned with milestones as phases close. It is linked from the site nav and is intended as the at-a-glance overview of overall scale.