Channel Grid Editor

The Channel Grid Editor is a visual tool for arranging channel buttons on the facility grid. Controllers see this layout when they log in.

Editor Layout

+----------------------------------------------+------------------+
| Page: [Main ▼]                               |                  |
+----------------------------------------------| + New Position   |
|                                              |                  |
|   +------+  +------+  +------+  +------+    |------------------|
|   | TWR  |  | GND  |  | DEL  |  | APP  |    | Available        |
|   +------+  +------+  +------+  +------+    | Positions        |
|                                              |  +-----------+   |
|   +------+  +------+  +------+  +------+    |  | ATIS      |   |
|   | DEP  |  | CTR  |  |  4   |  |  5   |    |  +-----------+   |
|   +------+  +------+  +------+  +------+    |                  |
|                                              |------------------|
|   +------+  +------+  +------+  +------+    | Other / Unused   |
|   |  8   |  |  9   |  |  10  |  |  11  |    |  +-----------+   |
|   +------+  +------+  +------+  +------+    |  | TMU (p2)  |   |
|                                              |  +-----------+   |
+----------------------------------------------+------------------+
         Grid Area (4×3)                           Sidebar

Grid Layout

The grid is a 4 column × 3 row layout, providing 12 channel slots per page.

Grid Position Location
0-3 Top row (left to right)
4-7 Middle row (left to right)
8-11 Bottom row (left to right)

Page Selector

Use the Page dropdown at the top to switch between pages. Each page can have a different arrangement of channels.

Drag and Drop

The grid editor uses drag-and-drop for all channel arrangement:

Adding Channels to the Grid

  1. Find the position in the Available Positions sidebar
  2. Drag it onto an empty grid cell
  3. The channel is created and placed at that position

Moving Channels

  1. Drag an existing channel from one grid cell to another
  2. If the target cell is occupied, the channels swap positions

Adding to Page from Other/Unused

  1. Find the channel in the Other / Unused sidebar
  2. Drag it onto an empty grid cell
  3. The channel now appears on this page at that position
Swap Behavior
Dropping a channel on an occupied cell automatically swaps the two channels. If dropping from the sidebar, the existing channel moves to the first empty cell.

Quick Create Form

Click + New Position in the sidebar to quickly create a position and its channel.

Form Fields

Field Description Required
Callsign VATSIM callsign (e.g., JFK_TWR) Yes
Callsign Pattern Regex for flexible matching (e.g., JFK_.*_TWR) No
Short Name Grid display label (e.g., JFK) Yes
Display Name Full name shown below short name No (defaults to Short Name)
Color Hex color code for the channel border No (default: #4A90A4)
Default Page Page shown at login for this position No (default: current page)
Position First
The quick create form creates a position. After creation, the position appears in the Available Positions list and must be dragged to the grid.

Sidebar Sections

Available Positions

Shows positions that don't have a channel on any grid yet. These are ready to be dragged onto the grid.

Other / Unused

Shows channels that are:

Orphaned Channels
Orphaned channels appear in red with an "orphaned" label. These should be deleted using the trash icon, as their position no longer exists.

Quick Edit Modal

Click any channel on the grid to open the quick edit modal.

Editable Fields

Field Description
Callsign Pattern Regex pattern for flexible callsign matching
Default Page Which page this position sees at login
Short Name The bold label on the channel button
Display Name The smaller text below the short name
Color Border color (color picker + hex input)

The modal includes a Preview section showing how the channel will appear on the grid.

Removing Channels

Click the X button in the top-right corner of a channel to remove it from the current page.

Validation Errors

If multiple channels occupy the same grid position, a red error banner appears:

Position 3 has 2 channels: TWR, APP

Drag one of the conflicting channels to a different position to resolve.

Channel Appearance

Each channel button shows:

    +-------------------+
    |                 X |  ← Remove button
    |                   |
    |       JFK         |  ← Short Name (bold)
    |   Kennedy Tower   |  ← Display Name (dimmed)
    |                   |
    +-------------------+
          ↑
      Border Color

Tips

Related Topics