This directory contains the active planning docs for frappe-ui v1.
plan.md- Main source of truth for scope, blockers, component direction, data migration, TextEditor, and release gates.
migration.md- Pointer to the published migration guide at https://ui.frappe.io/docs/migration (source:
docs/content/docs/migration.md). Per-component before/after tables for app teams upgrading to v1.
- Pointer to the published migration guide at https://ui.frappe.io/docs/migration (source:
changelog.md- Rolling v1 changelog for consumer-facing changes, deprecations, and migration notes.
04-components-audit.md- Core component audit matrix for TS,
<script setup>, docs, stories, and tests.
- Core component audit matrix for TS,
08-selection-and-menu-api-spec.md- Accepted API direction for Dropdown, Select, Combobox, MultiSelect, and ItemListRow.
08f-dialog-spec.md- Accepted API direction for
Dialogand the imperativedialog.confirm/alert/promptnamespace. Covers flat-prop migration, slot rename, thebarechrome toggle,dismissible, and the caller-controlled-close lifecycle for imperative helpers.
- Accepted API direction for
09-input-components-spec.md- Accepted API direction for the input family: TextInput, Textarea, Password, Checkbox, Switch, Rating, Slider, and ErrorMessage. Covers the shared labeling contract, size/variant scales,
defineModelpattern, and deprecation warnings. FileUploader is out of scope and addressed in a separate spec.
- Accepted API direction for the input family: TextInput, Textarea, Password, Checkbox, Switch, Rating, Slider, and ErrorMessage. Covers the shared labeling contract, size/variant scales,
research/07-selection-components-usage-audit.md- Bench-wide usage audit that informed the selection/menu API spec.
research/09-input-components-usage-audit.md- Bench-wide usage audit that locked the parked decisions in the input-components spec.