Discourse Meta archived in May, 2026

Modernizing the Foundation theme

jordan.vidrine

The design team are in the process of making small but powerful changes/tweaks to the foundation theme to align a bit closer to modern web standards. To view these changes live on meta, join this group:

https://meta.discourse.org/g/modernized-foundation

We will be making this change live through the new Upcoming Changes feature available in Discourse. This will allow site owners to enable the changes for any group they specify, in order to test the roll out of the changes without the fear of possibly breaking themes or current customizations.

What will change?

Header shrinks in height

We have decreased the site of the header along with some of the icons & avatar slightly to utilize onscreen real estate.

Default buttons

We are moving from a grey default button background to a transparent / “secondary” background with a border.

  • removal of grey background
  • addition of borders
  • icon color matches text color
  • buttons now have a set height

Create new topic button on topic list page

Matching Horizon and giving this a “CTA” background color of tertiary

Lots of gray background removal

Topic list

  • removal of 3 px thicc top border
  • decrease font size of table header data
  • consistent color for table data items
  • color value changes to read/unread
  • slight increase in font weight to unread

Category boxes

  • left alignment of text
  • removal of thicc left colored border
  • slightly rounded badges
  • thinner border on box

Nav bar

  • The nav pills on topic list pages will be the same height as buttons in this zone
  • darker color text & icon on select kit

Sidebar

  • icon & text match color
  • darker text & icons
  • lighter “active” background
  • heavier active font weight

Welcome banner

  • balanced spacing
  • added variables for easier left/right/center alignment via customization
  • header font weight decreased
  • sub title font size decrease

Calendar

  • removed grey background from “buttons”
  • use grey only to signify “active”
  • switch to “bordered transparent” button styling

Drop downs

  • padding added to drop down container
  • height, padding, gap now matches sidebar items
    • unification of “clickable lists”
  • border inherits --d-border-radius variable

New Variables

Some of the changes here will be introduced via additional variables added into core.

Welcome banner alignment

The alignment of the welcome banner will now be able to be changed via:

// default
  --welcome-banner-text-align: center;
  --welcome-banner-search-menu-margin-inline: auto;

// custom
  --welcome-banner-text-align: left;
  --welcome-banner-search-menu-margin-inline: 0 auto;

Button height

We will now have a set button height via:

// default
  --button-height: var(--space-8);

Font smoothing

We are already doing this in Horizon, it makes sense to bring to foundation.

// new default
--webkit-font-smoothing: antialiased;
jordan.vidrine
Lilly

the gist button dropdown has a scrollbar (overflow on the fk-d-menu maybe?), and probably doesn’t need the same min-width: 200px as other such dropdown-menu classes.

edit: nevermind, fixed already :smiley:

Canapin

I can see the modern foundation theme, but why do I still have the old categories layout?

Moin

I think Meta doesn’t use “Boxes with subcategories” but “Categories only” in their Desktop category page style site setting.

Canapin

Oops, I assumed the screenshots were taken on meta but I didn’t even think of checking it.


Small but weird behavior. On the regular theme, when we release the mouse button on , it instantly triggers the show or close sidebar’s animation.

On the new theme, when we release the mouse button on when the sidebar is closed, there’s a split second of waiting before the sliding animation is triggered. Doesn’t happen if we click the icon when the sidebar is visible.

I’m probably hallucinating :thinking:


Can I leave the group to compare changes with the old theme? I don’t see the leave option.

awesomerobot

oh yes, fixed that… should be able to leave at will now

Moin

Would you please allow me to leave the @modernized-foundation group.
Edit: Now, after leaving the group, I can add a comparison screenshot of the new topic button.
image

It seems some icon colors don’t work well with the wcag palette.
image

And, for example, the group selector on the top left of the group page doesn’t really support 2 lines.

This is how it looks when I log out.

Canapin

I like most of the changes. They are subtle. Some I don’t even see the difference unless I look at the CSS values :smile: (sidebar icon and text colors, topic list read and unread colors)

Before / After
image image

I like the emphasized new topic button. I actually customized it like that on my forum a long time ago (until my code broke and I didn’t bother fixing it).


Before / After


I also like this; At least on dark palette, the dark blue on dark grey was a weird pairing.


Before / After

While I like the new button style, I feel they lack contrast with the background in certain areas, especially the topic footer.
It looks messy. The buttons don’t look like they belong to a specific section, unlike the previous version. They just kind of… sit there. I don’t know if it makes sense.

Moin

This seems to work on the read and topics activity in some screen sizes

But once I reduce the width a little, “Replies” and “activity” seem too big (This is also a problem on /latest)

There is a similar problem with “updated” and “activity” on /my/activity/bookmarks

Another example where the icon and text color do not match is the expand button on my profile

This is how it looks when I leave the group:

I think you didn’t mention that not only the font size of the table headers, but also the size of the numbers in the Replies, Views, and Activity columns, seem to be decreased.

I think the icon in the language dropdown is now very large in relation to the text.
Before:
image

After:
image

hellekin

Thank you so much for the before/after. I thought it was missing from the OP.

Both these changes look weird: the after side looks much less contrasted and may cause A11y issues, or?

I’m heading to the new group for a test drive!

Moin

The word “link” in the topic map is only partly shown after I join the group:

Screenshot taken at Add link to sidebar category setting to new admin menu in categories section of the sidebar

And the text in this modal is difficult to read on hover. I think the contrast was better before

sniper756

I’m really looking forward to the changes to the default style, when will it be released approximately?

Canapin

Search input and submit are squished!

squish!

edit : on mobile only

jordan.vidrine

All great feedback / bug finding so far. Thanks for the updates.

jordan.vidrine

This is a good callout. I think the new button style is quite nice as well, but for some reason in this section (with so many of them together), it doesn’t feel quite right.

Canapin

The unread font weight is heavier than on read topics.
It didn’t strike me on desktop, but I see it on mobile.

It looks a bit blunt to me.

I liked that discourse mostly opted for just a color change, which felt more elegant than the canonical weight difference we see on many forum software.

Now we have both. The difference is subtle, yet I’d prefer only a color change :paintbrush:

jordan.vidrine

Latest round of changes should be live soon from the PR here:

sniper756

When is the final version expected to be released? I am really looking forward to this style upgrade.

Moin

You seem really excited. While the changes are currently still in an experimental state, you can enable Modernize Foundation theme today: Upcoming Changes

sniper756

I’m using it and it feels great……………………………..

gormus

I was using the Foundation theme on my local, without the experimental new features enabled.

Then I realized every once in a while the theme components I had enabled for the theme started to show up as unassigned, randomly.

Has this happened to anyone?

Lhc_fl

This looks fantastic and so modern!

The translation button seems to be too dark.

dax

Not assigned:

Assigned (button border missing):

David_Ghost

there’s a problem when i try to search for a ip adress:

chapoi

4 posts were split to a new topic: Issue with enabling upcoming changes

chapoi

A post was merged into an existing topic: Horizon Theme

jordan.vidrine

These issues have been addressed.

jordan.vidrine

Would you mind pointing me to the relative url to access this UI? (Yes, I’ve worked at Discourse for 6 years and still don’t know where some things live :sweat_smile:)

chapoi

That’s the admin-profile view I believe. Not sure related to the Foundation changes; saw it earlier today on another theme too.

David_Ghost

I can see it at /admin/users/id/USERHERE

jordan.vidrine

thanks! It was addressed in this PR → FIX: Change @class to @triggerClass on ip lookup menu by jordanvidrine · Pull Request #37831 · discourse/discourse · GitHub

sniper756

There is a black dot to the right of the small handle

Lhc_fl

When the button is hovered over, the icon disappears. :winking_face_with_tongue:

Canapin

The compose icon is off-center:

image

image

Canapin

On an empty search page, there’s a floating border:

Canapin

On mobile, the post count container is too tall, or the translation button is too short, I don’t know which one should be tweaked :face_with_tongue:

jordan.vidrine

:winking_face_with_tongue:

this made me laugh.

Thanks for all of the feedback again everyone, will work on this round and have it updated by EOW.

David_Ghost

it’s the same if i try to remove a tc at /admin/config/customize/components

jordan.vidrine

This is actually an issue with AI search not with these foundation improvements.

jordan.vidrine

What page is this on?

David_Ghost

It’s on the /categories page. I have the same

Canapin

Avatars have a higher z-index than the category list when we edit a topic’s title:

gilles

I’m trying to activate the theme but I don’t see how to proceed!

I have activated the Foundation theme in upcoming, but in my themes, there is only the old Foundation theme.

Is this normal? :sweat_smile:

Moin

Yes that’s normal. The upcoming changes affect how the Foundation theme looks like. It’s not a different theme.

sniper756

Switch the homepage to categories, the upper right corner ~~~~~~~~~~~~~~~~~~~~~~~~

jordan.vidrine

This is not happening for me. Here is what I am seeing locally:

Can you confirm this doesnt happen when this update is turned off? I didn’t edit any z-index so am wondering how this would have happened.

Canapin

It doesn’t happen anymore. No clue why.

sniper756

Uh~ I just celebrated that this issue was fixed these few days. But after I rebuilt just now, this problem appeared again.

small-lovely-cat

Specifically, only the post-approval will hit this bug:

Left is the original, right is the one without padding-inline set, seems that the No button is shorter than the Edit Post button.

Not sure if it is by-designed, just report it.

small-lovely-cat

And in mobile view, there seem to be an unnecessary outline when clicking more button.

small-lovely-cat

Another issue: The tags fail to display here with proper color.

small-lovely-cat

image

The card at the end of a PM is also misaligned in height.

(The “x” button expand the card’s height)

jack222

hello,It seems like this hasn’t been fully fixed yet.

Canapin

On mobile, the notification button’s transparent background cause issues:

Lilly

when is this actually going to be made official? having 2 foundations with different classes is a pain for theme and component dev.

Canapin

I’m curious as well to know if there’s an estimated release date, and if the release will need .uc-modernize-foundation-theme as a parent selector or if it’s just temporary.

jordan.vidrine

Thanks for the pings everyone. This project is still in the works, amidst a ton of other things we are trying to keep in check. My plan is to merge some of the smaller items into core while keeping things like buttons, header, and anti aliased font behind the feature flag for now.

I have made room for this next week and will begin sharing some more updates then.

What sort of issues have you run into with your theme and component work with this feature turned on or off?

This is just temporary for now as it is scoped to the upcoming changes feature being enabled.

Lilly

mostly the buttons! lately i have been formatting buttons for new foundation not realizing they look different in old foundation until a certain awesome robot pointed it out recently lol. :woman_facepalming: new foundation looks better too :+1:

Canapin

Thank you for your reply!
I’ve been halting a custom theme for several weeks now because it will be based on the new foundation, and I don’t want to mess my code with temporary stuff, I prefer to wait and work from the final release :slight_smile:

Canapin

How it looks on Foundation and Meta Branded:

image image

The number and arrow containers should be the same size.

NateDhaliwal

I do not see this on mobile. I assume this is desktop?

Canapin

Thanks, I dug more: It’s because of the new foundation theme, which is also used on Meta Branded, and happens both on desktop and mobile.

I’m not sure if it should be moved to Modernizing the Foundation theme or not.

chapoi

Made the exec decision to do so :wink:

jordan.vidrine

This has been fixed & will be updated soon

Canapin

On dark theme, the active state on certain buttons (mostly visible with keyboard navigation, only transient when using mouse/touch) is dark purple on dark background and harsh to the eyes:
image

Red hover state as well:
image

But the worst is the “danger” button with a red background and dark text:
image

Perhaps simply tweaking the red value/brightness would fix the 2nd and 3rd points.

jordan.vidrine

Is this only on this meta theme?

Canapin

Yeah. On foundation:

active
image

hover
image

danger
image

Better contrasts than Meta Branded.

Moin

This is still the case:

Are there any plans to adjust the borders of the buttons when using the WCAG color palette? I currently find the thin, very light border difficult to see, so in some places it looks to me like there are just icons floating around rather than buttons. This wasn’t a problem with the previous solid-gray buttons.

I also felt similar when the shadow below the header was removed and when the colored line at the top of the composer was removed. But while those are clear zones of my screen, the buttons are at different places, which makes the fact that they are difficult to tell apart from their surroundings more difficult for me.

Text fields in the settings, for example, have a darker outline:

I also noticed that this seems to break the styling of the category security:

The group selection for the upcoming change also looks unusually large in the new design:


sk-or-v1-contents

I think the navbar text size is too small on mobile (less legible than it looks like in the screenshot as it’s at the top of the page). The Suggested/Related font is too small too.

Old font sizes are good:

See also

Lilly

i think this is clearly a matter of taste because i think exactly the opposite of the old vs new. the old foundation fonts and buttons feel too chunky, while the new foundation sleeker elements look much nicer in the overall layout comparitively. i have no complaints about functional usage on desktop or mobile, nor have any of my users since i enabled it. :woman_shrugging:t2:

i think you could give feedback to your admins as well and perhaps they could create another theme with the old changes? enlarging those fonts you indicated isn’t difficult with css. or you could use a stylus type scripting browser extension to add your own mods (i do that with all the discourse sites i visit, including this one).

edit:

for example, something like these:

topic header text

.extra-info-wrapper .topic-link {
    font-size: larger;
}

related/suggest topic footer buttons see also below

.more-topics__container .nav {
    font-size: larger;
}
sk-or-v1-contents

Theres a small gap under the Related button


Becomes more obvious if the font size is increased

Stylus

.more-topics__container .nav .d-button-label {
   font-size: 150%;
}


Lilly

yea that is why i said “something like”, because they may have some other things going on with their theme. i was using meta, not Rust forum. i’ll have a look for you because i am nice. but i have to wait until there is some new and unread items to get the full footer header. i assume from the screenshot with avatar that that is in mobile viewport?

sk-or-v1-contents

The quirk is visible here

Lilly

OK this looks like a UX bug with the new foundation theme and the injected AI related topic button. the button classes are a bit different:

image

but this will fix it a bit - can patch it with some padding and line-height adjustment:

.more-topics__container .nav li .btn {
  padding: .5em;
  line-height: 0;
}

desktop:

Screenshot from 2026-05-02 20-18-28

Screenshot from 2026-05-02 20-18-34

mobile:

Screenshot from 2026-05-02 20-22-43

Screenshot from 2026-05-02 20-22-47

NateDhaliwal

For the pinned state menu, the options overlap severely:

sniper756

Opening the Manage Tag Groups page in a mobile browser displays layout issues - Contributions / User Experience - Discourse Meta