Problem/Motivation
Claro is being deprecated and it is used as the install theme.
Steps to reproduce
N/A
Proposed resolution
Change the install theme to 'default_admin'
Remaining tasks
Review
User interface changes
Before - with Claro

After

Introduced terminology
N/A
API changes
N/A
Data model changes
N/A
Release notes snippet
N/A
| Comment | File | Size | Author |
|---|---|---|---|
| #42 | Screenshot 2026-09-09 at 6.13.43 PM.png | 189.42 KB | godotislate |
| #42 | Screenshot 2026-09-09 at 6.13.53 PM.png | 101.58 KB | godotislate |
| #42 | Screenshot 2026-09-09 at 6.13.01 PM.png | 123.24 KB | godotislate |
| #42 | Screenshot 2026-09-09 at 6.12.52 PM.png | 76.81 KB | godotislate |
| #42 | Screenshot 2026-09-09 at 6.12.27 PM.png | 55.81 KB | godotislate |
Issue fork drupal-3618971
Show commands
Start within a Git clone of the project using the version control instructions.
Or, if you do not have SSH keys set up on git.drupalcode.org:
- 3618971-11-x
changes, plain diff MR !17071
- 3618971-use-admin-theme
changes, plain diff MR !16845
Comments
Comment #2
catchMoving this to the admin theme and bumping priority.
Comment #5
jurgenhaasI've started with an MR and covered the installer, the default settings, tests, and also a couple of default_admin methods that worked under the assumption that a database or the config system would be available, which is not during the installation of Drupal.
Comment #6
needs-review-queue-bot commentedThe Needs Review Queue Bot tested this issue. It fails the Drupal core commit checks. Therefore, this issue status is now "Needs work".
This does not mean that the patch necessarily needs to be re-rolled or the MR rebased. Read the Issue Summary, the issue tags and the latest discussion here to determine what needs to be done.
Consult the Drupal Contributor Guide to find step-by-step guides for working with issues.
Comment #7
jurgenhaasI've addressed and fixed the test failure and also the bot report. Back to NR.
Comment #8
gábor hojtsyHow does this look like? Claro has special styling for this with the arrow steps, etc.
Comment #9
quietone commentedScreenshot added. And yes, the styling needs work.
Comment #10
acbramley commentedComparing this with the installer on main, it definitely needs work to address the styling issues.
Comment #11
gábor hojtsyThanks for the super quick technical turnaround @jurgenhaas. Looking at the screenshot, while its intended to look new and "default admin-like" (ie potentially not the arrows Claro had), it should still look not broken. :)
Comment #12
jurgenhaasSure thing. There is an explicit installer css file already available in default_admin, we need to adjust this to the latest markup.
Comment #13
quietone commentedJust a 'before' screenshot.
Comment #14
mherchelI'll put in some time on this today
Comment #15
mherchelThis is caused by an incorrect root CSS selector within the variables files. I was using
.rootinstead of:rootI'll do this in a separate issue, though, so I can backport.
Comment #16
mherchelOpened #3619253: Admin theme's CSS variable selector incorrectly uses .root instead of :root to get this resolved and pinged a few people to make the change & RTBC so I can get it committed (and backport it) ASAP
Comment #17
jurgenhaasThe CSS is fixed and a manual test shows that it now looks as expected. Further down in the install process, it fails with this:
But that's not from this MR. Main currently fails with the same exception.
Comment #18
godotislate@jurgenhaas can you provide more details or a screenshot? I just tried an install via UI on
mainand did not see that exception.Comment #19
jurgenhaas@godotislate sure. I'm
composer reinstall drupal/coreand getInstalling drupal/core (dev-main 223bbbb): Extracting archive.Then I install the site in the UI or with
drush si, and get the same error as posted in #17. This happens with or without the MR applied. Here is how that looks:Comment #20
jurgenhaasJust saw there is also the stack trace, if that helps:
Comment #21
godotislate@jurgenhaas is ECA in your codebase? Could it be related or similar to https://git.drupalcode.org/project/eca/-/work_items/3588862?
Comment #22
jurgenhaas@godotislate good call, and yes ECA was there. But after removing it, deleting the database, and rebuilding all docker containers to flush APC et al, the problem is still the same. Let me quickly try by removing all contrib modules ...
No luck, removed all contrib code and still get the same issue.
Comment #23
godotislateI'm still unable to reproduce. But to get back on-track, if anyone else can reproduce, let's open a separate issue.
Comment #24
jurgenhaas@godotislate OK, must be something else at my end. I've started on a fresh environment and there I can't reproduce the error. As soon as I add a bunch of composer packages from our dev environment, it starts failing again. I'll investigate what exactly is going on. Nothing to do with this one here.
So, I've now manually tested the install and it looks good end-2-end. Just the nightwatch test in the pipeline failed. Shall we get that green first or do you want to review this first?
Comment #25
jurgenhaasLooks like I missed the references in the install profiles. Should they be switched from Claro to Default Admin as well? I guess so. But waiting for a confirmation before getting into this.
Comment #26
catch@jurgenhaas which install profiles do you mean?
We need an issue to switch umami's admin theme to default_admin, and another one for standard - although standard probably needs a stable or at least release candidate default_admin before we switch that.
Comment #27
mherchelJust merged #3619253: Admin theme's CSS variable selector incorrectly uses .root instead of :root. Verified it looks good.
One thing that happened to me is after the install process was complete, it landed me on a 404 page.
When I went to
/admin, I received the following errorI this related? Setting to NW just in case.
Comment #28
acbramley commentedTested the install screen after pulling the latest changes and it's looking great.
The requirements screen doesn't look great, but it's basically the same as Claro:
The batch process screen looks good.
After finishing the install I was successfully taken to the welcome page, no errors or anything on my end.
Comment #29
quietone commentedYes, this is looking much better. However, the install fails for me. I get the following message with a 'try again' button.
Comment #30
mherchel@quietone - yeah that looks like what happened to me.
@jurgenhaas - let me know if you want to troubleshoot at some point.
Comment #31
jurgenhaasI'm in a chat with @catch over in #core-maintainers related to another issue and he reported about a 404 when he tried to uninstall the profile, which is what happens at the end of the site install nowadays. So, that sounds like the same issue. If so, then it's unrelated to this MR. I'll try to verify this.
Comment #32
jurgenhaasI've just tested this and can't reproduce. It works for me without 404. That's both in plain main, and with this MR applied. Only if I manually uninstall the profile do I get a 404 when going to the frontpage which is because the profile provides that page. But that's unrelated.
Comment #33
catchJust to confirm this was the problem I had and nothing to do with this issue...
Comment #34
quietone commentedThe diff no longer applies.
Comment #35
quietone commentedRebased.
Tested again by dropping the database and installing. When I press 'Save and Continue' on the 'Configure site page' I get this failure.
If go back to the 'Configure site page' and press 'Save and Continue' I get the message that Drupal is already installed. Selecting 'visit your existing site' returns the 404 page above. When I select 'update script' I go to the update page and from there I can select 'Administration pages' and go there successfully. From there, selecting 'Home' I get the Welcome screen.
Comment #36
quietone commentedInstead, after I get the 404 if I go to /admin I get this
Comment #38
daffie commentedDisclosure: I have used AI to fix the problem.
The site install functionality now works again. I know, a nice to have feature ;-)
Comment #39
quietone commentedthanks @daffie
I tested again, using the same steps I use previously and I can confirm this now works.
Comment #40
godotislateComments on the MR.
Comment #41
quietone commentedComment #42
godotislateThanks for the changes, @quietone. This looks good.
I tested locally, and the installer is using default_admin:



After install, it's back to claro:


No errors on /admin:
Comment #43
needs-review-queue-bot commentedThe Needs Review Queue Bot tested this issue. It no longer applies to Drupal core. Therefore, this issue status is now "Needs work".
This does not mean that the patch necessarily needs to be re-rolled or the MR rebased. Read the Issue Summary, the issue tags and the latest discussion here to determine what needs to be done.
Consult the Drupal Contributor Guide to find step-by-step guides for working with issues.
Comment #44
quietone commentedRebase, there was a conflict in the comments of core/tests/Drupal/FunctionalTests/Installer/StandardInstallerTest.php
Comment #45
quietone commentedThe conflict was only in comments and tests are passing, so restoring the RTBC
Comment #47
catchReviewing the MR there were a couple of bugfixes here I wouldn't have expected were necessary, but the installer theme stuff is due to us using a theme in the installer that's not in the install profile, which we didn't really do before, and the font preloading is because claro wasn't preloading its fonts yet so we weren't running into that edge case.
Everything else looks good. Committed/pushed to main, thanks! Will need an 11.x backport MR.
Comment #49
quietone commentedThe 11.x MR is passing tests, so time for a review of that.
Comment #50
xjmJust documenting here for posterity: I was previously opposed to committing this before Admin were stable, but the complexities of proceeding with the Claro deprecation without this were slowing us down on that goal and leading to chicken-and-egg problems, so I think we can allow this for the installer only even if Admin remains beta. (It definitely should not be backported to stable branches, though, because while Admin is beta and can change in minors, the installer itself is not.)
Thanks!
Comment #51
godotislateCompared the 11.x MR diff to the main commit diff and just about everything looks good except one thing.
The 11.x MR has to add
core/modules/system/tests/themes/test_installer_theme/src/Hook/TestInstallerThemeHooks.php, because the issue where the file was introduced (#3579903: Eliminate Olivero and three test .theme files), was not backported to 11.x. But the MR here does not also remove thecore/modules/system/tests/themes/test_installer_theme/test_installer_theme.themethat was deleted in that issue.Relatedly, in the 11.x backport of #3581218: Deprecate .theme file extension, it looks like the hook in
test_installer_theme.themehad the#[ExtensionFileIsConverted]applied instead of being converted to an OOP hook.tl;dr: I think we should delete the
test_installer_theme.themefile here as well.Comment #52
smustgrave commentedBased on #50 should this be backported?