Phoenix Dashboard Editor
Customise the pilot dashboard layout with statistics, activities, flight maps, and social links.
The Phoenix Dashboard is the first page pilots see when they log in. Customise it to show the information most relevant to your VA - from statistics and activities to custom images and quick action buttons.
Accessing the Dashboard Editor
In Orwell, go to Pages → Phoenix Dashboard. You need the View Pages permission.
Layout System
The dashboard uses a row-based layout. Each row contains width blocks, and each block contains components.
Width Blocks
Block Type | Usage |
|---|---|
Full | Single component spanning the entire width |
Half | Two components side by side |
Third | Three components in a row |
Quarter | Four narrow components |
Two Thirds | Paired with a Third block for 2:1 layouts |
Mix block types within a row - for example, one Third block and one Two Thirds block create an asymmetric layout.
Components
Each component has a width setting (25%, 33%, 50%, 66%, or 100%) controlling how much space it takes within its block. Leave at 100% unless combining multiple components in a single block.
Available Components
Content Components
Component | Description |
|---|---|
Text | Rich text with basic formatting (bold, italic, lists, links). Optional "Wrap in Card" for a bordered appearance. |
Image | Upload an image with optional dark mode variant. Can link to a URL and open in same or new tab. |
Buttons | Quick action buttons for Booking, Events, and PIREPs. Add custom buttons with any URL. |
Statistics Components
Component | Description |
|---|---|
Pilot Statistics | The logged-in pilot's stats (flights, hours, distance) with time period tabs. |
Pilot Statistics (Slim) | Compact version of pilot statistics. |
Airline Statistics | VA-wide statistics for recent periods (today, 24 hours, 30 days, year to date). |
Activity Components
Component | Description |
|---|---|
Alerts | Displays active alerts. No configuration needed. |
NOTAMs | Paginated NOTAM list. Configure entries per page (5, 10, or 15) and optionally show only when pilot has unread NOTAMs. |
Events | Slideshow of current activities. Filter by activity type or tags. Show all, random, or first only. |
Event (Single) | Display a specific activity by selecting it from a dropdown. |
Event (Ordinal) | Display the first, second, third, etc. activity from the list. Useful for predictable positioning with multiple activities. |
Community Goal/Challenge | Progress bar for active community goals or challenges. Hides automatically when none are active. |
Flight Components
Component | Description |
|---|---|
PIREP and Booking Boxes | Cards showing active flight, current bookings, and recent PIREPs. Configure which to show and how many items. |
Flight Map | Live map showing active flights. Set a minimum height when used in a Full block. |
Flight List | List of active flights with optional hiding of past flights. |
Social Component
Component | Description |
|---|---|
Social Icons | Displays your social media icons. Configure icons in Settings → Social Icons. |
Social Icons
Social icons link to your external communities (Discord, Facebook, Instagram, forums, etc.).
Configuring Social Icons
In Orwell, go to Settings → Social Icons. You need the View Design Settings permission.
Each social icon has:
Field | Description |
|---|---|
Name | Display name shown in the Community navigation menu |
Icon | FontAwesome icon (e.g., brands.facebook, brands.discord, light.globe) |
URL | The link destination |
Image | Banner image shown in the Dashboard component (recommended: 200 x 50 pixels) |
Image - Dark Mode | Optional dark mode variant of the image |
Display Options
Option | Where It Appears |
|---|---|
Show in Phoenix Dashboard | Displays the image in the Social Icons dashboard component |
Show in Community Navigation Menu | Adds a text link under Phoenix → Community |
Discord Icon? Enable Integration | Triggers automatic Discord join (only visible if Discord is configured) |
Discord Integration
If you've configured Discord integration for your VA, enabling "Discord Icon? Enable Integration" on a social icon makes it a one-click Discord join button. Instead of opening a URL, it automatically adds the pilot to your Discord server (with their consent).
Restoring Defaults
Click Default Config at the top of the dashboard editor to restore the default layout. This replaces your current configuration entirely - there is no undo.
Layout Best Practices
Understanding Rows and Columns
The dashboard is built row by row, but within each row, width blocks create columns. Think of it like a spreadsheet:
A row is a horizontal band across the page
Width blocks divide that row into columns
Components fill those columns
Stay Consistent
The most common layout mistake is inconsistency. If you choose a two-column layout, commit to it:
Don't overload one column - piling components into one side while the other sits empty creates visual imbalance
Don't start new rows prematurely - breaking into single Full-width blocks disrupts the rhythm
Pair components thoughtfully - components have different heights, so similar-height components work better side by side
Start from the Default
The default dashboard configuration is reasonably proportioned and demonstrates good layout principles. Rather than building from scratch:
Click Default Config to see a working layout
Make incremental changes
Preview often to check balance
For custom layouts, expect to experiment. There's no formula - you'll need to try different combinations until the proportions feel right.
Tips
Flight Map pairs well - Use a Two Thirds + Third layout with Flight Map alongside Events or a custom image.
Test both themes - Preview your dashboard in light and dark modes to ensure images and colours work in both.
Use ordinal events for predictability - If you always want your main event in the same position, use Event (Ordinal) instead of Events.
Set map heights in full blocks - The Flight Map needs a minimum height when placed in a Full width block, otherwise it may not display.
Social icon images vs icons - The FontAwesome icon appears in navigation; the uploaded image appears on the dashboard. Design both for their context.
Thank you for your feedback!
Your input helps us improve our documentation.