Skip to content

EnfonoTech/Form-UI

Repository files navigation

Form UI

Frappe Version 15 and Version 16

Form UI lets you restyle and restructure any desk form without writing code. Rules are created in the Form UI page and applied automatically whenever a form opens.

Installation

cd ~/frappe-bench
bench get-app $URL_OF_THIS_REPO
bench --site YOUR_SITE install-app form_ui
bench --site YOUR_SITE migrate
bench --site YOUR_SITE clear-cache

Hard-refresh the desk after installation (Ctrl+Shift+R).


Global settings — Form UI Settings

Search Form UI Settings in the Awesomebar:

Setting Default What it does
Compact Forms On Reduces vertical spacing so more fields fit on one screen
Freeze Form Header On Keeps the title and Save button pinned while scrolling

Creating rules — Form UI page

Open Form UI in the Awesomebar. Click ╋ New, choose a target, pick a DocType and field(s), set the options, then Save.

Each rule targets one of four element types:

Field

Controls individual input fields.

  • Width and height (drag-resize preview)
  • Field gap (space below the field) and padding (inside the input)
  • Label color, text color, field background color
  • Hover effect: Highlight, Lift, or Glow

Column

Controls a Column Break and its contents.

  • Column width and height
  • Column gap (side padding)

Section

Controls a Section Break and its contents.

  • Force 1–4 columns regardless of how Column Breaks are placed
  • Section padding, gap, background color, border color and radius
  • Collapse by default (section starts collapsed; user can expand)
  • Sticky summary panel (section stays pinned to the bottom while scrolling)

Grid

Controls a child table (e.g. Items, Taxes).

  • Row height
  • Visible rows before the table scrolls internally
  • Hidden columns (comma-separated fieldnames)
  • Sticky grid header

Sidebar

The rule list on the left is resizable (drag the right edge) and collapsible (click ). When collapsed it shrinks to a narrow tab; click to expand it again.


After saving a rule

Save → click (Reload Rules) → reopen the target form. If styles look stale run bench --site YOUR_SITE clear-cache and hard-refresh.


License

MIT — Copyright (c) 2026 Siva (siva@enfono.com)

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors