Better Align for Visual Studio Code

Better vertical alignment with or without selection in any language, for any characters or words.

---

✨ Features

• 🌐 Multi-language Support - Align code in any programming language
• 🎯 Smart Alignment - Align with or without text selection
• ⚡ Auto Align - Automatically align after typing Enter

---

🚀 Usage

Place your cursor at the position where you want alignment, then:

• Press Alt + A (Windows/Linux) or Option + A (Mac)
• Or invoke the Align command via Command Palette (Ctrl+Shift+P / Cmd+Shift+P)

---

📸 Demo

---

⚙️ Configuration

betterAlign.surroundSpace

Control the spacing around alignment characters.

Default Configuration:

"betterAlign.surroundSpace": {
  "colon":      [0, 1],  // [left space, right space]
  "assignment": [1, 1],  // [left space, right space]
  "arrow":      [1, 1],  // [left space, right space]
  "comment":    2        // Space between code and trailing comment
}

Configuration Options:

Key	Type	Description
colon	[number, number]	Spacing around : (e.g., in objects/maps)
assignment	[number, number]	Spacing around =
arrow	[number, number]	Spacing around => or ->
comment	number	Space before trailing comments (negative = no alignment)

---

Examples

Object Properties Alignment

Original Code:

var abc = {
  hello:      1
  ,my :2//comment
  ,friend:   3      // comment
}

With "colon": [0, 1] and "comment": 2:

var abc = {
    hello : 1
  , my    : 2  // comment
  , friend: 3  // comment
}

With "colon": [1, 2] and "comment": 4:

var abc = {
    hello  :  1
  , my     :  2    // comment
  , friend :  3    // comment
}

With "colon": [-1, 3] and "comment": 2:

var abc = {
    hello:    1
  , my:       2  // comment
  , friend:   3  // comment
}

Arrow Function Alignment

Original Code:

$data = array(
    'text' => 'something',
    'here is another' => 'sample'
);

With "arrow": [1, 3]:

$data = array(
    'text'            =>   'something',
    'here is another' =>   'sample'
);

---

🐛 Issues & Contribution

• Found a bug? Open an issue
• Want to contribute? Fork the repo and submit a pull request

---

📄 License

This work is licensed under the Apache License 2.0.

---

🙏 Credits

The codebase is based on better-align. Special thanks to @WarWithinMe.