Dark theme EAP in Bitbucket Data Center

We’re thrilled to introduce early access to dark theme for Bitbucket Data Center!

All partners can now test their apps with Atlassian Maven Plugin Suite (AMPS) by running the following command with the Atlassian Plugin SDK: atlas-run-standalone --product bitbucket --version 8.14.0-dark-theme-eap-1. Or you can download development release 8.14.0-eap01 and test your apps against it to check how dark theme works for them.

The public release of dark theme will be rolled out along with one of the upcoming Bitbucket Data Center versions after November 2023. Stay tuned and follow our community announcements and the release notes for the latest info about the public release.

Adding dark theme to your apps will enhance the consistency of your users’ experience while interacting with the multiple tools within their work environment, reducing visual distractions, and helping everyone perform more efficiently. Explore more about dark theme’s benefits in our announcement that dark theme is coming to Atlassian Data Center.

To provide you with a real-life visualization, here’s how the latest version of the Marketplace for Bitbucket looks in dark theme:

How to enable dark theme in your Bitbucket profile

Once you’ve installed the EAP, you can add dark theme to your Bitbucket profile. To do so, select your avatar in the top right corner of the screen. Then, select Theme and Dark.

If you’re already using dark theme across your device, you can select Match system and Bitbucket will automatically adjust to dark theme as well.

Enable dark theme in Bitbucket Data Center

Original theme vs. light theme

You’ll notice that the options for the theme also include Original and Light. Although they both represent the usual “white“ user interface and don’t have many visual differences, each has its own technical background.

Original theme uses the same colors as before the conversion. You may want to continue using this theme as they’re waiting for apps to transition to the new design token themes. Additionally, if you decide to switch back from the dark theme, original theme will ease the transition.

Original theme remains a transitional measure. We’ll remove it as soon as we make sure that our partners and customers have no issues adopting dark theme.

Light and dark themes use design tokens – name and value pairings for repeatable design decisions. For example, a color or font style. You can learn more about design tokens in the developer and designer guides that we prepared for this release and provide in the following section.

How to prepare my app for dark theme

Check our dedicated guidelines for developers and designers. After you adjust your app to dark theme, you may want to update the screenshots on the Marketplace to draw customers’ attention and increase their awareness of the new experience.

I’m a developer

Get a complete guide on how to tune your app for dark theme: Preparing your Data Center app for dark theme.

I’m a designer

Get a complete guide on the design tokens for dark theme: Migrate to tokens.

Need help?

If you need any assistance with dark theme or want to share feedback on it, reach out to us through the following channels:

  • Leave your question or feedback in a comment under this post.
  • Create a public ticket on jira.atlassian.com. Use the project BSERV (Bitbucket Server) and the label dark-theme.
  • Add a post about your issue to the Developer community with the labels bitbucket-data-center and dark-theme . We’ll subscribe to your post and provide a solution.

Very excited to upgrade our internal apps for dark mode! Many of my customers have been asking for this for a long time! :smiley: Thank you!!!


This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.