feat(tui): add OpenShell splash screen and rebrand title bar (#210)

* wip: feat(tui): OpenShell splash screen and branding

* chore(tui): fix rustfmt import ordering

---------

Co-authored-by: John Myers <johntmyers@users.noreply.github.com>

Author: johntmyers

crates/navigator-tui/src/app.rs

@@ -15,6 +15,8 @@ use tonic::transport::Channel;
 /// Top-level screen (each is a full-screen layout with its own nav bar).
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 pub enum Screen {
+    /// Splash / boot screen shown on startup.
+    Splash,
     /// Cluster list + provider list + sandbox table.
     Dashboard,
     /// Single-sandbox view (detail + logs).
@@ -271,6 +273,9 @@ pub struct App {
     pub focus: Focus,
     pub command_input: String,
 
+    /// When the splash screen was shown (for auto-dismiss timing).
+    pub splash_start: Option<Instant>,
+
     // Active cluster connection
     pub cluster_name: String,
     pub endpoint: String,
@@ -354,10 +359,11 @@ impl App {
     pub fn new(client: NavigatorClient<Channel>, cluster_name: String, endpoint: String) -> Self {
         Self {
             running: true,
-            screen: Screen::Dashboard,
+            screen: Screen::Splash,
             input_mode: InputMode::Normal,
             focus: Focus::Clusters,
             command_input: String::new(),
+            splash_start: Some(Instant::now()),
             cluster_name,
             endpoint,
             client,
@@ -433,12 +439,26 @@ impl App {
     // Key handling
     // ------------------------------------------------------------------
 
+    /// Dismiss the splash screen and transition to the dashboard.
+    pub fn dismiss_splash(&mut self) {
+        if self.screen == Screen::Splash {
+            self.screen = Screen::Dashboard;
+            self.splash_start = None;
+        }
+    }
+
     pub fn handle_key(&mut self, key: KeyEvent) {
         if key.modifiers.contains(KeyModifiers::CONTROL) && key.code == KeyCode::Char('c') {
             self.running = false;
             return;
         }
 
+        // Splash screen: any key dismisses.
+        if self.screen == Screen::Splash {
+            self.dismiss_splash();
+            return;
+        }
+
         // Modals intercept all keys when open.
         if self.create_form.is_some() {
             self.handle_create_form_key(key);

crates/navigator-tui/src/lib.rs

@@ -25,6 +25,9 @@ use tonic::transport::{Certificate, Channel, ClientTlsConfig, Endpoint, Identity
 use app::{App, ClusterEntry, Focus, LogLine, Screen};
 use event::{Event, EventHandler};
 
+/// Duration to show the splash screen before auto-dismissing.
+const SPLASH_DURATION: Duration = Duration::from_secs(3);
+
 /// Launch the OpenShell TUI.
 ///
 /// `channel` must be a connected gRPC channel to the OpenShell gateway.
@@ -187,6 +190,15 @@ pub async fn run(channel: Channel, cluster_name: &str, endpoint: &str) -> Result
                 _ => {}
             },
             Some(Event::Tick) => {
+                // Auto-dismiss splash after SPLASH_DURATION.
+                if app.screen == Screen::Splash {
+                    if let Some(start) = app.splash_start {
+                        if start.elapsed() >= SPLASH_DURATION {
+                            app.dismiss_splash();
+                        }
+                    }
+                }
+
                 refresh_cluster_list(&mut app);
                 refresh_data(&mut app).await;
 

crates/navigator-tui/src/ui/mod.rs

@@ -9,6 +9,7 @@ pub(crate) mod sandbox_detail;
 pub(crate) mod sandbox_logs;
 mod sandbox_policy;
 pub(crate) mod sandboxes;
+mod splash;
 
 use ratatui::Frame;
 use ratatui::layout::{Constraint, Direction, Layout, Rect};
@@ -19,6 +20,12 @@ use crate::app::{self, App, Focus, InputMode, Screen};
 use crate::theme::styles;
 
 pub fn draw(frame: &mut Frame<'_>, app: &mut App) {
+    // Splash screen is a full-screen takeover — no chrome.
+    if app.screen == Screen::Splash {
+        splash::draw(frame, frame.size());
+        return;
+    }
+
     let chunks = Layout::default()
         .direction(Direction::Vertical)
         .constraints([
@@ -32,6 +39,7 @@ pub fn draw(frame: &mut Frame<'_>, app: &mut App) {
     draw_title_bar(frame, app, chunks[0]);
 
     match app.screen {
+        Screen::Splash => unreachable!(),
         Screen::Dashboard => dashboard::draw(frame, app, chunks[1]),
         Screen::Sandbox => draw_sandbox_screen(frame, app, chunks[1]),
     }
@@ -98,7 +106,14 @@ fn draw_title_bar(frame: &mut Frame<'_>, app: &App, area: Rect) {
     };
 
     let mut parts: Vec<Span<'_>> = vec![
-        Span::styled(" OpenShell", styles::ACCENT_BOLD),
+        Span::styled(" >_ OpenShell ", styles::ACCENT_BOLD),
+        Span::styled(
+            " ALPHA ",
+            ratatui::style::Style::new()
+                .fg(crate::theme::colors::BG)
+                .bg(crate::theme::colors::NVIDIA_GREEN)
+                .add_modifier(ratatui::style::Modifier::BOLD),
+        ),
         Span::styled(" | ", styles::MUTED),
         Span::styled("Current Cluster: ", styles::TEXT),
         Span::styled(&app.cluster_name, styles::HEADING),
@@ -109,6 +124,7 @@ fn draw_title_bar(frame: &mut Frame<'_>, app: &App, area: Rect) {
     ];
 
     match app.screen {
+        Screen::Splash => unreachable!("splash handled before draw_title_bar"),
         Screen::Dashboard => {
             parts.push(Span::styled("Dashboard", styles::TEXT));
         }
@@ -128,6 +144,7 @@ fn draw_title_bar(frame: &mut Frame<'_>, app: &App, area: Rect) {
 
 fn draw_nav_bar(frame: &mut Frame<'_>, app: &App, area: Rect) {
     let spans = match app.screen {
+        Screen::Splash => unreachable!("splash handled before draw_nav_bar"),
         Screen::Dashboard => match app.focus {
             Focus::Providers => vec![
                 Span::styled(" ", styles::TEXT),

crates/navigator-tui/src/ui/splash.rs

@@ -0,0 +1,157 @@
+// SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+//! Splash screen shown on TUI startup — the "B2 Framed" design.
+//!
+//! Renders the ANSI Shadow block-letter logo (OPEN in white, SHELL in green)
+//! inside a double-line border, with the tagline and a version/prompt footer.
+
+use ratatui::Frame;
+use ratatui::layout::{Alignment, Constraint, Direction, Layout, Rect};
+use ratatui::style::{Modifier, Style};
+use ratatui::text::{Line, Span};
+use ratatui::widgets::{Block, BorderType, Borders, Clear, Padding, Paragraph};
+
+use crate::theme::{colors, styles};
+
+// ---------------------------------------------------------------------------
+// ANSI Shadow figlet art — OPEN (6 lines, 35 display cols)
+// ---------------------------------------------------------------------------
+
+const OPEN_ART: [&str; 6] = [
+    " ██████╗ ██████╗ ███████╗███╗   ██╗",
+    "██╔═══██╗██╔══██╗██╔════╝████╗  ██║",
+    "██║   ██║██████╔╝█████╗  ██╔██╗ ██║",
+    "██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║",
+    "╚██████╔╝██║     ███████╗██║ ╚████║",
+    " ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝",
+];
+
+// ---------------------------------------------------------------------------
+// ANSI Shadow figlet art — SHELL (6 lines, 40 display cols)
+// ---------------------------------------------------------------------------
+
+const SHELL_ART: [&str; 6] = [
+    "███████╗██╗  ██╗███████╗██╗     ██╗",
+    "██╔════╝██║  ██║██╔════╝██║     ██║",
+    "███████╗███████║█████╗  ██║     ██║",
+    "╚════██║██╔══██║██╔══╝  ██║     ██║",
+    "███████║██║  ██║███████╗███████╗███████╗",
+    "╚══════╝╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝",
+];
+
+const TAGLINE: &str = "Shells Wide Shut.";
+
+/// Maximum display width of the art (SHELL line 5 is the widest at 40 cols).
+const ART_WIDTH: u16 = 40;
+
+/// Total content lines: 6 (OPEN) + 6 (SHELL) + 1 (blank) + 1 (tagline) = 14.
+const CONTENT_LINES: u16 = 14;
+
+// Border (2) + top/bottom inner padding (2) + content + blank before footer (1) + footer (1).
+const MODAL_HEIGHT: u16 = CONTENT_LINES + 6;
+
+// Art width + left/right padding (3+3) + borders (2).
+const MODAL_WIDTH: u16 = ART_WIDTH + 8;
+
+/// Draw the splash screen centered on the full terminal area.
+pub fn draw(frame: &mut Frame<'_>, area: Rect) {
+    let modal_w = MODAL_WIDTH.min(area.width.saturating_sub(2));
+    let modal_h = MODAL_HEIGHT.min(area.height.saturating_sub(2));
+
+    // Center the modal.
+    let popup = centered_rect(modal_w, modal_h, area);
+
+    // Clear the area behind the modal.
+    frame.render_widget(Clear, popup);
+
+    // Outer double-line border.
+    let block = Block::default()
+        .borders(Borders::ALL)
+        .border_type(BorderType::Double)
+        .border_style(Style::new().fg(colors::EVERGLADE))
+        .padding(Padding::new(3, 3, 1, 1));
+
+    let inner = block.inner(popup);
+    frame.render_widget(block, popup);
+
+    // Split inner area: art content + spacer + footer.
+    let chunks = Layout::default()
+        .direction(Direction::Vertical)
+        .constraints([
+            Constraint::Length(CONTENT_LINES), // OPEN + SHELL + blank + tagline
+            Constraint::Min(0),                // spacer
+            Constraint::Length(1),             // footer
+        ])
+        .split(inner);
+
+    // -- Art + tagline --
+    let open_style = Style::new().fg(colors::FG).add_modifier(Modifier::BOLD);
+    let shell_style = Style::new()
+        .fg(colors::NVIDIA_GREEN)
+        .add_modifier(Modifier::BOLD);
+
+    let mut content_lines: Vec<Line<'_>> = Vec::with_capacity(CONTENT_LINES as usize);
+
+    for line in &OPEN_ART {
+        content_lines.push(Line::from(Span::styled(*line, open_style)));
+    }
+    for line in &SHELL_ART {
+        content_lines.push(Line::from(Span::styled(*line, shell_style)));
+    }
+
+    // Blank + tagline.
+    content_lines.push(Line::from(""));
+    content_lines
+        .push(Line::from(Span::styled(TAGLINE, styles::MUTED)).alignment(Alignment::Center));
+
+    frame.render_widget(Paragraph::new(content_lines), chunks[0]);
+
+    // -- Footer: version + ALPHA badge (left) + prompt (right) --
+    let version = format!("v{}", env!("CARGO_PKG_VERSION"));
+    let spacer = " ";
+    let alpha_badge = "ALPHA";
+    let prompt_text = "press any key";
+
+    // Pad between left group and prompt to fill the line.
+    let used = version.len() + spacer.len() + alpha_badge.len() + prompt_text.len() + 2; // +2 for ░ and space
+    let footer_width = chunks[2].width as usize;
+    let gap = footer_width.saturating_sub(used);
+
+    let footer = Line::from(vec![
+        Span::styled(version, Style::new().fg(colors::NVIDIA_GREEN)),
+        Span::styled(spacer, styles::MUTED),
+        Span::styled(
+            alpha_badge,
+            Style::new()
+                .fg(colors::FG)
+                .bg(colors::EVERGLADE)
+                .add_modifier(Modifier::BOLD),
+        ),
+        Span::styled(" ".repeat(gap), styles::MUTED),
+        Span::styled(prompt_text, styles::MUTED),
+        Span::styled(" ░", styles::MUTED),
+    ]);
+
+    frame.render_widget(Paragraph::new(footer), chunks[2]);
+}
+
+fn centered_rect(width: u16, height: u16, area: Rect) -> Rect {
+    let vert = Layout::default()
+        .direction(Direction::Vertical)
+        .constraints([
+            Constraint::Length((area.height.saturating_sub(height)) / 2),
+            Constraint::Length(height),
+            Constraint::Min(0),
+        ])
+        .split(area);
+    let horiz = Layout::default()
+        .direction(Direction::Horizontal)
+        .constraints([
+            Constraint::Length((area.width.saturating_sub(width)) / 2),
+            Constraint::Length(width),
+            Constraint::Min(0),
+        ])
+        .split(vert[1]);
+    horiz[1]
+}