> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valar.space/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform Architecture

> Comprehensive guide to VALAR's user interface, navigation patterns, and platform organization

> For the complete documentation index, see [llms.txt](https://docs.valar.space/llms.txt).

VALAR is a spacecraft mission planning and operations platform for satellite orbit management, maneuver planning, conjunction analysis, and ephemeris generation. This guide provides a detailed overview of the platform's user-facing architecture and navigation patterns.

## Navigation Structure

The platform uses a **dual-navigation layout** designed for efficient spacecraft operations:

> [card] Left Sidebar
>
> Primary vertical navigation with collapsible sections for main features

> [card] Top Header
>
> Breadcrumbs, contextual tabs, and utility tools

![Global Layout](https://mintcdn.com/valar-8bbb18b5/6vb3axcORVXT2Ny4/images/global-layout.png?fit=max\&auto=format\&n=6vb3axcORVXT2Ny4\&q=85\&s=f4d153727c4db9dfd8e1a643c85b04e8)

### Responsive Behavior

* **Desktop**: Persistent sidebar with collapse/expand functionality
* **Mobile**: Drawer-style overlay that adapts to smaller screens

## Sidebar Navigation

The sidebar is your mission control center, providing access to all platform capabilities.

### Primary Navigation Sections

#### &#x20;ORBITS

Track, determine, and visualize orbital data for your spacecraft fleet.

* **Tracking** - View and manage orbit tracking measurements & sensors
* **State Vectors** - Manage spacecraft state data (Table & Keplerian views)
* **Solutions** - Orbit determination solutions & scheduling configurations
* **Ground Track** - Visualize spacecraft ground track on Earth

#### &#x20;MANEUVERS

Plan and execute spacecraft maneuvers with precision.

* **Burn Plan** - Manage maneuver execution plans
* **Planner** - Plan and schedule future maneuvers *(feature flag required)*

#### &#x20;STM (Space Traffic Management)

Assess and manage collision risks *(feature flag required)*.

* **Conjunctions** - Collision risk assessment with High/Medium/Low classifications

### Sidebar Footer

Quick access to essential tools and preferences:

&#x20;**Spacecraft** - Manage your spacecraft fleet

&#x20;**Support Menu** - Docs, API Docs, Status page, Contact form

&#x20;**User Profile** - Avatar, name, email with logout

&#x20;**Settings** - Open configuration dialog

&#x20;**Theme Toggle** - Switch between Light/Dark modes

## Command Palette

Your productivity accelerator for quick access to platform actions and navigation. Trigger: ⌘K / Ctrl+K or pen button in sidebar header.

![Command](https://mintcdn.com/valar-8bbb18b5/6vb3axcORVXT2Ny4/images/command.png?fit=max\&auto=format\&n=6vb3axcORVXT2Ny4\&q=85\&s=5851a93eb7041aeadf0472c3790c99ee)

### Quick Access Actions

The command palette provides instant access to common operations:

> [accordion] Import
>
> * State Vectors
> * Burn Plan
> * Measurements

> [accordion] Add
>
> * Spacecraft
> * New Maneuver

> [accordion] Run
>
> * Orbit Determination

> [accordion] Generate
>
> * Ephemerides

> [accordion] Open
>
> * Settings
> * Cheatsheet
> * Process Monitor

## Cheatsheet (Spacecraft Quick Reference)

A comprehensive modal displaying critical spacecraft data in a **3-column grid layout**. Access:  BookMarked icon in header:

![Cheatsheet](https://mintcdn.com/valar-8bbb18b5/6vb3axcORVXT2Ny4/images/cheatsheet.png?fit=max\&auto=format\&n=6vb3axcORVXT2Ny4\&q=85\&s=8797b78dd28a74b38c4f3c2b4f10ba7c)

### Cheatsheet Sections

> [card] TLE (Two-Line Element)
>
> Copyable orbital elements (spans 2 columns)

> [card] Critical Conjunctions
>
> High/Medium/Low risk events with TCA and miss distance

> [card] State Vector
>
> Current orbital state with Keplerian & Cartesian tabs

> [card] Maneuvers
>
> Upcoming burns with Delta-V values

> [card] Subsatellite Point
>
> Current latitude/longitude

> [card] Mass & Propellant
>
> Current mass with time-ago indicator & propellant percentage

**Top Feature**: Spacecraft selector dropdown with color-coded status indicators

## Settings (Configuration Dialog)

Customize your platform experience with comprehensive configuration options. Access: Settings button in sidebar footer OR Command Palette:

![Settings](https://mintcdn.com/valar-8bbb18b5/6vb3axcORVXT2Ny4/images/settings.png?fit=max\&auto=format\&n=6vb3axcORVXT2Ny4\&q=85\&s=66e49fdc9910b73268353add5edeafa6)

### Organization

* **Profile** - Name, email, username, password (Auth0 integration)
* **Members** - Invite and manage organization members

## Header Components

The header provides contextual navigation and real-time information.

### Left Section

&#x20;**Sidebar menu**  - Sidebar toggle

&#x20;**Breadcrumb navigation** - Home → Page hierarchy

### Center Section: Contextual Tabs

Dynamic tabs that change based on the current page:

| Page | Available Tabs |
| - | - |
| Solutions | "Solutions" \| "Configs" |
| Tracking | "Measurements" \| "Sensors" |
| State Vectors | "Table" \| "Keplerian Elements" |

### Right Section: Utility Tools

&#x20;**Process Status** - Real-time monitoring of async operations (15s polling)

&#x20;**UTC Clock** - Live time display

&#x20;**Cheatsheet** - Quick reference button

## Key User-Facing Features

### Modals & Dialogs

The platform uses modals for focused workflows:

* **Import Dialogs**: OEM files, burn plans, measurements
* **Form Dialogs**: Add/edit spacecraft, thrusters, ground stations, maneuvers
* **Export Dialogs**: Generate ephemerides (OEM format)
* **Special Dialogs**: Covariance matrix viewer, burn details, support form

### Real-time Features

Stay informed with live updates:

* **Push notifications** - Instant alerts for critical events
* **Process monitoring** - Background job status updates (15s intervals)
* **Live UTC clock** - Always know the current time

### Theme System

&#x20;**Light** - Bright mode

&#x20;**Dark** - Reduced eye strain

Theme preference persists across sessions and is accessible via the sidebar footer toggle.

## Main Routes Structure

> [!NOTE]
>
> Default route: `/` redirects to `/orbits/measurements/data`

### Complete Route Map

> [accordion] Orbits
>
> * `/orbits/measurements/data` - Measurements
> * `/orbits/measurements/sensors` - Sensor configuration
> * `/orbits/solutions` - OD solutions
> * `/orbits/solutions/schedules` - OD scheduling
> * `/orbits/ground-track` - Ground track map

> [accordion] State Vectors
>
> * `/state-vectors` - State vector table
> * `/state-vectors/keplerian-elements` - Keplerian view

> [accordion] Maneuvers
>
> * `/maneuvers/burn-plan` - Burn execution
> * `/maneuvers/planner` - Maneuver planning

> [accordion] Conjunctions
>
> * `/conjunctions` - Conjunction analysis

> [accordion] Spacecraft
>
> * `/spacecraft` - Fleet overview
> * `/spacecraft/new` - Add spacecraft

> [accordion] API
>
> * `/api-docs` - API documentation

## Next Steps

Now that you understand the platform architecture:

> [card] [Core Concepts](https://docs.valar.space/platform-overview/core-concepts.md)
>
> Learn fundamental spacecraft operations concepts

> [card] [Data Model](https://docs.valar.space/platform-overview/data-model)
>
> Understand how orbital data is structured

> [card] [Quick Start Guide](https://docs.valar.space/getting-started/quick-start-guide.md)
>
> Get started with your first spacecraft

> [card] [Spacecraft Management](https://docs.valar.space/features/spacecraft-management.md)
>
> Manage your spacecraft fleet


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.