Problem/Motivation
The new admin theme, based on Gin, has been committed as an experimental theme to Drupal 11.4. This is the roadmap issue to get it to stable and marked as the default admin theme in a future minor release.
Remaining tasks
Stable blockers
- Holy š© there are none!
Blockers if Dark mode setting moves into system module
- #3606655: Allow user-configurable UI settings - starting with dark mode
- #3614864: Adjust CSS for new global dark mode setting per user
Default in standard profile + Umami blockers
Nice to haves
- #3619154: Accessibility fixes for Admin theme's node add/edit sidebar toggle control
- Multiple issues including making it a <button> element, changing accessible name, and removing close button
- #3603162: Consolidate and cleanup media - icons, SVGs and others
- #3578936: Navigation module and Admin theme should use the same Inter font
- #3582352: Clean up admin theme JS
- #3583518: Modernize table sticky header by using position: sticky
- This will fix #3595627: [PP-1] Sticky table header hides responsive tables toggle button
- [Mike G] The focus order issue needs to be fixed (even if we donāt use sticky)
- #3614866: Implement live preview for the dark mode setting in the user profile
- This one is actually postponed until we get the dark mode one in
- #3606582: Implement box-sizing: border-box on :root element
- #3608223: Add entity status formatting to views field
- Jurgenās decision
- [JH] Nice to have
- #3618586: default_admin loses the footer group on forms that set #tree, silently unpublishing entities on save
- #3578834: Add support for "gin_login" directly in the new default admin theme
- [JH] Drupal CMS needs this. Lauri wanted to have it in core. Code is sitting here ready to be put into an MR. Asking Lauri ā¦
- #3619156: Investigate and fix tab order issues on Admin theme's sidebar toggle
- [Mike G] We should certainly fix the focus order, but there are other issues too, right?
Not a blocker
- #3618216: Add automated tests to Default Admin
- #3619426: Sidebar in entity edit forms moves to form bottom if an ajax handler refreshes the form
- [JH] Jurgen filed that, he can demonstrate it, and should be able to fix it.
- [JH] Itās a blocker!!!
- [JH] This is not a blocker as it's not reproducible with core alone. Only reproducible scenario is with ECA that attaches an AJAX handler to a submit button and rebuilds and refreshes the entire form. AJAX handler for field widgets in core are targeted and don't show that issue. Commented in the issue with more details.
- #3619127: Forms sidebar doesn't open with error links from Inline Form Errors module
- There appears to be a dependency on the other issue that KentR is working on. Donāt feel this is a blocker since IFE is not enabled by default
- [Mike G] I do see this as being a blocker if we want to have IFE in core and finally moving from an experimental module. Core is changing a lot though, soā¦.
- [Mike H] Itās a blocker for IFE in core, but not Admin theme being stable
- #3619387: Indicate on forms sidebar toggle button that sidebar has child element errors
- Same as above: There appears to be a dependency on the other issue that KentR is working on. Not a blocker since core doesnāt have this anywhere yet
- [Mike G] I feel the same way as #1 above.
- #3604037: Indicate that grouping elements have child element errors for UX and a11y
- Another KentR issue for the same exact stuff
- [Mike G] All technical debt left over from D8, but yes, same as 1 & 2.
- #3619153: Admin theme's collapsed / hidden sidebar should be operable without JavaScript
- [Mike G] not a blocker
- #3497077: dropdown buttons are broken with Javascript disabled
- JS is expected
- [Mike G] not a blocker
- #3614876: Clean-up libraries-overrides in default_admin.info.yml
- [Mike G] probably.. Not my expertise.
- [JH] Iād say this needs to be done, itās really technical debt and who knows which side-effects we just donāt know yet
- #3585823: [Meta] Improve the accessibility of the Default Admin theme
- [Mike G] I would like to say all of the Major Priorities and Color Contrast are blockers
- #3618760: Tables can have too much horizontal whitespace
- [Mike G] Not a blocker.
- #3236439: Use warning icon for obsolete and deprecated modules on admin/modules in Claro
- Benji wants to use an icon in places
- #3594809: Do not use toggle switches for checkboxes on forms that require submission
- I donāt even agree with this.
- [Mike G] Why donāt you agree with this? But also I donāt see this as a blocker. I see it as a semantic improvement, not a barrier.
- #3612243: List of popular contrib modules that need to be updated to support Admin theme's dark mode
- [Mike G] How could this be a blocker? Weāll add to them as we test modules?
- #3593539: [PP-1] Replace compact mode link with a switch to improve accessibility
- [Mike G] Nice to have semantic improvement, not a barrier
- #3584305: Default admin theme settings are broken when another administration theme is active
- This is a valid issue, but the use case is very rare
- #3582351: [Meta] Clean up CSS within Admin theme
- [Mike G] Cleanup will save us all time in the implementation.
- #3616502: default_admin: Check if certain colors can an be built from variables to allow easier overrides
- Minor CSS cleanup
- [Mike G] Would help
- [JH] Should we hide the focus color selection in the theme settings until it works properly?
- #3616500: default_admin: Create order to gray primitive CSS variables
- Minor CSS cleanup
- #3615107: Render the vertical tabs widget server side to eliminate the flash of untransformed content
- [JH] Sounds like really bad UX, and since it comes with an MR, probably an easy fix
- #3583486: Adjust default_admin's top bar to the landmark used with the navigation module
- [Mike G] Seems like a pretty simple change.
- #3609023: Darkmode bug navigation
- This is a navigation module bug where when reorganizing the navigation panels in dark mode, the background is white.
- [Mike G] Seems like a bad dark mode implementation - Iād call it a breaker
- [JH] should be redundant if navigation works without layout_builder
- #3601095: Search on Permission page unusably poor performance
- Migrated from Gin. We need a way to test this.
- [Mike G] Aside from the irony of performance issues on a performance page, isnāt there a performance gate we should be building to?
- [JH] Not a performance page, itās permissions. And this can be tested if a site has hundreds of permissions. Caused by JS which disables all roleās checkboxes when auth role is checked
- #3582162: Remove or limit the clobbering of Node breadcrumbs
- We need to decide if we even want to do this
- #3577737: Layout shift in Claro admin tables when Ajax progress indicator is injected in dropbutton cell
- [Mike G] Havenāt noticed it
- [JH] Weāre having this in Gin as well, and every attempt to fix it caused even more terrible side-effects. However, Mike Hās cleanup phase 1 seems to have fixed that (by accident?), as I canāt reproduce it anymore either.
- #3576488: [meta] Admin theme: path to beta and stable
- #3592061: List of visual differences between Gin & Admin theme
- #3557411: Add documentation for themeRegistryAlter in Admin theme
- Jurgenās decision
- [JH] This impacts, if anything, only contrib. Back when we migrated Gin, nobody knew what that code did and we removed it. Feels almost like we can āforgetā it, otherwise we need to do some research.
- #3611424: Status report counter "Details" link has hidden text before visible
- Not sure how to reproduce
- #3618405: Purpose of views exposed filters form is unclear when zoomed in
- Old Gin Issues First Set & Second Set
- [Mike G] Do we know if weāve gone through all of these?
- [JH] My take is that default_admin has diverged from Gin to an extent where those lists donāt seem to be relevant anymore. We should get more out of testing default_admin as is.
Completed
#3618140: Improve the accessibility of focus outlines
#3622541: Add missing claro/classy templates to Admin theme
#3506333: Improve the perceptibility of contextual link buttons
#3605702: Remove remaining Gin and Claro implementation names from Default Admin theme
#3619804: Remove unused templates from the Admin theme
#3621981: Remove admin-custom.css
#3584301: Update documentation for Default admin theme
#3618215: Documentation for Admin theme
#3617890: Create documentation guide for new Admin theme
#3619155: Forced-colors problems with admin theme's sidebar toggle button
#3617875: Better Dark Mode Support for Disabled Elements
#3618127: Navigation top bar action buttons in dark mode have low color contrast
#3619688: Button misaligned in exposed filters within Admin theme
#3615331: Invalid ARIA attribute aria-toolbar-link__labelledby on toolbar menus strips their accessible name
#3580733: Views status field triggers a PHP 8.5 deprecation on /admin/people
#3576431: Mark new admin theme as experimental
#3576646: Rename Gin-based admin theme
#3576874: Toggle switches are visually broken within dialog modals
#3581831: Remove support for Book and Forum Module
#3582018: Remove or move the uses of classy templates in default admin theme
#3582169: Cleanup cspell ignores in Admin
#3582178: Remove dead code in Admin
#3590364: Part 2 of Consolidate, refactor, remove and untangle Claro's CSS from Default Admin theme
#3590897: Sidebar toggle is visible and functioning in media library dialog, but shouldn't be there
#3599680: Consolidate, merge, and refactor Gin's CSS variable's into Admin theme's original variables.
#3587668: Apply to selected items button has low contrast
#3619512: Remove custom weights from default_admin.libraries.yml
#3612323: Do not use strong element for vertical tabs titles
#3621244: Navigation mobile sidebar close button in dark mode has low color contrast
#3623388: Details summary summary has low contrast
#3621109: Skip link in dark mode has low color contrast
#3623097: Remove remaining Gin and Claro implementation names from Default Admin theme, part 2
#3583516: Breadcrumb separators are exposed to the accessibility tree
#3623385: Admin theme's status report styling is off
#3623407: Broken tabledrag UI when uploading multiple files in Admin theme
Comments
Comment #2
longwaveComment #3
catchComment #4
rkollerComment #5
jurgenhaasAdded 2 more child issues.
Comment #6
catchComment #7
penyaskitoComment #8
quietone commentedComment #9
quietone commentedBecause there is support for the Book module I searched for other deprecated extensions. There are results for "classy", "contact" and "forum".
Comment #10
catchThe classy templates date from when classy was removed from core and the templates were copied to all of the core themes, so probably came from Claro originally, but e.g. I'm pretty sure the admin theme doesn't need to override the node template, nodes generally won't get rendered in the admin theme at all, and it probably doesn't have styling based on it either. So we probably need an issue to try deleting those templates where we can, or moving them out of the classy folder if they need to stay. Forum templates can just be deleted entirely though. So may one for templates from deprecated/removed modules and one for the other classy templates?
Comment #11
quietone commentedThese are the child issues for the last comment.
#3581831: Remove support for Book and Forum Module
#3582018: Remove or move the uses of classy templates in default admin theme
Comment #12
quietone commentedComment #13
quietone commentedComment #14
jurgenhaasComment #15
quietone commented@jurgenhaas, I see my issue summary updates were removed. What was wrong with them?
Comment #16
jurgenhaas@quietone I'm so sorry. Nothing was wrong with them. I had added the 3 new issue references and did that in a browser tab that was open for a couple of days, not realizing that there had been updates to it that I didn't have in my open tab yet.
I've restored your changes, I hope I got them all right.
Comment #17
quietone commentedComment #18
kentr commentedComment #19
quietone commentedComment #20
poker10 commentedComment #21
kentr commentedCreated #3585823: [Meta] Improve the accessibility of the Default Admin theme for copying Gin issues into, and updated the IS.
Comment #22
quietone commentedComment #23
quietone commentedAnother issue completed
Comment #24
mherchelWorking with @jurgenhaass and @mgifford and @bernardm28 on a call to discuss this.
In a Slack discussion with core product managers, they want this beta level in three weeks (11.4) and stable by 12.0 (December)
https://drupal.slack.com/archives/C7AB68LJV/p1779785392682889
Comment #25
mherchelComment #26
mherchelComment #27
quietone commentedComment #28
mherchelComment #29
mherchelComment #30
mherchelComment #31
mherchelComment #32
mherchelComment #33
quietone commentedAdded two issues for items in the 'Stable blocker' section.
Comment #34
quietone commentedComment #35
quietone commentedComment #36
quietone commentedStable blocker in, #3614911: JS aggregation returns 400 for libraries loaded in the header only as dependencies
Comment #37
mherchelMet with @jurgenhaas and @mgifford this morning over Zoom. We triaged all the issues.
Comment #38
kentr commentedThis issue is listed under the "Not a blocker" section (item 26 in the list). I assume that's an error, but I'm not familiar enough to be certain.
Comment #39
mherchelComment #40
mherchelComment #41
mherchelComment #42
mherchelComment #43
mherchelComment #44
catchI think we need issues (maybe under a separate meta?) to use default_admin in the standard profile + umami. If we have that meta, I'd also move the installer issue under that - those issues are blocked by default_admin being stable rather than the other way around.
Comment #45
mherchelI'll break these out a bit more later today
Comment #46
mherchelComment #47
mherchelComment #48
mherchelComment #49
mherchelReorganizing done!
10 stable blockers!
Comment #50
mherchelDown to 8 stable blockers!
Comment #51
mherchelDown to 7! Fixed a BIG one with #3605702: Remove remaining Gin and Claro implementation names from Default Admin theme
Comment #52
catchI don't think #3580137: Document sub-theme behavior and theme settings inheritance should be a stable blocker, we don't have a full write-up for Claro after several years on this policy, so why would it be a blocker now?
Also I think it would be good to define what the actual scope is of #3618216: Add automated tests to Default Admin we can always add more test coverage of everything, are there specific, critical things missing test coverage?
Comment #53
quietone commentedComment #54
quietone commentedI was looking into the deprecation of Claro and found that there are 16 instances of 'claro' in Default Admin.
Comment #55
catchThat should be dealt with in #3605702: Remove remaining Gin and Claro implementation names from Default Admin theme which is only in main so far - does that mean it missed more references or were you looking prior to that landing?
Comment #56
quietone commentedI just built a new test setup and yes, the same results as above on main. And it is the same result on 11.x
Comment #57
quietone commentedReading this comment, maybe accent.pcss.css should be data-accent.pcss.css?
Comment #58
quietone commentedAdded #3621981: Remove admin-custom.css which is blocking the deprecation of Claro. And moved the doc issues to completed
Comment #59
quietone commentedComment #60
catch#3618971: Use Admin theme in installer is in. I think we need an equivalent issue for Umami still
#3587668: Apply to selected items button has low contrast under blockers is 'needs more info now' - should that be moved to nice to haves / needs triage?
For the record I don't think #3580137: Document sub-theme behavior and theme settings inheritance should block stable, it's more of a policy decision and doesn't actually affect functionality at all.
That leaves two accessibility issues, one form bug, and tests. It's not clear to me what the scope of the testing issue is for stable blocking. There are issues switching/copying claro testing over to default_admin which should be adding some implicit testing at least.
Comment #61
kentr commentedThe theme also has some tests currently, and I'm adding tests in some issues.
Comment #62
kentr commentedIt's outdated. Moved to completed (title also changed).
Comment #63
mgiffordComment #64
quietone commentedComment #65
catchComment #66
poker10 commentedUpdating IS, as #3605702: Remove remaining Gin and Claro implementation names from Default Admin theme is not fully fixed.
Comment #67
quietone commentedComment #68
smustgrave commentedFew small ones landed.
Comment #69
mherchelComment #70
mherchelRemoving #3580137: Document sub-theme behavior and theme settings inheritance, since it is not a bug specific to the Admin theme.
Comment #71
mherchelComment #72
smustgrave commented#3621244: Navigation mobile sidebar close button in dark mode has low color contrast landed
Comment #73
mherchelAdding #3623385: Admin theme's status report styling is off as a stable blocker. Should be an easy fix.
Comment #74
kentr commentedAdded #3623388: Details summary summary has low contrast to blockers because my understanding is @mgifford considers all color contrast issues to be blockers.
Comment #75
mherchelAdded #3623407: Broken tabledrag UI when uploading multiple files in Admin theme to blockers
Comment #76
jurgenhaasMoved #3619426: Sidebar in entity edit forms moves to form bottom if an ajax handler refreshes the form out of blockers into "Not a blocker". Explanation and details in an issue comment there.
Comment #77
smustgrave commentedComment #78
smustgrave commentedComment #79
gƔbor hojtsyComment #80
smustgrave commentedComment #81
smustgrave commentedComment #82
smustgrave commentedComment #83
gƔbor hojtsyRemove superflous info from summary.
Comment #84
smustgrave commentedComment #85
mherchelComment #86
mherchelComment #87
jurgenhaasMoved the tests #3618216: Add automated tests to Default Admin out of blockers as discussed and agreed in Slack with @mherchel, @catch, and @longwave
Comment #88
mherchelš
Comment #89
kentr commentedAnother color contrast issue for blockers: #3629776: View edit page buttons have low contrast
Comment #90
mherchel@kentr Admin is already stable. We can knock this out soon, but there are no more stable blockers FYI.
Comment #91
catch@kentr we marked default_admin stable in #3624359: Remove "lifecycle: experimental" from Admin's info.yml for the 11.5.x and 12.0.x branches, when we reached zero known blocking issues here.
This was also a necessary step for moving Claro to contrib so that we don't have two admin themes in core until 2030 (we'll already be supporting Claro until 2028 in Drupal 11, at least for security, even if no longer really fixing most bugs in the core version).
Newly found accessibility issues can still be prioritised, and we still have six weeks until 12.0.0/11.5.0 is out to fix them before default admin is stable in a stable core release.
Comment #92
kentr commentedI removed that one I added from the IS.