50 shades of green - One contribution to the Django world with Sarah Abderemane

This video features Sarah Abderemane at DjangoCon US 2026 in Chicago, Illinois, USA.

50 shades of green - One contribution to the Django world with Sarah Abderemane
0:37:21
Published October 26, 2026
122 views

Django's website has a dark theme. Many developers around the world use it every day. Some never even noticed it appear. Others switched immediately and never looked back.
Either way, there's a story behind it.

This talk walks through the complete arc of that contribution: the motivation, the implementation details, the review process, and what it meant to get it across the finish line on one of the most widely used frameworks in the Python ecosystem.

A practical and personal look at open source contribution: what it takes, what you learn, and why it matters more than you might think.

This talk was presented by Sarah Abderemane at DjangoCon US 2026 in Chicago, Illinois, USA
https://2026.djangocon.us/talks/50-shades-of-green-one-contribution-to-the-django-world/

LINKS:
Follow Sarah Abderemane 👇
On Mastodon: https://mastodon.social/@sabderemane
Website: https://sarahabd.com/

Transcript

4,746 words · auto-generated · en Show

Automatically transcribed, so expect mistakes in names and technical terms.

0:15

Speaker 1: Hi everyone. So I'm going to present my talk, 50 Shades of Green, One Contribution to Django World. So this talk is slightly technical. I will mostly talk about my major contribution to Django and what are the outcome and impact of it. So this talk is interactive. So there are a few questions along the way since I like to know many things and I'm really curious. So you can scan the QR code. or you can join by the link which is shown here, ahaslides. com free xtgv So I just let the slide a few moments so you can join. So you will it will lead you to my slides.

1:02

Speaker 1: You will be able to answer from your device when there will be a question. And also at the same time, hi to the people online. You can also participate, which is cool All right. So let me introduce myself. I'm Sarah Bderman. I'm a software engineer and an accessibility advocate.

1:47

Speaker 1: I am based in France, so you may notice at some point my French accent. So I'm the former Django Software Foundation Vice President, and I'm also organizing meetups in Paris about Django. I'm the co-founder of Django Note Space, which is a mentorship program. I'm also the chair of the website, so the Django website, and I'm also part of the accessibility team. So when you see this slide you are thinking like, oh you are doing a lot of things related to Django. How did you start your journey, right? So let me tell you my story So the origins. So this is me few years ago. I was really eager to learn

2:32

Speaker 1: young. I learned many things through the documentation. I was doing open source contribution, documentation mostly. And I did a few projects in Django professionally. So as you know when you don't know something you check the documentation right and this is a screenshot of the website in 2021 So if you may notice there is no button to switch the theme in the top right corner. So I was checking this website many times really late by night. So I was mostly looking like that.

3:17

Speaker 1: It was hurting so much my eyes, the bright screen, and the really nice light theme, which is amazing but not for my eyes. So I started to think, why not a dark mode for the Django website, right? Should be simple. So I started to look the repository and to see if there is any issue related to that. Otherwise I will create one. But there was one. So it was open in January 2021. So we just read the content. Django website is simple and good, but what about the health of the developers? As of now, there is no provision for DAGN. Having a Darthine will improve the user experience.

4:04

Speaker 1: I would like to work on this issue. And there is six like. So as you can see, it's not a new ID, and I saw that around early 2022, so one year after. And it was still open, no new activity, and some comments. And there is two comments I really think about. So people each time were asking for updates if it's still open. There are no draft PR for this issue. And there is like one comment. It was the last one I've seen when the when I see the the issue. So can I work on this if it's still open? And someone replied, please

4:50

Speaker 1: do, my retinas will thank you. And I think exactly the same at that time. So I thought, why not me? At least I w I could try to do something to help people like Ace Day and myself to not burn my eyes late by night, right? So I can give a try, I'm not an expert in Django, but at least I know how it works. I know front-end stuff. So let's do it! But first, what is a dark mode? So a dark mode is which is also called a dark theme is a website when you can switch colors So this is my website as an example. So you have the light mode in the left section , the left side, and uh the dark mode on the right

5:39

Speaker 1: And you can use the version you prefer, uh where uh the one you are more comfortable with. And it's based on a browser setting by default, and there is a button to be able to switch if you want to override it. So as I said they have question for you. So which film do you use on your browser or your system? That's interesting.

6:26

Speaker 1: All right, I have another one. So which film do you use on Jekyloproject. com? If you have ever been to this website, right Oh, really? It's almost fifty fifty. That's so interesting. Okay. So I will continue So great. Now we can talk about how I started my contribution, the deep dive.

7:14

Speaker 1: So I explored the Django website repository. I started by the README for the project, look into the details, check the structure, how to make it run locally, check the style guide, and make a plan before to do the changes So I was checking that, checking this on my spare time in the evening because I keep doing things in the evening, and I have listed what I've discovered. So the Django website is using Django under the hood, of course. There are only few dependencies. Colors are spread everywhere in the CSS file. And there is uh SAS, which is a compiler for CSS, which is used for styling, and jQuery is used for the JavaScript part.

8:05

Speaker 1: So I was familiar with all those things and so I could focus on the changes and not have to learn something new before to be able to contribute. So it seems not really hard things to do, but as you know, Django has a lot of history and you have to take this into account. And one example is a Stack Ed Did you know the website has a style guide page? So there are still some people who know this page exists. That's so interesting. I I want to talk with you.

8:50

Speaker 1: Okay, so have you ever seen this page before? Well still some people did see this page. Yeah, but a majority of you didn't see this page. And I can tell you at that time I didn't. So this is a screenshot of the style guide page So this page was created a long time ago and the last time it was updated was December twenty fourteen. So it's not really up to date. And if this is the first time you see this page, I can tell you you are definitely not alone

9:36

Speaker 1: Another thing is to show the history is it's not always maintained when you have like things you have to keep to maintain it in open source, and since it's always based on volunteering. So sometimes you don't find all the answers to your question. So after collecting all those information, I had enough to be able to make a plan. and then start to contribute and make changes. So my first idea was to change the whole design and redo everything. And I have to be honest, uh I'm not a designer, and this is my first big contribution. This is really a bad idea. Even if I'm not a big fan of the colors, but anyway.

10:24

Speaker 1: So I decided to start small. So my second idea was to gather all the colors to create the light theme. Reverse the color to create the dark theme. Increase the contrast in the dark theme because in the light film it's not really great. At the button to be able to toggle everything and test of course. Testing is really important, right? Monica said that. So to do that I had to start my green Odyssey, this is the way I call it, gather all the shades. So if I retake the style guide, you can see there are shades of green. There is nine exactly.

11:10

Speaker 1: One gray and two reds. So simple, not so many color, right? So let's do a quiz I want to verify your knowledge. How many colors do you think were on the website in 2021?

12:01

Speaker 1: Okay, it doesn't seem to move more. So the correct answer is thirty-six. So next question, how many colors do you think are on the website now?

12:52

Speaker 1: Okay, seems everyone seems to have answered almost. So the correct answer is 42. That's a lot of colors, right? And the last one, how many greens do you think are on the website now? Yeah, since you have seen big numbers, you betting on the biggest one. I see, I see.

13:43

Speaker 1: All right. So the answer is sixteen So if I retake the style guide, nine greens, one gray, two reds, but it's 60 shades of green. So to me it's already a lot of greens but anyway. So I group all the colors in one file and some has been removed When they were too really close to each other. So there was different versions of the colors, so I tried to lighten or darken them so I can use the less color possible on the website. And I use the exact same color for the dark theme.

14:29

Speaker 1: So otherwise we could have met the title of my talk. That's crazy, right? And as you may notice, I try to name them the best way. So I end up with green very light, green light, green medium. And as you can see, naming is hard. And after that I create the light theme. I use the colors defined before, and I define the variable in the CSS file. And I use them to create the light theme. So how does it work? It's mostly with a class here which is called light, and it's a data attribute which is data theme you have on the HTML directly on the website.

15:15

Speaker 1: So it's a custom one and root is something that already exists uh in CSS, so this is a style by default. And I use the same variable for the tag thing. So if I take an example, So the body background, which is a variable, will take the variable white from the colors, and it will be changed for the dark film in the next slide. So when I reverse the colors for the dark theme I create a new section related to the media query prefer color scheme dark So this way it takes the system colors you know the system preference you define. So either dark, light, or the auto one, which use the both.

16:03

Speaker 1: And Any class which is not light so this way we take all the all the in into account. So I use the previous variable to create the dark theme and try to not create any more colors in addition to that. So yeah if I retake my example the body background here will be black So the next is to make sure the contrast is enough. So as I mentioned previously, we need to increase the contrast. So I said at the beginning of my presentation, I'm an accessibility advocate. So there is a saying in the community that goes, We think about accessibility either because people are around us

16:49

Speaker 1: Or because we face it ourselves. So in my case, I had a colleague who was column blind, and I didn't realize it until I made some Slack app and I was really proud of it. And I put the success one with green, fade one with red, everything is great, it's working. But he wasn't able to see which one is a success and which one is a fade. So I changed the green into blue and everything was fine. So as you can see on the screen The green and the red, this is exactly what he was saying he was seeing on the right part of uh the slide. So everything in the same color.

17:36

Speaker 1: So in the case of the website in 2001, the website has around 60 contrast issues, as visible in my slide. So I use the tool wave to be able to see that. This is an extension you can also use. Since the previous e experience I mentioned I'm trying to be cautious on these things and when we talk about dark feed the most important is colors and contrast So I needed to increase the contrast in the dark film since it's a new addition to avoid to have much more accessibility issue. And for that I use Accessibility Tool to verify contrast. There are many which exist. The one I will show you is the most popular, which is called Access DevTool.

18:24

Speaker 1: This is an extension you can use on your browser. And there is a list of the accessibility issue on the bottom uh of the extension. Here is in French, in some French, but I can s I can assure you you can have that in English. And I use that to get the detail of the element which doesn't have enough contrast so this way I can change it or use uh a better color for that And at the end I had to add the button to be able to toggle between them. So to do that I define a button in HTML. I use a cookie to remember the user choice and get the shorts back.

19:09

Speaker 1: And I update the theme when the button is clicking. So I use JavaScript for that. So The function sets the data team property to the HTML element with the appropriate class and it will be changed then in the in the website. And then you have to test. So I did test, but definitely not alone. So I started to exchange with people in the community through my dark my draft work. And this is the beginning of me testing, but not alone. So I open the draft and I get feedback from the community. And these are some of the comments I got.

19:55

Speaker 1: So I will read them out loud. So this is cool. Having a more less contrast is important to readability. I find it really hard to read white on black text. But much easier with their light and dark greys instead. That said, I strongly prefer light mode for docs, so this needs to have a switch that can override whatever is detected from my other OS browser preference. I really like the way it's done in Furos Sphinx Team Pradiation. me slash furrow, sorry for the borderline bike shedding. So all of those comments influence my PR. and some comments of those folks I have like

20:40

Speaker 1: keep contact with since then. So I had a lot of feedback from the community and even during conferences I have attended So this one is from Paolo which is also here. I tried locally your branch. It seems working. I found only two issues that I want below. And at some point I managed to finish my work and it did merged. Yay! So as you can put potentially see because the screen is small, um it was merged in October 2022. So it takes a few months and the issue was open

21:27

Speaker 1: one year before. So the thing I have created is used by a lot of people, as you have seen. And I had time to reflect on this so you can see with me the outcomes and impact. So first, making a contribution is really rewarding. And I made a lot of improvement on the website and I got like feedback from social media and this is some example I got from Twitter because it was a thing before. And uh and still, as you can imagine, there are still improvements that need to be done. So this is quotes from the 20-tab

22:12

Speaker 1: survey on the Django website. I will read some of them. I always use dark mode. I prefer it, but it doesn't work well. Some of the colors are strange. Having a better dark mode than what we have now would be a very good thing. I like the fact that there is dark and light mode, so it's easy to read. So there are definitely things we can improve. Accessibility and usability is not perfect. And the colors can also be improved. Before this contribution, I went to my first conference. The first ever conference I went to was DjangoCon Europe 2020 online. And it was during COVID.

22:58

Speaker 1: And I met many people during this conference, but they all told me, Oh, you should go in person. This is definitely not the same experience. So I did. And I went to DjangoCon Europe in Porto for real. So this picture is few folk I have met during the conference, and one of them is Talk Caring, which is the guy next right to me. Right next to me. And he was the one who reviewed my PR and helped me on things I didn't know at that time So dark mode was almost finished during the sprint and merged a few days after. But there were a few things I didn't know and I didn't know also how to manage that.

23:45

Speaker 1: So one comment Tom said was a few things I found. The time is stored per subdomain. So you can have a different theme on the doc site, dashboard and the main site. And this is not really what we wanted. And uh one thing you have to know is sprints is really a good way to get feedback directly and exchange easily. So to explain a bit better, Django Project. com has a lot of pages, but some pages redirected to another site. For example, the documentation is hosted on docs. jangoproject. com And the issue tracker, also called track, is on code. juggoproject. com.

24:31

Speaker 1: So the dark film I made initially were not working on doc on the documentation or the issue if I didn't have a cookie to be able to keep the user preference So I learned through this contribution how to contribute effectively and also more of the about the project in depth. And this contribution leads me to join the Django GitHub organization, and I joined the accessibility team at the end. Yeah. And I became a maintainer of the Django website since I continue contributing after, of course.

25:18

Speaker 1: So since Django community is really amazing, at some point you want to give back Whether you have contributed or not, but this community is really cool. So I've been involved in many in initiatives. So I've been a Django Girls Plus coach and organizer. I've been an organizer of the conference DjangoCon Europe in 2023. I've organized Django Booth in Europe. I'm the chair of the website reading group and much more. Because when you start to be involved in the community you get more and more involved. Don't mask don't ask me why

26:04

Speaker 1: Another thing is I met a lot of friends. Done in her keynote she was saying that you made friendship and this is actually really true. I met many people during the sprints, during conference, people I met in meetups, and even remotely, and you meet them in person later. So I put some picture of them and it's this is across the world. You cannot notice here, but there are so many pictures it doesn't fit on one slide, so I had to choose So I did. So you can also do. So I learned a lot of things during the process.

26:49

Speaker 1: I made mistakes But I gave a try and I got so much in return. And all all of this to say you don't need to be an expert to contribute You have to try even if it sounds scary. You can start with small contribution, you can learn and grow with the community. And you could be the next expert. This is cool, right? So, do you want to give a try? But you may wonder how. So, for that you have many possibilities. You can do code contribution, same as me And for that you can join the sprint. So this is a good way to start your contribution. You can contribute to things that could interest you. It could be a package you like.

27:36

Speaker 1: something you use all the time and you know pretty well. You can just contribute to documentation if this is your thing. If you are a bit scared to contribute alone, even if you are not completely on, you can register to Django Note space. So there is a session, the seventh one, which is happening soon, and this is really cool, I swear. But if you are not into code contribution, you can also do things which are not really code like code contributing. You can triage tickets, you can also review peers as Sarah Boyce mentioned earlier. You can join working groups. There are a lot of working groups that exist, can be on around social media if you like posting, tweeting, whatever.

28:22

Speaker 1: And there are much more things you can do. So we have all a story to tell. What's yours? If you don't, you can still write your story. Thank you.

28:51

Speaker 2: Yes.

28:53

Speaker 3: Thanks. Thanks a lot, Sara. I remember that pull request and the the review I made you. The question I want to ask is um if you can share what has been for you uh the starting point the motivation to uh start contributing to to um have the motivation to not be shy and start trying to do something what has been that triggered you

29:27

Speaker 1: Tricky question. Um I think for me is like I would not say I'm shy but I'm not the most Yay! Yay, let's go. But I'm the one who pushed people to go, so I have to lead by example. But I would say um there are things uh you definitely know. And you can definitely contribute, but you feel scared because this is a huge project and it's working in public. Everyone will see your comment, your questions. seems like a naive question. But we all started this way. Like really all started this way. I remember um

30:13

Speaker 1: I I talked to Mayush about a question which was the previous fellow. I had a question about the ticket and I asked him in DM and he told me you should put your question in track. And um and I and I did and at the end I was like okay it was not so scary a bit but But you realize at the end that even if you don't manage to contribute, the thing you have posted in public will help someone else So even if you didn't manage to do your contribution or do something, you contribute in a way. So to answer really the question is more give a try even if it's scary.

30:59

Speaker 1: We all have been scary at some point.

31:08

Speaker 4: You mentioned contributing to um being part of the accessibility group and also the website working group. Could you please help out people who want to get started with that? How they could get in touch and keep it moving. And if you could also highlight track because a lot of people have had um some form of difficulty navigating track. We've had this kind of conversation and I know Django Note Space is coming up with their next cohort or next chapter, so if you could also highlight that for other people who don't know.

31:39

Speaker 1: So many things in job. So you mentioned first the working groups. So I'm involved in two working groups. So the website, which is the one I mentioned. So it's mostly the group who maintain the website, so reviewing PRs, contributing, adding new things, and we have a meeting each month To see what we can do, things we have to improve, and what are the updates. For example, we are doing a redesign of the website. Yay! And um And those uh group uh are are public.

32:24

Speaker 1: You can see all the update on the forum Same for the accessibility. We also meet each month and we are also on Discord. So if you have any question you can ask on the channel accessibility. So you can you can definitely contribute without being part of this working group. And what usually happen is you can either create a PR saying that, oh, I would like to be part of this working group, I know X, Y, Z. That's why I would be really cool in this team. Um otherwise uh if it's not the case because sometimes some teams are really big and it's hard to keep track on everyone especially when we are not all on the same time zone

33:12

Speaker 1: you can still contribute you can still talk with uh those people if you have any questions you can ask on the forum or on discord Many of us will try to reply. And there are like also programs that help people to contribute. Django is part of the GStock project So there will be soon a dark mode on track. Yay. And um and you also have like Django node space program, of course, I mentioned, so you can also contribute through that, but with um a structure help and people who support you at the same time. Um so I think I'll answer everything. Cool.

34:04

Speaker 5: Thank you, Sarah. Great talk. I also love that you're wearing many shades of green. I appreciate the um I wanted to ask uh a lot of people make contributions to Uh uh a lot of people make good contributions to either Django or to Djangoproject. com who but don't have the same kind of explosion into the community that you have had. So I'm curious in your opinion, what you feel like mm m made the difference for you that it um kind of created this uh ignition that you became s so so so very involved in the community.

34:48

Speaker 1: Good question. Um I think first I think all contribution matters, even the smallest one. I'm doing an interview of uh DSF members each m each month and most of the time I I ask them what was their first contribution and it's always something really small. Oh I I I changed the typo. So um I think all contribution matters and even if it's a really smallest one, usually you you have I'm pretty sure you may have experienced that you you start your PR, even if it's a small thing, you you are excited to get a re feedback return, you watch every time the PR to see if there are any updates

35:37

Speaker 1: And um and I think um starting small is is a good way to do uh really step by step. Like for example for me I did few contributions before to do this one And I and I studied re small. I I've done like I I had tests in Django uh core And it was just added cast some like you can find my my my comet anyway. But uh it's It's really small things that help the bigger picture and um and there is always like we're trying to find ways also to since I'm involved in many things related to Django to to

36:22

Speaker 1: to brag people and say that this is really nice what you have done. And if No one say it, you can just say it and we will all be saying, yay, this is so nice. Um so I think I think you you just need to try even if it's really a small thing and you start to be involved a bit more and try to do bigger bigger things and Trying like step by step even if it's a small time and it seems like you have done nothing, but this is actually something

37:05

Speaker 2: Well uh thank you and as a colorblind myself I thank you again. Yes. Uh this is Thank you, me

Conference

DjangoCon US

August 24 - 28, 2026

Chicago, Illinois, USA

Note: We understand that names change, people change, and bodies change. We respect each individual's journey and privacy. If you have any concerns about a video or need us to remove content, please don't hesitate to contact us. We will handle your request with care and promptly address any issues.

More videos by Sarah Abderemane

More videos from DjangoCon US