How to change Phabricator logo

Before summer 2016, Phabricator didn’t provide a quick way to change the logo. In the software past, the possibility was also offered, but between July 2012 and 2016, the logo was a resource embedded into new sprites, with other header graphics.

You can track the issue on Phabricator’s Phabricator.

Meanwhile a solution is provided by the product, here the procedure to update the UI and change the logo.

History

In August 2016, it’s now possible to edit the logo at directly in the configuration at the following Phabricator URL: /config/edit/ui.logo/

This November 6th commit has broken the logo into two parts, so you can keep the Phabricator eye and replace the product name.  As such, the exact dimensions noted on this blog post should be discarded if you use the latest version (after 2014-11-06) of Phabricator. The methodology is still the same.

Overview

The logo is embedded in the webroot/rsrc/image/sprite-menu-X2.png file. A 50% version is located at webroot/rsrc/image/sprite-menu.png.

So, all the items used in the most top bar are embedded in one image:

sprite-menu-X2-with-bg

A CSS rule allows to select the portion needed of the file.

The easiest procedure is so to prepare a suitable version of your logo respecting the size constraint, edit both files, to replace the genuine Phabricator logo by yours and then to regenerate cached resources.

Prepare a version of your logo

The X2 file uses a 298×52 version of your logo, the main file a 149×26 version.

Your logo will be printed against a #1E2224 background. If you want to provide a good and consistent  look, a light gray white gradient is fine.

Edit the sprites picture

Remove the Phabricator logo, and paste yours. Respect the size and position constraints:

  • sprite-menu.png starts the logo at (0px , 63 px)
  • sprite-menu-X2.png starts the logo at (0px , 126 px)

Deploy the logo

Put your files in your phabricator/webroot/rsrc/image folder.

Then, regenerate Celerity files running the homonym command:

 

Write a tool

You’re welcome to provide a tool to resize an image both in 298×52 and 149×26 sizes, then add it in blank files at the right coordinates.

ImageMagick is probably a good solution for that.

.

 

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.