> ## 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](/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:

<CardGroup cols={2}>
  <Card title="Left Sidebar" icon="sidebar">
    Primary vertical navigation with collapsible sections for main features
  </Card>

  <Card title="Top Header" icon="bars">
    Breadcrumbs, contextual tabs, and utility tools
  </Card>
</CardGroup>

<img src="https://mintlify.s3.us-west-1.amazonaws.com/valar-8bbb18b5/images/global-layout.png" alt="Global Layout" />

### 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

#### <Icon icon="satellite-dish" /> 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

#### <Icon icon="fire" /> MANEUVERS

Plan and execute spacecraft maneuvers with precision.

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

#### <Icon icon="satellite" /> 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:

<div className="space-y-2">
  <div className="flex items-center gap-2">
    <Icon icon="rocket" /> **Spacecraft** - Manage your spacecraft fleet
  </div>

  <div className="flex items-center gap-2">
    <Icon icon="life-ring" /> **Support Menu** - Docs, API Docs, Status page, Contact form
  </div>

  <div className="flex items-center gap-2">
    <Icon icon="user" /> **User Profile** - Avatar, name, email with logout
  </div>

  <div className="flex items-center gap-2">
    <Icon icon="gear" /> **Settings** - Open configuration dialog
  </div>

  <div className="flex items-center gap-2">
    <Icon icon="moon" /> **Theme Toggle** - Switch between Light/Dark modes
  </div>
</div>

## Command Palette

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

<img src="https://mintlify.s3.us-west-1.amazonaws.com/valar-8bbb18b5/images/command.png" alt="Command" title="Command" className="mx-auto" style={{ width:"85%" }} />

### Quick Access Actions

The command palette provides instant access to common operations:

<AccordionGroup>
  <Accordion title="Import" icon="file-import">
    * State Vectors
    * Burn Plan
    * Measurements
  </Accordion>

  <Accordion title="Add" icon="plus">
    * Spacecraft
    * New Maneuver
  </Accordion>

  <Accordion title="Run" icon="play">
    * Orbit Determination
  </Accordion>

  <Accordion title="Generate" icon="wand-magic-sparkles">
    * Ephemerides
  </Accordion>

  <Accordion title="Open" icon="folder-open">
    * Settings
    * Cheatsheet
    * Process Monitor
  </Accordion>
</AccordionGroup>

## Cheatsheet (Spacecraft Quick Reference)

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

<img src="https://mintlify.s3.us-west-1.amazonaws.com/valar-8bbb18b5/images/cheatsheet.png" alt="Cheatsheet" />

### Cheatsheet Sections

<CardGroup cols={2}>
  <Card title="TLE (Two-Line Element)" icon="ellipsis">
    Copyable orbital elements (spans 2 columns)
  </Card>

  <Card title="Critical Conjunctions" icon="triangle-exclamation">
    High/Medium/Low risk events with TCA and miss distance
  </Card>

  <Card title="State Vector" icon="vector-square">
    Current orbital state with Keplerian & Cartesian tabs
  </Card>

  <Card title="Maneuvers" icon="fire">
    Upcoming burns with Delta-V values
  </Card>

  <Card title="Subsatellite Point" icon="location-dot">
    Current latitude/longitude
  </Card>

  <Card title="Mass & Propellant" icon="weight-hanging">
    Current mass with time-ago indicator & propellant percentage
  </Card>
</CardGroup>

**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:

<img src="https://mintlify.s3.us-west-1.amazonaws.com/valar-8bbb18b5/images/settings.png" alt="Settings" />

### 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

<div className="flex items-center gap-4">
  <Icon icon="sidebar" /> **Sidebar menu**  - Sidebar toggle

  <Icon icon="chevron-right" /> **Breadcrumb navigation** - Home → Page hierarchy
</div>

### 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

<div className="space-y-2">
  <div className="flex items-center gap-2">
    <Icon icon="spinner" /> **Process Status** - Real-time monitoring of async operations (15s polling)
  </div>

  <div className="flex items-center gap-2">
    <Icon icon="clock" /> **UTC Clock** - Live time display
  </div>

  <div className="flex items-center gap-2">
    <Icon icon="bookmark" /> **Cheatsheet** - Quick reference button
  </div>
</div>

## 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

<div className="flex gap-4">
  <div className="p-3 border rounded">
    <Icon icon="sun" /> **Light** - Bright mode
  </div>

  <div className="p-3 border rounded">
    <Icon icon="moon" /> **Dark** - Reduced eye strain
  </div>
</div>

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

## Main Routes Structure

<Note>
  Default route: `/` redirects to `/orbits/measurements/data`
</Note>

### Complete Route Map

<AccordionGroup>
  <Accordion title="Orbits" icon="satellite-dish">
    * `/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>

  <Accordion title="State Vectors" icon="vector-square">
    * `/state-vectors` - State vector table
    * `/state-vectors/keplerian-elements` - Keplerian view
  </Accordion>

  <Accordion title="Maneuvers" icon="fire">
    * `/maneuvers/burn-plan` - Burn execution
    * `/maneuvers/planner` - Maneuver planning
  </Accordion>

  <Accordion title="Conjunctions" icon="triangle-exclamation">
    * `/conjunctions` - Conjunction analysis
  </Accordion>

  <Accordion title="Spacecraft" icon="rocket">
    * `/spacecraft` - Fleet overview
    * `/spacecraft/new` - Add spacecraft
  </Accordion>

  <Accordion title="API" icon="code">
    * `/api-docs` - API documentation
  </Accordion>
</AccordionGroup>

## Next Steps

Now that you understand the platform architecture:

<CardGroup cols={2}>
  <Card title="Core Concepts" icon="lightbulb" href="/platform-overview/core-concepts">
    Learn fundamental spacecraft operations concepts
  </Card>

  <Card title="Data Model" icon="database" href="/platform-overview/data-model">
    Understand how orbital data is structured
  </Card>

  <Card title="Quick Start Guide" icon="rocket" href="/getting-started/quick-start-guide">
    Get started with your first spacecraft
  </Card>

  <Card title="Spacecraft Management" icon="satellite" href="/features/spacecraft-management">
    Manage your spacecraft fleet
  </Card>
</CardGroup>