clue2app-cli 0.2.7__py3-none-any.whl

clue2app_cli/tui_wizard.py

@@ -0,0 +1,987 @@
+#!/usr/bin/env python3
+"""
+Textual-based Deploy Wizard with CSS animations for Clue2App CLI.
+
+This module provides a rich, animated TUI wizard experience using Textual,
+with smooth transitions, CSS styling, and reactive components.
+"""
+
+from __future__ import annotations
+
+import asyncio
+from dataclasses import dataclass, field
+from typing import Optional, List, Dict, Any, Callable
+
+from textual import on, work
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+from textual.containers import Container, Horizontal, Vertical, ScrollableContainer
+from textual.css.query import NoMatches
+from textual.reactive import reactive
+from textual.screen import Screen
+from textual.widgets import (
+    Button, Footer, Header, Input, Label, Static,
+    Select, Switch, ProgressBar, Rule, LoadingIndicator,
+    Checkbox, RadioSet, RadioButton, TabbedContent, TabPane,
+)
+from textual.timer import Timer
+
+from rich.text import Text
+from rich.panel import Panel
+from rich.table import Table
+
+
+# ============================================================================
+# CSS Styles
+# ============================================================================
+
+WIZARD_CSS = """
+Screen {
+    background: $surface;
+}
+
+/* Step Indicator Styles */
+#step-indicator-container {
+    height: auto;
+    padding: 0;
+    margin: 0;
+}
+
+#step-indicator {
+    height: 3;
+    width: 100%;
+    background: $panel;
+    border: solid $primary;
+    padding: 0 2;
+}
+
+.step-container {
+    width: 100%;
+    height: 3;
+    align: center middle;
+}
+
+.step {
+    width: auto;
+    height: 3;
+    padding: 0 1;
+}
+
+.step-circle {
+    width: 3;
+    height: 3;
+    content-align: center middle;
+    border: solid $secondary;
+    text-style: bold;
+}
+
+.step-circle.active {
+    background: $primary;
+    border: solid $primary;
+    color: $text;
+    text-style: bold;
+}
+
+.step-circle.completed {
+    background: $success;
+    border: solid $success;
+    color: $text;
+}
+
+.step-label {
+    padding: 0 1;
+    color: $text-muted;
+}
+
+.step-label.active {
+    color: $primary;
+    text-style: bold;
+}
+
+.step-label.completed {
+    color: $success;
+}
+
+.step-connector {
+    width: 5;
+    height: 1;
+    margin-top: 1;
+    background: $secondary;
+}
+
+.step-connector.completed {
+    background: $success;
+}
+
+/* Content Area */
+#content-area {
+    height: 1fr;
+    padding: 0 1;
+    background: $surface;
+}
+
+.wizard-step {
+    width: 100%;
+    height: auto;
+    min-height: 10;
+    padding: 1 2;
+    background: $panel;
+    border: solid $primary-lighten-2;
+}
+
+.step-title {
+    text-style: bold;
+    color: $primary;
+    padding-bottom: 1;
+}
+
+.step-description {
+    color: $text-muted;
+    padding-bottom: 1;
+}
+
+.form-group {
+    margin-bottom: 1;
+}
+
+.form-label {
+    padding-bottom: 0;
+    color: $text;
+}
+
+.form-input {
+    margin-bottom: 1;
+}
+
+/* Footer Actions */
+#footer-actions {
+    height: 5;
+    padding: 1 2;
+    background: $panel;
+    border-top: solid $primary-lighten-2;
+    align: center middle;
+}
+
+#footer-actions Button {
+    margin: 0 1;
+}
+
+.btn-primary {
+    background: $primary;
+}
+
+.btn-secondary {
+    background: $secondary;
+}
+
+.btn-success {
+    background: $success;
+}
+
+/* Build Progress */
+#build-progress {
+    height: 100%;
+    padding: 2;
+}
+
+.progress-header {
+    text-style: bold;
+    color: $primary;
+    padding-bottom: 1;
+}
+
+.phase-item {
+    padding: 0 1;
+    margin-bottom: 0;
+}
+
+.phase-icon {
+    width: 3;
+}
+
+.phase-icon.pending {
+    color: $text-muted;
+}
+
+.phase-icon.running {
+    color: $primary;
+}
+
+.phase-icon.completed {
+    color: $success;
+}
+
+.phase-name {
+    padding-left: 1;
+}
+
+.log-container {
+    height: 8;
+    border: solid $secondary;
+    padding: 1;
+    margin-top: 1;
+    background: $surface-darken-1;
+}
+
+/* Animations - Textual transitions */
+.fade-in {
+    opacity: 1;
+}
+
+.hidden {
+    display: none;
+}
+
+/* Review Table */
+.review-section {
+    margin-bottom: 1;
+    padding: 1;
+    background: $surface;
+    border: solid $secondary;
+}
+
+.review-title {
+    text-style: bold;
+    color: $primary;
+    padding-bottom: 1;
+}
+
+.review-row {
+    padding: 0 1;
+}
+
+.review-label {
+    width: 20;
+    color: $text-muted;
+}
+
+.review-value {
+    color: $text;
+}
+"""
+
+
+# ============================================================================
+# Step Indicator Widget
+# ============================================================================
+
+class StepIndicator(Static):
+    """Animated step indicator showing wizard progress."""
+
+    STEPS = ["Basics", "Source", "Registry", "Settings", "Review"]
+
+    current_step = reactive(0)
+    completed_steps = reactive(set())
+
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+        self.completed_steps = set()
+
+    def render(self) -> Text:
+        """Render the step indicator."""
+        text = Text()
+
+        for i, step_name in enumerate(self.STEPS):
+            # Determine state
+            if i in self.completed_steps:
+                icon = "✓"
+                icon_style = "bold green"
+                label_style = "green"
+            elif i == self.current_step:
+                icon = "●"
+                icon_style = "bold blue"
+                label_style = "bold blue"
+            else:
+                icon = "○"
+                icon_style = "dim"
+                label_style = "dim"
+
+            text.append(f" {icon} ", style=icon_style)
+            text.append(step_name, style=label_style)
+
+            # Add connector
+            if i < len(self.STEPS) - 1:
+                connector_style = "green" if i in self.completed_steps else "dim"
+                text.append(" ─── ", style=connector_style)
+
+        return text
+
+    def set_step(self, step: int):
+        """Set the current step."""
+        self.current_step = step
+        self.refresh()
+
+    def complete_step(self, step: int):
+        """Mark a step as completed."""
+        self.completed_steps = self.completed_steps | {step}
+        self.refresh()
+
+
+# ============================================================================
+# Form Widgets
+# ============================================================================
+
+class FormInput(Vertical):
+    """A styled form input with label."""
+
+    def __init__(self, label: str, input_id: str, placeholder: str = "", password: bool = False, **kwargs):
+        super().__init__(**kwargs)
+        self.label_text = label
+        self.input_id = input_id
+        self.placeholder = placeholder
+        self.password = password
+
+    def compose(self) -> ComposeResult:
+        yield Label(self.label_text, classes="form-label")
+        yield Input(
+            placeholder=self.placeholder,
+            password=self.password,
+            id=self.input_id,
+            classes="form-input",
+        )
+
+
+class FormSelect(Vertical):
+    """A styled form select with label."""
+
+    def __init__(self, label: str, select_id: str, options: List[tuple], **kwargs):
+        super().__init__(**kwargs)
+        self.label_text = label
+        self.select_id = select_id
+        self.options = options
+
+    def compose(self) -> ComposeResult:
+        yield Label(self.label_text, classes="form-label")
+        yield Select(
+            options=self.options,
+            id=self.select_id,
+            classes="form-input",
+        )
+
+
+# ============================================================================
+# Wizard Steps
+# ============================================================================
+
+class BasicsStep(Vertical):
+    """Step 1: Application basics."""
+
+    def __init__(self, projects: List[Dict] = None, **kwargs):
+        super().__init__(**kwargs)
+        self.projects = projects or []
+
+    def compose(self) -> ComposeResult:
+        yield Static("📱 Application Basics", classes="step-title")
+        yield Static("Give your application a name and select target project", classes="step-description")
+        yield Rule()
+        yield FormInput(
+            "Application Name *",
+            "input-app-name",
+            placeholder="my-awesome-app",
+        )
+        # Project selection (if multiple projects available)
+        if len(self.projects) > 1:
+            project_options = [
+                (f"{p.get('name')} ({p.get('ns', 'default')})", p.get('id'))
+                for p in self.projects
+            ]
+            yield FormSelect("Target Project", "select-project", options=project_options)
+
+    def get_data(self) -> Dict[str, Any]:
+        data = {}
+        try:
+            app_name_input = self.query_one("#input-app-name", Input)
+            data["app_name"] = app_name_input.value
+            # Get selected project if available
+            try:
+                project_select = self.query_one("#select-project", Select)
+                if project_select.value:
+                    data["project_id"] = project_select.value
+            except NoMatches:
+                pass
+        except NoMatches:
+            pass
+        return data
+
+
+class SourceStep(Vertical):
+    """Step 2: Source code configuration."""
+
+    def compose(self) -> ComposeResult:
+        yield Static("📦 Source Code", classes="step-title")
+        yield Static("Configure your Git repository", classes="step-description")
+        yield Rule()
+        yield FormInput(
+            "Git Repository URL *",
+            "input-git-url",
+            placeholder="https://github.com/user/repo.git",
+        )
+        yield FormSelect(
+            "Branch",
+            "select-branch",
+            options=[("main", "main"), ("master", "master"), ("develop", "develop")],
+        )
+        with Horizontal():
+            yield Checkbox("Private Repository", id="private_repo")
+        yield Container(
+            FormInput("Git Token", "input-git-token", placeholder="ghp_...", password=True),
+            id="git-token-container",
+            classes="hidden",
+        )
+
+    @on(Checkbox.Changed, "#private_repo")
+    def toggle_token_field(self, event: Checkbox.Changed):
+        """Show/hide token field based on private repo checkbox."""
+        container = self.query_one("#git-token-container")
+        if event.value:
+            container.remove_class("hidden")
+        else:
+            container.add_class("hidden")
+
+    def get_data(self) -> Dict[str, Any]:
+        data = {}
+        try:
+            data["git_url"] = self.query_one("#input-git-url", Input).value
+            data["branch"] = self.query_one("#select-branch", Select).value or "main"
+            data["is_private"] = self.query_one("#private_repo", Checkbox).value
+            if data["is_private"]:
+                data["git_token"] = self.query_one("#input-git-token", Input).value
+        except NoMatches:
+            pass
+        return data
+
+
+class RegistryStep(Vertical):
+    """Step 3: Container registry configuration."""
+
+    def compose(self) -> ComposeResult:
+        yield Static("🐳 Container Registry", classes="step-title")
+        yield Static("Choose where to store your container images", classes="step-description")
+        yield Rule()
+        yield RadioSet(
+            RadioButton("Platform Registry (Recommended)", id="platform_registry", value=True),
+            RadioButton("Private Registry", id="private_registry"),
+            id="registry_type",
+        )
+        yield Container(
+            FormInput("Registry URL", "input-registry-url", placeholder="docker.io"),
+            FormInput("Username", "input-registry-user", placeholder="username"),
+            FormInput("Password", "input-registry-pass", password=True),
+            id="private-registry-fields",
+            classes="hidden",
+        )
+
+    @on(RadioSet.Changed, "#registry_type")
+    def toggle_registry_fields(self, event: RadioSet.Changed):
+        """Show/hide private registry fields."""
+        container = self.query_one("#private-registry-fields")
+        if event.pressed and event.pressed.id == "private_registry":
+            container.remove_class("hidden")
+        else:
+            container.add_class("hidden")
+
+    def get_data(self) -> Dict[str, Any]:
+        data = {}
+        try:
+            radio_set = self.query_one("#registry_type", RadioSet)
+            pressed = radio_set.pressed_button
+            if pressed and pressed.id == "private_registry":
+                data["registry_type"] = "PRIVATE_REGISTRY"
+                data["registry_url"] = self.query_one("#input-registry-url", Input).value
+                data["registry_user"] = self.query_one("#input-registry-user", Input).value
+                data["registry_pass"] = self.query_one("#input-registry-pass", Input).value
+            else:
+                data["registry_type"] = "PLATFORM_REGISTRY"
+        except (NoMatches, AttributeError):
+            data["registry_type"] = "PLATFORM_REGISTRY"
+        return data
+
+
+class SettingsStep(Vertical):
+    """Step 4: Application settings."""
+
+    def compose(self) -> ComposeResult:
+        yield Static("⚙️ Application Settings", classes="step-title")
+        yield Static("Configure deployment, scaling, and environment", classes="step-description")
+        yield Rule()
+        yield FormInput("Container Port *", "input-port", placeholder="8080")
+        yield FormSelect(
+            "Application Size",
+            "select-size",
+            options=[
+                ("TINY", "Tiny (256MB, 0.25 CPU)"),
+                ("SMALL", "Small (512MB, 0.5 CPU)"),
+                ("MEDIUM", "Medium (1GB, 1 CPU)"),
+                ("LARGE", "Large (2GB, 2 CPU)"),
+            ],
+        )
+        with Horizontal():
+            yield Checkbox("Deploy Automatically", id="auto_deploy", value=True)
+            yield Checkbox("Scale to Zero", id="scale_to_zero")
+
+    def get_data(self) -> Dict[str, Any]:
+        data = {}
+        try:
+            data["port"] = int(self.query_one("#input-port", Input).value or "8080")
+            data["size"] = self.query_one("#select-size", Select).value or "SMALL"
+            data["auto_deploy"] = self.query_one("#auto_deploy", Checkbox).value
+            data["scale_to_zero"] = self.query_one("#scale_to_zero", Checkbox).value
+        except (NoMatches, ValueError):
+            data["port"] = 8080
+            data["size"] = "SMALL"
+            data["auto_deploy"] = True
+            data["scale_to_zero"] = False
+        return data
+
+
+class ReviewStep(Vertical):
+    """Step 5: Review and deploy."""
+
+    def __init__(self, wizard_data: Dict[str, Any], **kwargs):
+        super().__init__(**kwargs)
+        self.wizard_data = wizard_data
+
+    def compose(self) -> ComposeResult:
+        yield Static("🚀 Review & Deploy", classes="step-title")
+        yield Static("Review your configuration before deploying", classes="step-description")
+        yield Rule()
+
+        # Basic Info
+        yield Static("[bold]BASIC INFO[/bold]", classes="review-title")
+        yield Static(f"  Application Name: {self.wizard_data.get('app_name', 'N/A')}")
+        if self.wizard_data.get('project_id'):
+            yield Static(f"  Project: {self.wizard_data.get('project_id')}")
+
+        # Source Code
+        yield Static("\n[bold]SOURCE CODE[/bold]", classes="review-title")
+        yield Static(f"  Git Repository: {self.wizard_data.get('git_url', 'N/A')}")
+        yield Static(f"  Branch: {self.wizard_data.get('branch', 'main')}")
+        yield Static(f"  Access: {'Private' if self.wizard_data.get('is_private') else 'Public'}")
+
+        # Registry
+        yield Static("\n[bold]CONTAINER REGISTRY[/bold]", classes="review-title")
+        registry = self.wizard_data.get('registry_type', 'PLATFORM_REGISTRY')
+        if registry == "PLATFORM_REGISTRY":
+            yield Static("  Registry: Platform Registry")
+        else:
+            yield Static(f"  Registry: {self.wizard_data.get('registry_url', 'N/A')}")
+
+        # Settings
+        yield Static("\n[bold]SETTINGS[/bold]", classes="review-title")
+        yield Static(f"  Container Port: {self.wizard_data.get('port', 8080)}")
+        yield Static(f"  Application Size: {self.wizard_data.get('size', 'SMALL')}")
+        yield Static(f"  Auto Deploy: {'Yes' if self.wizard_data.get('auto_deploy', True) else 'No'}")
+        yield Static(f"  Scale to Zero: {'Yes' if self.wizard_data.get('scale_to_zero') else 'No'}")
+
+
+# ============================================================================
+# Build Progress Screen
+# ============================================================================
+
+class BuildProgressScreen(Screen):
+    """Screen showing live build progress."""
+
+    BINDINGS = [
+        Binding("escape", "cancel", "Run in Background"),
+        Binding("enter", "exit_screen", "Exit", show=False),
+    ]
+
+    def __init__(self, app_name: str, namespace: str, sdk_client=None, **kwargs):
+        super().__init__(**kwargs)
+        self.app_name = app_name
+        self.namespace = namespace
+        self.sdk_client = sdk_client
+        self.current_phase = 0
+        self.service_phase = 0
+        self.build_status = "BUILDING"  # BUILDING, DEPLOYING, SUCCESS, FAILED
+        self.app_url: str = ""
+        self.error_message: str = ""
+        self.build_phases = [
+            ("FETCH", "Fetching source code"),
+            ("DETECT", "Detecting buildpacks"),
+            ("ANALYZE", "Analyzing dependencies"),
+            ("BUILD", "Building application"),
+            ("EXPORT", "Exporting container image"),
+        ]
+        self.service_phases = [
+            ("PENDING", "Service pending"),
+            ("CREATING", "Creating pods"),
+            ("CONFIGURING", "Configuring networking"),
+            ("SCALING", "Scaling replicas"),
+            ("READY", "Service ready"),
+        ]
+
+    def compose(self) -> ComposeResult:
+        yield Header(show_clock=True)
+        with Container(id="build-progress"):
+            yield Static(f"🚀 Deploying: {self.app_name}", classes="progress-header", id="main-header")
+            yield Static("", id="elapsed-time")
+            yield Rule()
+
+            # Build phases
+            yield Static("[bold]BUILD PROGRESS[/bold]", classes="section-header")
+            with Vertical(id="build-phases-list"):
+                for phase_name, phase_desc in self.build_phases:
+                    with Horizontal(classes="phase-item"):
+                        yield Static("○", classes="phase-icon pending", id=f"build-icon-{phase_name}")
+                        yield Static(f"{phase_name}: {phase_desc}", classes="phase-name")
+
+            yield Rule()
+
+            # Service deployment phases
+            yield Static("[bold]SERVICE DEPLOYMENT[/bold]", classes="section-header")
+            with Vertical(id="service-phases-list"):
+                for phase_name, phase_desc in self.service_phases:
+                    with Horizontal(classes="phase-item"):
+                        yield Static("○", classes="phase-icon pending", id=f"svc-icon-{phase_name}")
+                        yield Static(f"{phase_name}: {phase_desc}", classes="phase-name")
+
+            yield Rule()
+            yield Static("", id="app-url")
+            yield Static("", id="build-status")
+            yield ProgressBar(id="progress-bar", show_eta=False)
+        yield Footer()
+
+    def on_mount(self):
+        """Start the progress animation."""
+        self.start_time = asyncio.get_event_loop().time()
+        self.last_poll_time = 0
+        self.set_interval(0.5, self.update_ui)
+        self.set_interval(1.0, self.update_timer)
+        self.set_interval(3.0, self.poll_status)  # Poll API every 3 seconds
+
+    def update_timer(self):
+        """Update elapsed time display."""
+        elapsed = int(asyncio.get_event_loop().time() - self.start_time)
+        minutes, seconds = divmod(elapsed, 60)
+        self.query_one("#elapsed-time", Static).update(f"Elapsed: {minutes}m {seconds}s")
+
+    def poll_status(self):
+        """Poll the API for build/service status."""
+        if self.build_status in ("SUCCESS", "FAILED"):
+            return
+
+        if not self.sdk_client:
+            # Demo mode - simulate progress
+            self._simulate_progress()
+            return
+
+        try:
+            image_name = f"{self.app_name}-image"
+            images = self.sdk_client.apps.get_images(namespace=self.namespace)
+
+            for img in images:
+                if image_name in img.get('metadata', {}).get('name', ''):
+                    status = img.get('status', {})
+                    conditions = status.get('conditions', [])
+
+                    for cond in conditions:
+                        if cond.get('type') == 'Ready':
+                            if cond.get('status') == 'True':
+                                if self.build_status == "BUILDING":
+                                    self.build_status = "DEPLOYING"
+                                    self.current_phase = len(self.build_phases)
+                                elif self.build_status == "DEPLOYING":
+                                    self.build_status = "SUCCESS"
+                                    self.service_phase = len(self.service_phases)
+                                    self.app_url = f"https://{self.app_name}.{self.namespace}.apps.clue2.app"
+                            else:
+                                reason = cond.get('reason', '')
+                                if 'Failed' in reason or 'Error' in reason:
+                                    self.build_status = "FAILED"
+                                    self.error_message = cond.get('message', 'Deployment failed')
+                            break
+                    break
+        except Exception as e:
+            self.error_message = str(e)
+
+    def _simulate_progress(self):
+        """Simulate progress for demo mode."""
+        elapsed = asyncio.get_event_loop().time() - self.start_time
+
+        if self.build_status == "BUILDING":
+            self.current_phase = min(int(elapsed / 3), len(self.build_phases))
+            if self.current_phase >= len(self.build_phases):
+                self.build_status = "DEPLOYING"
+        elif self.build_status == "DEPLOYING":
+            build_time = len(self.build_phases) * 3
+            deploy_elapsed = elapsed - build_time
+            self.service_phase = min(int(deploy_elapsed / 2), len(self.service_phases))
+            if self.service_phase >= len(self.service_phases):
+                self.build_status = "SUCCESS"
+                self.app_url = f"https://{self.app_name}.{self.namespace}.apps.clue2.app"
+
+    def update_ui(self):
+        """Update the UI based on current status."""
+        # Update build phase icons
+        for i, (phase_name, _) in enumerate(self.build_phases):
+            try:
+                icon = self.query_one(f"#build-icon-{phase_name}", Static)
+                if self.build_status in ("DEPLOYING", "SUCCESS"):
+                    icon.update("[green]✓[/green]")
+                elif i < self.current_phase:
+                    icon.update("[green]✓[/green]")
+                elif i == self.current_phase and self.build_status == "BUILDING":
+                    icon.update("[blue]◉[/blue]")
+                else:
+                    icon.update("○")
+            except NoMatches:
+                pass
+
+        # Update service phase icons
+        for i, (phase_name, _) in enumerate(self.service_phases):
+            try:
+                icon = self.query_one(f"#svc-icon-{phase_name}", Static)
+                if self.build_status == "SUCCESS":
+                    icon.update("[green]✓[/green]")
+                elif self.build_status == "DEPLOYING":
+                    if i < self.service_phase:
+                        icon.update("[green]✓[/green]")
+                    elif i == self.service_phase:
+                        icon.update("[blue]◉[/blue]")
+                    else:
+                        icon.update("○")
+                else:
+                    icon.update("○")
+            except NoMatches:
+                pass
+
+        # Update progress bar
+        total_phases = len(self.build_phases) + len(self.service_phases)
+        if self.build_status == "BUILDING":
+            progress = self.current_phase / total_phases
+        elif self.build_status == "DEPLOYING":
+            progress = (len(self.build_phases) + self.service_phase) / total_phases
+        else:
+            progress = 1.0 if self.build_status == "SUCCESS" else 0.5
+
+        try:
+            self.query_one("#progress-bar", ProgressBar).update(progress=progress * 100)
+        except NoMatches:
+            pass
+
+        # Update status message
+        try:
+            status_widget = self.query_one("#build-status", Static)
+            if self.build_status == "BUILDING":
+                status_widget.update("[blue]● Building application...[/blue]")
+            elif self.build_status == "DEPLOYING":
+                status_widget.update("[blue]● Deploying service...[/blue]")
+            elif self.build_status == "SUCCESS":
+                status_widget.update("[green]✓ Deployment complete![/green]")
+            elif self.build_status == "FAILED":
+                status_widget.update(f"[red]✗ Failed: {self.error_message}[/red]")
+        except NoMatches:
+            pass
+
+        # Update URL display
+        if self.app_url:
+            try:
+                url_widget = self.query_one("#app-url", Static)
+                url_widget.update(f"[bold]Application URL:[/bold] [cyan]{self.app_url}[/cyan]")
+            except NoMatches:
+                pass
+
+        # Update header
+        try:
+            header = self.query_one("#main-header", Static)
+            if self.build_status == "SUCCESS":
+                header.update(f"✓ Deployed: {self.app_name}")
+            elif self.build_status == "FAILED":
+                header.update(f"✗ Failed: {self.app_name}")
+        except NoMatches:
+            pass
+
+    def action_cancel(self):
+        """Exit and run in background."""
+        self.app.pop_screen()
+
+    def action_exit_screen(self):
+        """Exit when deployment is complete."""
+        if self.build_status in ("SUCCESS", "FAILED"):
+            self.app.pop_screen()
+
+
+# ============================================================================
+# Main Wizard App
+# ============================================================================
+
+class DeployWizardApp(App):
+    """Main Textual application for the deploy wizard."""
+
+    CSS = WIZARD_CSS
+    TITLE = "🚀 Deploy Application Wizard"
+
+    BINDINGS = [
+        Binding("escape", "quit", "Cancel"),
+        Binding("ctrl+c", "quit", "Cancel"),
+        Binding("ctrl+n", "next_step", "Next", show=True),
+        Binding("ctrl+b", "prev_step", "Back", show=True),
+        Binding("ctrl+enter", "next_step", "Next/Deploy"),
+        Binding("f2", "prev_step", "Previous"),
+        Binding("f3", "next_step", "Next"),
+    ]
+
+    current_step = reactive(0)
+    wizard_data: Dict[str, Any] = {}
+
+    def __init__(self, projects: List[Dict] = None, deploy_func: Callable = None, sdk_client=None, **kwargs):
+        super().__init__(**kwargs)
+        self.projects = projects or []
+        self.deploy_func = deploy_func
+        self.sdk_client = sdk_client
+        self.wizard_data = {}
+        self.steps = []
+
+    def compose(self) -> ComposeResult:
+        yield Header(show_clock=True)
+        yield Container(
+            StepIndicator(id="step-indicator"),
+            id="step-indicator-container",
+        )
+        yield ScrollableContainer(id="content-area")
+        with Horizontal(id="footer-actions"):
+            yield Button("Cancel", id="btn-cancel", variant="default")
+            yield Button("← Previous", id="btn-prev", variant="default", disabled=True)
+            yield Button("Next →", id="btn-next", variant="primary")
+        yield Footer()
+
+    def on_mount(self):
+        """Initialize the wizard."""
+        self.show_step(0)
+
+    def show_step(self, step: int):
+        """Display a specific step."""
+        self.current_step = step
+
+        # Update step indicator
+        indicator = self.query_one("#step-indicator", StepIndicator)
+        indicator.set_step(step)
+
+        # Update content
+        content = self.query_one("#content-area", ScrollableContainer)
+        content.remove_children()
+
+        if step == 0:
+            content.mount(BasicsStep(projects=self.projects, classes="wizard-step fade-in"))
+        elif step == 1:
+            content.mount(SourceStep(classes="wizard-step fade-in"))
+        elif step == 2:
+            content.mount(RegistryStep(classes="wizard-step fade-in"))
+        elif step == 3:
+            content.mount(SettingsStep(classes="wizard-step fade-in"))
+        elif step == 4:
+            content.mount(ReviewStep(self.wizard_data, classes="wizard-step fade-in"))
+
+        # Update buttons
+        self.query_one("#btn-prev", Button).disabled = (step == 0)
+        next_btn = self.query_one("#btn-next", Button)
+        if step == 4:
+            next_btn.label = "🚀 Deploy"
+            next_btn.variant = "success"
+        else:
+            next_btn.label = "Next →"
+            next_btn.variant = "primary"
+
+    def collect_step_data(self) -> Dict[str, Any]:
+        """Collect data from the current step."""
+        content = self.query_one("#content-area", ScrollableContainer)
+        children = list(content.children)
+        if children and hasattr(children[0], 'get_data'):
+            return children[0].get_data()
+        return {}
+
+    @on(Button.Pressed, "#btn-cancel")
+    def on_cancel(self):
+        """Handle cancel button."""
+        self.exit(None)
+
+    @on(Button.Pressed, "#btn-prev")
+    def on_previous(self):
+        """Handle previous button."""
+        self.action_prev_step()
+
+    def action_prev_step(self):
+        """Go to previous step (keyboard shortcut: Ctrl+P)."""
+        if self.current_step > 0:
+            self.show_step(self.current_step - 1)
+
+    @on(Button.Pressed, "#btn-next")
+    def on_next(self):
+        """Handle next button."""
+        self.action_next_step()
+
+    def action_next_step(self):
+        """Go to next step or deploy (keyboard shortcut: Ctrl+N or Ctrl+Enter)."""
+        # Collect current step data
+        step_data = self.collect_step_data()
+        self.wizard_data.update(step_data)
+
+        # Mark step as completed
+        indicator = self.query_one("#step-indicator", StepIndicator)
+        indicator.complete_step(self.current_step)
+
+        if self.current_step < 4:
+            # Go to next step
+            self.show_step(self.current_step + 1)
+        else:
+            # Deploy
+            self.wizard_data['confirmed'] = True
+            if self.deploy_func:
+                self.run_deployment()
+            else:
+                self.exit(self.wizard_data)
+
+    @work
+    async def run_deployment(self):
+        """Run the deployment and show progress."""
+        # Call deploy function first to initiate deployment
+        if self.deploy_func:
+            try:
+                self.deploy_func(self.wizard_data)
+            except Exception as e:
+                self.notify(f"Deployment error: {e}", severity="error")
+                return
+
+        # Get namespace from wizard data
+        namespace = self.wizard_data.get('namespace') or \
+                    self.wizard_data.get('project', {}).get('ns', 'default')
+
+        # Push build progress screen with SDK client for live updates
+        await self.push_screen(BuildProgressScreen(
+            app_name=self.wizard_data.get('app_name', 'app'),
+            namespace=namespace,
+            sdk_client=self.sdk_client,
+        ))
+
+        # Wait for screen to complete (will be popped when done)
+        # The screen handles its own exit via action_exit_screen
+
+
+# ============================================================================
+# Public API
+# ============================================================================
+
+def run_textual_wizard(projects: List[Dict] = None, deploy_func: Callable = None, sdk_client=None) -> Optional[Dict[str, Any]]:
+    """
+    Run the Textual-based deploy wizard.
+
+    Args:
+        projects: List of available projects
+        deploy_func: Function to call for actual deployment
+        sdk_client: SDK client for API calls and live progress monitoring
+
+    Returns:
+        Wizard data if completed, None if cancelled
+    """
+    app = DeployWizardApp(projects=projects, deploy_func=deploy_func, sdk_client=sdk_client)
+    return app.run()
+
+
+if __name__ == "__main__":
+    # Demo mode
+    result = run_textual_wizard()
+    if result:
+        print(f"Wizard completed with data: {result}")
+    else:
+        print("Wizard cancelled")