# Minima Theme

**URL:** https://meta.discourse.org/t/minima-theme/108178
**Category:** Theme
**Tags:** official, minima-theme
**Created:** [February 2, 2019, 1:37am UTC](https://meta.discourse.org/t/minima-theme/108178 "2019-02-02T01:37:05Z")
**Posts on this page:** 20
**Page:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [February 2, 2019, 1:37am UTC](https://meta.discourse.org/t/minima-theme/108178/1 "2019-02-02T01:37:05Z")

</div>

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Minima** - The goal of this theme is to reduce the UI and focus on the text. |
| 👓 | **Preview** | [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/minima-theme) |
| 🛠 | **Repository Link** | [https://github.com/discourse/minima](https://github.com/discourse/minima) |
| 📖 | **New to Discourse Themes?** | [Beginner’s guide to using Discourse Themes](https://meta.discourse.org/t/beginners-guide-to-using-discourse-themes/91966) |

Install this theme

> [@](#):
>
> :discourse2: As this is an #official theme maintained by the Discourse team, #Support issues, #Contribute > Bug reports, #Contribute > UX suggestions, and requests for #Development advice can be made in the respective categories here on Meta, and tagged with the appropriate theme tag. Click on a link below to get one started. 👍
> 
> [❓&nbsp; **Support**](https://meta.discourse.org/new-topic?category_id=6&tags=minima-theme "Ask for support on configuring and using the Minima Theme") [🐛&nbsp; **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=minima-theme "A bug report means something is broken, preventing normal/typical use of the theme") [👀&nbsp; **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=minima-theme "Discussion about the user interface of the Minima Theme, and how features are presented (including language and UI elements)") [🧑‍🎨&nbsp; **Dev**](https://meta.discourse.org/new-topic?category_id=7&tags=minima-theme "Advice on how to customise this theme for your site")

### Features

I’ve gone through and made text larger and removed just about anything redundant (and anything that I don’t use regularly). For example, I know that suggested topics are suggested topics, so I removed the header. I’ve used bulk select on the topic list maybe twice ever, so it’s gone. Views on the topic list? gone. Categories in the hamburger menu? gone.

You get the idea, here’s the theme.

 ![minima theme example](https://global.discourse-cdn.com/meta/original/3X/b/1/b14aabaab20f57dc73f37c0a6bced2883eae44cb.png)

For extra minimalness, I recommend using the `Categories Only` layout for the category page.

  

> :discourse2: **Hosted by us?** Themes are available to use on our Standard, Business, and Enterprise plans.

> Last edited by @JammyDodger 2024-06-17T12:34:17Z
> 
> > **Check document**
> >
> > Perform check on document:

---

<div class="post-metadata">

### Author: ![schleifer](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/schleifer/32/86416_2.png) [@schleifer](https://meta.discourse.org/u/schleifer)
#### Post date: [February 6, 2019, 10:48pm UTC](https://meta.discourse.org/t/minima-theme/108178/2 "2019-02-06T22:48:09Z")

</div>

Glorious serifs! I love it.

The desktop 🍔 menu listing all the other themes seems odd to me, though.

---

<div class="post-metadata">

### Author: ![rishabh](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/rishabh/32/179446_2.png) [@rishabh](https://meta.discourse.org/u/rishabh)
#### Post date: [February 8, 2019, 7:48am UTC](https://meta.discourse.org/t/minima-theme/108178/3 "2019-02-08T07:48:53Z")

</div>

I’m LOVING this theme, especially the topic list, amazing work ❤

* * *

A couple of tiny issues in PM’s, a missing icon:

 ![Screenshot%20from%202019-02-08%2013-06-37](https://global.discourse-cdn.com/meta/original/3X/0/f/0f8d7f6c926fb75a0bb399e2be1b25a9e9f10c1c.png)

and I feel like the small size of the _assigned_ text makes it hard to read, because the text has been made larger for just about everything else (Header, Suggested messages etc.)

 ![Screenshot%20from%202019-02-08%2013-14-13](https://global.discourse-cdn.com/meta/original/3X/b/4/b4fd007654eac10ccbf5f999947470a1e55477a8.png)

---

<div class="post-metadata">

### Author: ![Stephen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/stephen/32/95011_2.png) [@Stephen](https://meta.discourse.org/u/Stephen)
#### Post date: [February 8, 2019, 8:02am UTC](https://meta.discourse.org/t/minima-theme/108178/4 "2019-02-08T08:02:05Z")

</div>

I love it, although losing the theme switcher from the nav on mobile did cause a brief moment of panic!

---

<div class="post-metadata">

### Author: ![Hanon\_Ondricek](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/hanon_ondricek/32/336613_2.png) [@Hanon\_Ondricek](https://meta.discourse.org/u/Hanon_Ondricek)
#### Post date: [February 28, 2019, 3:24pm UTC](https://meta.discourse.org/t/minima-theme/108178/5 "2019-02-28T15:24:00Z")

</div>

One of my users is reporting the Minima theme (which I love very much) does not show the “Dismiss” button when there are unread messages. He verified that Dismiss wasn’t just disappearing because there were no unreads - he said he switched to Minima and back from another theme while showing unreads and the button did not show up.

Is there a setting I might be missing on this, or anything else I should check? Thanks!

I managed to finally reproduce it:

> **Screenshots**
>
> Default board theme
> 
> ![dismiss](https://global.discourse-cdn.com/meta/original/3X/f/b/fbba5f7f6e9aeab6469b06fcc9e54fec98904493.jpeg)
> 
> Minima
> 
> ![nodismiss](https://global.discourse-cdn.com/meta/original/3X/e/b/ebd21ef2b08ee85f59af80ea4b81e36a9eaf142f.jpeg)

---

<div class="post-metadata">

### Author: ![awesomerobot](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/awesomerobot/32/142900_2.png) [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [March 4, 2019, 4:29pm UTC](https://meta.discourse.org/t/minima-theme/108178/7 "2019-03-04T16:29:09Z")

</div>

I’ve added the dismiss button back, you’ll just need to update the theme.

---

<div class="post-metadata">

### Author: ![Hanon\_Ondricek](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/hanon_ondricek/32/336613_2.png) [@Hanon\_Ondricek](https://meta.discourse.org/u/Hanon_Ondricek)
#### Post date: [March 4, 2019, 5:26pm UTC](https://meta.discourse.org/t/minima-theme/108178/9 "2019-03-04T17:26:01Z")

</div>

Thanks so much! I will check it out!

---

<div class="post-metadata">

### Author: ![tomtjes](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tomtjes/32/131271_2.png) [@tomtjes](https://meta.discourse.org/u/tomtjes)
#### Post date: [July 27, 2019, 3:41am UTC](https://meta.discourse.org/t/minima-theme/108178/14 "2019-07-27T03:41:49Z")

</div>

Where can I find the Minima Dark theme?

---

<div class="post-metadata">

### Author: ![schleifer](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/schleifer/32/86416_2.png) [@schleifer](https://meta.discourse.org/u/schleifer)
#### Post date: [July 27, 2019, 4:49am UTC](https://meta.discourse.org/t/minima-theme/108178/15 "2019-07-27T04:49:54Z")

</div>

Mínima Dark is a copy of Minima but using the color scheme from Material Dark.

---

<div class="post-metadata">

### Author: ![Pad\_Pors](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pad_pors/32/52016_2.png) [@Pad\_Pors](https://meta.discourse.org/u/Pad_Pors)
#### Post date: [April 21, 2020, 6:41am UTC](https://meta.discourse.org/t/minima-theme/108178/16 "2020-04-21T06:41:35Z")

</div>

Hi, wondering if it’s possible to show the name in the topic list instead of username, when the option [Prioritizing full name vs username in the UX](https://meta.discourse.org/t/prioritizing-full-name-vs-username-in-the-ux/45415) is active.

---

<div class="post-metadata">

### Author: ![timebinder](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/timebinder/32/181522_2.png) [@timebinder](https://meta.discourse.org/u/timebinder)
#### Post date: [May 23, 2020, 5:35pm UTC](https://meta.discourse.org/t/minima-theme/108178/17 "2020-05-23T17:35:42Z")

</div>

It would be wonderful if we could separate the list of categories as per the white lines I added to demonstrate

 ![Categories_-_Discourse_Theme_Creator](https://global.discourse-cdn.com/meta/original/3X/e/c/ec88ef0f9114327061838f8d483d9fbea6db362d.png)

---

<div class="post-metadata">

### Author: ![krishraov](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/krishraov/32/138744_2.png) [@krishraov](https://meta.discourse.org/u/krishraov)
#### Post date: [June 12, 2020, 4:40pm UTC](https://meta.discourse.org/t/minima-theme/108178/18 "2020-06-12T16:40:46Z")

</div>

I am following the guide on creating Themes ([Developing Discourse Themes & Theme Components](https://meta.discourse.org/t/developer-s-guide-to-discourse-themes/93648)) and it says that to change the templates (like removing the avatars in the listing), you need to touch the .hbr files in Discourse core.

Did you have to do this to remove the avatars? I am a bit confused as to how this theme works and how to use it.

As an example, in the Minima theme, how would I change the look and feel of the Profile page of each user?

Sorry if this is off-topic.

---

<div class="post-metadata">

### Author: ![awesomerobot](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/awesomerobot/32/142900_2.png) [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [June 12, 2020, 9:23pm UTC](https://meta.discourse.org/t/minima-theme/108178/19 "2020-06-12T21:23:38Z")

</div>

> [@krishraov](#):
>
> how would I change the look and feel of the Profile page of each user

It depends on what you’d like to change. If you want to remove or restyle content, it’s likely you can do it with some additional CSS. If you’d like to add information or change the layout dramatically, then you’d need to edit template files.

In the Minima theme, I did edit the template for the topic list to reposition/remove some avatars. You can see that here: [https://github.com/discourse/minima/blob/master/desktop/header.html](https://github.com/discourse/minima/blob/master/desktop/header.html)

If you’d like to use the Minima theme and add additional customizations, I’d recommend installing Minima and adding your customizations to it by creating a new theme component. This way you can still get updates to Minima without worrying about your changes being overridden.

---

<div class="post-metadata">

### Author: ![krishraov](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/krishraov/32/138744_2.png) [@krishraov](https://meta.discourse.org/u/krishraov)
#### Post date: [June 13, 2020, 5:49am UTC](https://meta.discourse.org/t/minima-theme/108178/20 "2020-06-13T05:49:00Z")

</div>

Thanks, @awesomerobot - I will give this a try.

I have a follow-up on the same topic. When Discourse is updated and I need to update the software (assuming I am self-hosting), will this cause problems with themes where the templates have been modified? Or are they not dependent?

Have you experienced anything like this in the past?

---

<div class="post-metadata">

### Author: ![evantill](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/evantill/32/116219_2.png) [@evantill](https://meta.discourse.org/u/evantill)
#### Post date: [July 7, 2020, 1:45pm UTC](https://meta.discourse.org/t/minima-theme/108178/21 "2020-07-07T13:45:13Z")

</div>

Using minima theme I can not archive direct messages (checkbox have disappeared).

 ![Boîte_de_réception_-Messages_directs-Profil-EricV-_Apel_Sophie_Barat](https://global.discourse-cdn.com/meta/original/3X/6/0/60f3bf2c3fdc86c126714c18bc64a47bd1021c02.png)

---

<div class="post-metadata">

### Author: ![awesomerobot](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/awesomerobot/32/142900_2.png) [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [July 10, 2020, 1:37am UTC](https://meta.discourse.org/t/minima-theme/108178/22 "2020-07-10T01:37:59Z")

</div>

I’ve just made an update to the theme that adds that functionality back in. Thanks for reporting it!

---

<div class="post-metadata">

### Author: ![paulrudy](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/paulrudy/32/259901_2.png) [@paulrudy](https://meta.discourse.org/u/paulrudy)
#### Post date: [September 12, 2020, 2:13am UTC](https://meta.discourse.org/t/minima-theme/108178/23 "2020-09-12T02:13:58Z")

</div>

I’m using Minima as a basis for my theme, and I’m scratching my head at one thing: Where does this code come from?

```html
<div class="byline">
    <a href="" data-user-card="joffreyjaffeux"><img alt="" width="20" height="20" src="https://sjc5.discourse-cdn.com/themecreator/user_avatar/theme-creator.discourse.org/joffreyjaffeux/40/2250_2.png" class="avatar" title="joffreyjaffeux" aria-label="joffreyjaffeux">joffreyjaffeux</a>
  </div>

```

It disappears when I switch to the Light theme. Minima doesn’t have any javascript that might be manipulating the HTML. So confused!

---

<div class="post-metadata">

### Author: ![Steven](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/steven/32/187890_2.png) [@Steven](https://meta.discourse.org/u/Steven)
#### Post date: [September 12, 2020, 7:08pm UTC](https://meta.discourse.org/t/minima-theme/108178/24 "2020-09-12T19:08:20Z")

</div>

I believe this is the avatar on top of the topic title

 ![image](https://global.discourse-cdn.com/meta/original/3X/a/b/ab1dce04b8d04863fac29ec558b81d05a80a858c.png)

---

<div class="post-metadata">

### Author: ![paulrudy](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/paulrudy/32/259901_2.png) [@paulrudy](https://meta.discourse.org/u/paulrudy)
#### Post date: [September 12, 2020, 8:35pm UTC](https://meta.discourse.org/t/minima-theme/108178/25 "2020-09-12T20:35:16Z")

</div>

Yes I understand that. I found the code I quoted by inspecting the avatar. What I’m confused about is where the code comes from. It’s present in Minima, yet nonexistent (not just hidden in CSS) in the Light theme for example. What’s generating the HTML?

---

<div class="post-metadata">

### Author: ![Steven](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/steven/32/187890_2.png) [@Steven](https://meta.discourse.org/u/Steven)
#### Post date: [September 12, 2020, 8:52pm UTC](https://meta.discourse.org/t/minima-theme/108178/26 "2020-09-12T20:52:46Z")

</div>

Oh ok I understand better now

It comes from the header file : [https://github.com/discourse/minima/blob/master/desktop/header.html](https://github.com/discourse/minima/blob/master/desktop/header.html)

It rewrites the topic list template.

Original template : [https://github.com/discourse/discourse/blob/master/app/assets/javascripts/discourse/app/templates/list/topic-list-item.hbr](https://github.com/discourse/discourse/blob/master/app/assets/javascripts/discourse/app/templates/list/topic-list-item.hbr)

[Next page](https://meta.discourse.org/t/minima-theme/108178.md?page=2)
