Skip to content

refactor(site): redesign <AppearanceSettingsPage /> - #27722

Merged
jakehwll merged 7 commits into
mainfrom
jakehwll/redesign-deployment-appearancesettings
Aug 8, 2026
Merged

refactor(site): redesign <AppearanceSettingsPage />#27722
jakehwll merged 7 commits into
mainfrom
jakehwll/redesign-deployment-appearancesettings

Conversation

@jakehwll

@jakehwll jakehwll commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

🤖 This PR was modified by Coder Agents on behalf of Jake Howell.

  • Redesign Deployment Appearance settings to the standard two-column settings layout (HorizontalForm / FormSection) for branding, with announcement banners as a secondary SettingsHeader + table section (aligned with OAuth2 apps / AI Governance).
  • Demui IconField and reuse it for Logo URL (URL input, preview, emoji picker); thin IconPickerField to wrap the shared component.
  • Clean up announcement banner create/edit (draft-only until save, page-top preview via portal, shadcn Switch / menu icons, empty-state CTA) and clarify Premium paywall copy to cover branding and announcement banners.
Old New
appearancesettings_old appearancesettings_new

@coderagents

coderagents Bot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Documentation Check

Updates Needed

  • docs/admin/setup/appearance.md - The Application Name / Logo URL screenshot (images/admin/setup/appearance/application-name-logo-url.png) no longer matches the UI. The two separate Fieldset cards with per-field Submit buttons are replaced by a single "Branding" form section with one Save button (now a VerticalForm as of 29ab792), and Logo URL now uses IconField (URL input plus preview and emoji picker). Screenshots must be kept current per the screenshot policy.

    ⚠️ Still no documentation changes found in this PR

  • docs/admin/setup/appearance.md - The announcement banners screenshots (announcement_banner_settings.png, and multiple-banners.PNG if it shows the settings table) are stale: the section is now a SettingsHeader + table layout, the per-row enable checkbox is now a Switch, the create button reads "New announcement", and there is an empty-state CTA.

    ⚠️ Still no documentation changes found in this PR

Prose on that page still reads accurately, so no copy changes look required. One optional nit: the page says the application name is "displayed on the login page", while the new Branding helper text says the name and logo appear on the login page and in the dashboard.

No action needed for the rest of the diff (component refactors, portal-based preview, draft-until-save dialog behavior, paywall copy, VerticalForm swap) since it has no documented surface.


Automated review via Coder Agents

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9cb5dfd9d2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +96 to +99
<HorizontalForm
onSubmit={form.handleSubmit}
aria-label="Appearance settings"
className="mt-8"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Add play coverage for the redesigned interactions

The inspected AppearanceSettingsPageView.stories.tsx and AnnouncementBannerDialog.stories.tsx only provide static arguments and have no play functions, while this commit introduces a combined branding submission flow and changes the banner creation, editing, toggling, and validation interactions. Add Storybook interactions that edit and submit the branding form and exercise the meaningful banner flows so these user-visible behavior changes receive the required coverage.

AGENTS.md reference: site/AGENTS.md:L9-L10

Useful? React with 👍 / 👎.

@jeremyruppel jeremyruppel left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

code LGTM! redesign looks good to me as well but I'll leave that approval to our excellent design team

@designertyler

Copy link
Copy Markdown
Contributor

@jakehwll Are the screenshots showing an account with a premium license? I would expect the premium badge to disappear when the account is upgraded or the "Save" and text fields to be disabled if the account doesn't have a premium license. Those screenshots seem to show both states at the same time.

@jakehwll

jakehwll commented Aug 5, 2026

Copy link
Copy Markdown
Contributor Author

@jakehwll Are the screenshots showing an account with a premium license? I would expect the premium badge to disappear when the account is upgraded or the "Save" and text fields to be disabled if the account doesn't have a premium license. Those screenshots seem to show both states at the same time.

These screenshots are completely with a premium license. The badge is still there in licensed situations in the old version.

Old New
appearancesettings_unlicensed_old appearancesettings_unlicensed_new

@linear-code

linear-code Bot commented Aug 6, 2026

Copy link
Copy Markdown

DEVEX-254

Base automatically changed from jakehwll/demui-iconfield to main August 6, 2026 23:56
Resolve conflicts from main in the appearance settings redesign:
- IconField: take main`s merged demui version (#27719).
- IconPickerField: accept main`s removal; call sites already use IconField.
- AnnouncementBannerSettings: keep redesign, update ConfirmDialog import to the migrated Dialog path (#27506).
- AnnouncementBannerDialog: port redesign onto the shadcn Dialog (#27506); render preview outside DialogContent; fix isCreating check.
- AppearanceSettingsPageView: keep redesign layout, adopt main`s PaywallPremium badging and permissions prop (DEVEX-732 #27847).
@jakehwll
jakehwll merged commit ad22526 into main Aug 8, 2026
30 checks passed
@jakehwll
jakehwll deleted the jakehwll/redesign-deployment-appearancesettings branch August 8, 2026 08:03
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 8, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants