Skip to content

docs(responsive-widgets): Custom styling section and scoped custom CSS - #3103

Merged
sebastianiv21 merged 7 commits into
mainfrom
agent/docs-asm-96-responsive-custom-styling
Nov 17, 2026
Merged

sebastianiv21 merged 7 commits into
mainfrom
agent/docs-asm-96-responsive-custom-styling

Conversation

@sebastianiv21

Copy link
Copy Markdown
Contributor

What

Documents the Custom styling section that every responsive widget has, and its scoped Custom CSS setting.

  • New page: reference/responsive-widgets/custom-styling, listed first under Responsive Widgets in the sidebar and linked from the overview. It covers each setting (Accent color, Background, Text color, Border color / Line color, Border width, Corners, Custom CSS), From theme vs theme color vs custom color, gradients, the 4.5:1 contrast warning, a matrix of all widgets × settings × styled part, and the Custom CSS rules: what is removed, focus rings, the Show without custom CSS recovery command, the admin switch, and the MCP restriction.
  • All 62 widget pages that have settings get a ### Custom styling block under ## Style properties, listing only that widget's settings and linking to the shared page. Pages without a Style section get one.
  • table.md: the old ### Custom CSS block moves under Custom styling with Accent color. The class list adds .anvil-table__card.
  • section.md, stats.md: Background (and Stats Border color) move from General into Custom styling. The gradient examples stay.
  • heading.md, paragraph.md: Text color moves from Text formatting into Custom styling.
  • custom.md: one line on why the Custom widget has no Custom styling section.
  • Toolbar Buttons, Inline Buttons, FAB, Select, ComboBox: one line each on why there is no Custom CSS.

Source

Documents what release ships now, which covers these PRs:

Checked against appsmith-ee release at 34c331799b:

  • app/client/src/widgets/wds/shared/customStyling/declarations.ts: settings, styled parts, gradient types, linked properties
  • app/client/src/widgets/wds/shared/customStyling/propertyPaneSection.ts, customStylingStyles.ts, colorValidation.ts, themeTokens.ts: labels, options, theme swatches, defaults
  • app/client/src/ee/constants/messages.ts (ANVIL_CUSTOM_STYLING, ANVIL_WIDGET_CUSTOM_CSS, ANVIL_THEME_ADMIN): UI text
  • app/client/src/widgets/wds/shared/scopeCss.ts, customCss/*: what custom CSS removes, limits, containment
  • app/client/src/layoutSystems/anvil/editor/CommandPalette/useAnvilCommands.ts: recovery command
  • app/client/src/ee/selectors/customCssSelectors.ts: admin switch default
  • app/client/packages/mcp/src/ee/anvil/props.ts: MCP cannot set customCSS

Checks

  • A scratch script (not committed) compares the matrix and every page's Custom styling block against declarations.ts on release. Before the change: 63 differences. After: 0 differences (63 pages, 65 declared types. WDS_TABLE_WIDGET and WDS_AI_CHAT_WIDGET have no page and match Table and Chat).
  • grep -L "### Custom styling" over the folder returns only README.md, custom.md, and the new custom-styling.md page itself.
  • Custom CSS appears on 57 widget pages, which is the 59 declaring types minus the 2 types without a page.
  • npm run build in website/: passes. None of the existing broken-anchor warnings involve the changed pages.
  • vale on all 65 changed files: no errors.

TODO

  • <!-- TODO(screenshot): Custom styling section of an Input widget in the Style tab --> on custom-styling.md. The local docs instance could not start (Docker was not running), so the PR adds no images.
  • The admin switch links to the general Admin Settings page. When the Responsive app theme admin page from ASM-97 is published, point the link there.

🤖 Generated with Claude Code

Add a shared Custom styling reference page and a Custom styling block on
every responsive widget page, matching CUSTOM_STYLING_DECLARATIONS on
appsmith-ee release (appsmithorg/appsmith-ee#10504, #10526, #10543).

- New page reference/responsive-widgets/custom-styling: settings, theme
  colors vs custom colors, gradients, contrast warning, the settings
  matrix, and the Custom CSS rules, recovery command, admin switch, and
  MCP restriction.
- Table: Custom CSS moves under Custom styling with Accent color, and the
  class list adds .anvil-table__card.
- Section, Stats, Heading, Paragraph: Background, Border color, and Text
  color move from their old groups into Custom styling.
- Custom: one line on why it has no Custom styling section.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: multica-agent <github@multica.ai>
@vercel

vercel Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
appsmith-docs Ready Ready Preview Nov 17, 2026 1:39pm UTC

Request Review

…pe, CSS target

Adds the facts from appsmithorg/appsmith-ee#10526 that the Custom styling
page did not yet state:

- Accent color: the two-tone focus ring below 3:1 contrast, where it is
  measured, and that other widgets and fixed-layout apps are unchanged.
- Text color: the exact low contrast message, that it shows only on
  widgets with a Background setting, what gives no warning, and the
  mixed theme/custom pair note.
- Settings by widget: controls and fields name the Custom CSS target as
  the box around the widget.
- Custom CSS: paint up to 8px past the widget box, the rest is clipped.

Source: appsmith-ee release (propertyPaneSection.ts, AnvilColorControl.tsx,
accentPalette.ts, useAccentTokenScope.ts, containment.ts, messages.ts).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: multica-agent <github@multica.ai>
sebastianiv21 and others added 2 commits November 16, 2026 17:37
- Theme color values for code: list the valid token:<name> values per
  setting; token:accent is not valid for Accent color.
- Accent color: an empty value inherits the nearest container's accent.
  A custom accent is rebuilt per mode.
- Custom CSS: & is the box around the widget, except Table, Card, Modal
  and Sheet. Same fix on the widget pages.
- Gradient builder labels, Solid behavior, contrast check with theme
  colors and the mixed-pair note, browser check wording.
- Stats wording, Table anchor, and no custom CSS mention on widgets
  without Custom CSS.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: multica-agent <github@multica.ai>
Keeps the focus ring, contrast warning, matrix target column, and 8px
paint wording from 0c54f83. The Custom CSS "&" bullet now says that on
most widgets & is the styled part, and on controls and fields it is the
box around the widget. That matches the wrapper style sheet, where
surface, card, frame, text, and line parts are the wrapper's child. The
widget pages keep their target-specific & wording.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: multica-agent <github@multica.ai>
…r note

Fixes Reviewer findings on ASM-98: the outer focus ring check also runs for theme colors, and the mixed-pair note shows whatever the contrast.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: multica-agent <github@multica.ai>
sebastianiv21 and others added 2 commits November 17, 2026 10:28
# Conflicts:
#	website/docs/reference/responsive-widgets/README.md
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@sebastianiv21
sebastianiv21 marked this pull request as ready for review November 17, 2026 13:40
@sebastianiv21
sebastianiv21 merged commit e766b7d into main Nov 17, 2026
5 checks passed
@sebastianiv21
sebastianiv21 deleted the agent/docs-asm-96-responsive-custom-styling branch November 17, 2026 13:41

This branch was successfully deployed

1 active deployment
Preview — e957ec5c Deployed Nov 17, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant