Tangerine UI for Mastodon 🍊🐘

Tangerine UI is a redesign of Mastodon's Web interface, using just CSS.

Make your Mastodon Web interface a friendlier place. Tangerine UI features a soft orange palette, a bubblier look, and a more compact timeline that should be easier on your eyes. Also, Tangerine UI supports both dark and light modes.

Live demo at nileane.fr

See the announcement post on Mastodon

2 variants

🍊 Tangerine

Default variant for Tangerine UI, featuring a soft orange palette.

🪻 Purple

For those of you who like Tangerine UI but want to stick to Mastodon's purple palette.

!a profile page on Mastodon featuring Tangerine UI's purple variant in light mode](https://github.com/nileane/TangerineUI-for-Mastodon/assets/914451/f3ab51d2-c94d-4192-a1c8-6d15b0d9025a)

How to use

Tangerine UI is contained in a single CSS file.

To use on your instance, simply copy & paste the contents of TangerineUI.css to the Custom CSS field in the administration panel on your Mastodon instance (Navigate to https://domain/admin/settings/appearance).
- 🪻 For the purple variant, copy the contents of TangerineUI-purple.css instead.
If you're not an admin, you can still use Tangerine UI using a userstyle browser extension (ie. Stylus).

Things to know

This is still pretty early, and this is a personal project, so things might not be styled properly in some places. Feel free to message me if you notice anything wonky though :)
Tangerine UI currently only supports Mastodon's single column layout. The advanced view (multiple columns) will not be affected.
Tangerine UI auto-switches from light to dark mode based on your OS preference, whether you set your Mastodon theme to Mastodon (Dark) or Mastodon (Light).
Check your Mastodon instance version before using. The latest Mastodon release checked to be compatible is indicated in the CSS file header.
Glitch-soc and Hometown instance admins beware: Tangerine UI is currently only meant to be applied to Mastodon's vanilla Dark and Light themes.
- If you are a user on a Glitch-soc or Hometown instance using a browser extension, first switch your instance to the Mastodon flavour before applying Tangerine UI.
I have not yet adapted Tangerine to Mastodon's High Contrast theme setting. Please consider this if one or multiple of your users depend on it.

Credits

Huge thanks to Roni Laukkarinen whose work on Mastodon Bird UI I adapted for multiple parts of the redesign. The icon replacement implementations I have also adapted from Bird UI.

<3

If you enjoy Tangerine UI, jobless me would really appreciate a tip 💛!

3.5 KiB Raw Blame History