botui/PROMPT.md

BotUI Development Prompt Guide

Version: 6.1.0
Purpose: LLM context for BotUI development

---

Project Overview

BotUI is a dual-mode UI application built in Rust that runs as either a desktop app (Tauri) or web server (Axum). All business logic is in botserver - BotUI is purely presentation + HTTP bridge.

Workspace Position

botui/         # THIS PROJECT - Web/Desktop UI
botserver/     # Main server (business logic)
botlib/        # Shared library (consumed here)
botapp/        # Desktop wrapper (consumes botui)
botbook/       # Documentation

What BotUI Provides

• Web Mode: Axum server serving HTML/CSS/JS UI on port 3000
• Desktop Mode: Tauri native application with same UI
• HTTP Bridge: Proxies all requests to botserver
• Local Assets: All JS/CSS bundled locally (no CDN)

---

Quick Start

# Terminal 1: Start BotServer
cd ../botserver && cargo run

# Terminal 2: Start BotUI (Web Mode)
cd ../botui && cargo run
# Visit http://localhost:3000

# OR Desktop Mode
cargo tauri dev

---

Architecture

Dual Modes

Mode	Command	Description
Web	cargo run	Axum server on port 3000
Desktop	cargo tauri dev	Tauri native window

Code Organization

src/
├── main.rs           # Entry point - mode detection
├── lib.rs            # Feature-gated module exports
├── http_client.rs    # HTTP wrapper for botserver (web-only)
├── ui_server/
│   └── mod.rs        # Axum router + UI serving (web-only)
├── desktop/
│   ├── mod.rs        # Desktop module organization
│   ├── drive.rs      # File operations via Tauri
│   ├── tray.rs       # System tray infrastructure
│   └── stream.rs     # Streaming operations
└── shared/
    └── state.rs      # Shared application state

ui/
├── suite/            # Main UI (HTML/CSS/JS)
│   ├── js/vendor/    # Local JS libraries (htmx, marked, etc.)
│   └── css/          # Stylesheets
└── minimal/          # Minimal chat UI
    └── js/vendor/    # Local JS libraries

---

Feature Gating

#[cfg(feature = "desktop")]     // Desktop build only
pub mod desktop;

#[cfg(not(feature = "desktop"))] // Web build only
pub mod http_client;

Build commands:

cargo build                    # Web mode (default)
cargo build --features desktop # Desktop mode
cargo tauri build              # Optimized desktop build

---

Code Generation Rules

CRITICAL REQUIREMENTS

- BotUI = Presentation + HTTP bridge ONLY
- All business logic goes in botserver
- No code duplication between layers
- Feature gates eliminate unused code paths
- Zero warnings - feature gating prevents dead code
- All JS/CSS must be local (no CDN)

Key Principles

1. Minimize Code - Only presentation and HTTP bridging
2. Feature Gating - Desktop code doesn't compile in web mode
3. HTTP Communication - All botserver calls through BotServerClient
4. Local Assets - All vendor JS in ui/*/js/vendor/

---

Local JS/CSS Vendor Files

All external libraries are bundled locally:

ui/suite/js/vendor/
├── htmx.min.js           # HTMX 1.9.10
├── htmx-ws.js            # HTMX WebSocket extension
├── htmx-json-enc.js      # HTMX JSON encoding
├── marked.min.js         # Markdown parser
├── gsap.min.js           # Animation library
├── alpinejs.min.js       # Alpine.js reactivity
└── livekit-client.umd.min.js  # LiveKit video

NEVER use CDN URLs - always reference local vendor files:

<!-- CORRECT -->
<script src="js/vendor/htmx.min.js"></script>

<!-- WRONG - DO NOT USE -->
<script src="https://unpkg.com/htmx.org@1.9.10"></script>

---

HTTP Client

pub struct BotServerClient {
    client: Arc<Client>,
    base_url: String,
}

impl BotServerClient {
    pub async fn get<T: Deserialize>(&self, endpoint: &str) -> Result<T, String>
    pub async fn post<T, R>(&self, endpoint: &str, body: &T) -> Result<R, String>
    pub async fn health_check(&self) -> bool
}

---

Adding Features

Process

1. Add business logic to botserver first
2. Create REST API endpoint in botserver
3. Add HTTP wrapper in BotUI
4. Add UI in ui/suite/
5. For desktop-specific: Add Tauri command in src/desktop/

Desktop Tauri Command

#[tauri::command]
pub fn list_files(path: &str) -> Result<Vec<FileItem>, String> {
    // Implementation
}

---

Environment Variables

BOTSERVER_URL=http://localhost:8081  # BotServer location
RUST_LOG=debug                        # Logging level

---

Dependencies

Library	Version	Purpose
axum	0.7.5	Web framework
reqwest	0.12	HTTP client
tokio	1.41	Async runtime
askama	0.12	Templates
diesel	2.1	Database (sqlite)

---

Testing

cargo build                    # Web mode
cargo build --features desktop # Desktop mode
cargo test
cargo run                      # Start web server
cargo tauri dev                # Start desktop app

---

Rules

• No business logic - only presentation
• No CDN - all assets local
• Feature gate - unused code never compiles
• Zero warnings - clean compilation
• HTTP bridge - all data from botserver