Hey all,

Following-up to the dark mode work from December. After launching the
registry site (https://airflow.apache.org/registry/), I noticed the main
site and docs looked flat in comparison. The registry has deeper
backgrounds and a more modern feel. So I spent some time bringing them
closer.

Check: https://airflow.apache.org/ |
https://airflow.apache.org/docs/apache-airflow/3.2.0/security/index.html

Swapped Bootstrap's default gray (#212529) for a deeper navy-black
(#0f1117), added a cyan accent color that matches the registry, killed the
invisible gradient overlay Bootstrap was adding to buttons/navbar, and
made the navbar more compact. Also replaced the 3-option dropdown theme
toggle with a sun/moon pill toggle. One click instead of two. All in PRs
#1501 <https://github.com/apache/airflow-site/pull/1501> through #1504
<https://github.com/apache/airflow-site/pull/1504> on apache/airflow-site.

Found a couple bugs along the way too. Text selection was blocked by
invisible full-width sticky containers for the scroll-to-top and
suggest-change buttons (#1503). And the theme toggle wasn't deploying to
production because Docsy moved from partials/ to _partials/ and our
override was in the wrong directory (#1504). Both fixed. If you spot
anything off, PRs welcome.

Regards,
Kaxil

On Mon, 29 Dec 2025 at 13:49, Kaxil Naik <[email protected]> wrote:

> Awesome, thanks Shahar
>
> On Sun, 28 Dec 2025 at 20:59, Jarek Potiuk <[email protected]> wrote:
>
>> I also regenerated all the latest provider's and latest airflow docs
>> applying all the dark-theme, search, contrast and some other small
>> changes.
>> You might need to Shift + R, but all the latest provider's version docs
>> should be "dark" and "nicely searchable" :)
>>
>> J.
>>
>>
>>
>> On Sat, Dec 27, 2025 at 9:40 PM Jarek Potiuk <[email protected]> wrote:
>>
>> > Looks great ! Merged.
>> >
>> > On Sat, Dec 27, 2025, 19:47 Shahar Epstein <[email protected]> wrote:
>> >
>> >> Great job Kaxil :)
>> >> I was motivated today to improve the Dark mode even further - mostly
>> >> improving the dark mode toggling and color contrast, with some extra
>> >> alignment tweaks:
>> >> https://github.com/apache/airflow-site/pull/1355
>> >>
>> >> I'll be happy if anyone could review it.
>> >>
>> >>
>> >> Shahar
>> >>
>> >> On Mon, Dec 15, 2025 at 1:57 PM Kaxil Naik <[email protected]>
>> wrote:
>> >>
>> >> > Hey all,
>> >> >
>> >> > Around the time I went for Pat leave, I spent some time upgrading the
>> >> > ancient (from 2019) Docsy theme to the latest one so we can finally
>> not
>> >> > strain our eyes while reading Airflow docs with the help of some
>> >> > AI-friends.
>> >> >
>> >> > https://github.com/apache/airflow-site/pull/1270 is ready to have
>> more
>> >> > eyes, now that I can address feedback and work on it :) I have fixed
>> a
>> >> lot
>> >> > of issues I found -- the upgrade wasn't straightforward as we were
>> >> using a
>> >> > 6 year old theme.
>> >> >
>> >> > Also requesting help from UI experts to see this doesn't have obvious
>> >> > issues.
>> >> >
>> >> > Regards,
>> >> > Kaxil
>> >> >
>> >>
>> >
>>
>

Reply via email to