Skip to content
An amazing Xcode plugin to align regular code. it can align Xnything in any way you want.
Objective-C Shell
Latest commit 11f56ff Mar 22, 2016 @qfish Added support for Xcode 7.3


An amazing Xcode plugin to align regular code. It can align anything by using custom alignment patterns.

What's XAlign

Here are some example alignment patterns. Of course you can make your own. The pattern file is here: XAlign/patterns.plist, and the patterns are based on regular expression.


  • You may not like the alignment style below, try it yourself or tell me at the [Issues]. :)
  • There is no need to align all codes at a time when they are complicated, try to align by group which the codes are more similar in.
  • 对齐不需要一次全部对齐,可以分组多对几次,那些等号差的太远的就别让它参与对齐了。
  • 默认对齐的风格不是你喜欢的,可以自定义,或者提个 Issues

Align by equals sign


Align by define group


Align by property group



  • Much easier to customize alignment patterns.

Install & Update

Via source

  1. Clone this repo

  2. Then build the XAlign target in the Xcode project and the plug-in will automatically be installed in ~/Library/Application Support/Developer/Shared/Xcode/Plug-ins

  3. Restart Xcode.

Via command-line

curl -fsSL | sh


  1. Download this package XAlign.tar.gz
  2. Unpack it, copy or move the XAlign.xcplugin to the following path:

    ~/Library/Application Support/Developer/Shared/Xcode/Plug-ins/

    Tips: To quickly go to Finder type Shift + Cmd + G. If there is no Plug-ins directory, you should make one.

  3. Restart Xcode.


curl -fsSL | sh

or Delete the following directory:

~/Library/Application Support/Developer/Shared/Xcode/Plug-ins/XAlign.xcplugin


In Xcode

Xcode -> Edit -> XAlign 

Auto Align Shortcut (default)

Shift + Cmd + X

You can choose the shortcut in the Settings panel, Xcode -> Edit -> XAlign -> Setting.


New version Xcode ? Try this in your terminal :

  1. Get current Xcode UUID

    XCODEUUID=`defaults read /Applications/ DVTPlugInCompatibilityUUID`
  2. Write it into the Plug-ins's plist

    for f in ~/Library/Application\ Support/Developer/Shared/Xcode/Plug-ins/*; do defaults write "$f/Contents/Info" DVTPlugInCompatibilityUUIDs -array-add $XCODEUUID; done
  3. Restart your Xcode, and select Load Bundles on the alert

Want to help

Special thanks to

  • Geek-Zoo

    They provide awesome design and development works continues to help the open-source community even better.

  • BeeFramework

    BeeFramework is a new generation of development framework which makes faster and easier app development, Build your app by geek's way.

Something went wrong with that request. Please try again.