# BotApp Development Prompt Guide

**Version:** 6.1.0  
**Purpose:** LLM context for BotApp desktop application development

---

## Project Overview

BotApp is a **Tauri-based desktop wrapper** for General Bots. It provides native desktop experience by wrapping botui's web interface with Tauri's native window capabilities.

### Workspace Position

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

### What BotApp Provides

- **Native Desktop Window**: Tauri-powered native application
- **System Tray**: Background operation with tray icon
- **File Dialogs**: Native file picker integration
- **Desktop Notifications**: OS-level notifications
- **Auto-Update**: Built-in update mechanism (future)

---

## Quick Start

```bash
# Ensure botserver is running
cd ../botserver && cargo run &

# Development mode
cd botapp
cargo tauri dev

# Production build
cargo tauri build
```

---

## Architecture

### Tauri Structure

```
botapp/
├── src/
│   └── main.rs           # Rust backend, Tauri commands
├── ui/                   # Frontend assets
│   └── app-guides/       # App-specific HTML
├── js/
│   └── app-extensions.js # JavaScript extensions
├── icons/                # App icons (all sizes)
├── tauri.conf.json       # Tauri configuration
├── Cargo.toml            # Rust dependencies
└── build.rs              # Build script
```

### Communication Flow

```
Native UI (HTML/CSS/JS)
    ↓ Tauri IPC (invoke)
Rust #[tauri::command]
    ↓ HTTP (reqwest)
BotServer API
    ↓
Business Logic + Database
```

---

## Code Generation Rules

### CRITICAL REQUIREMENTS

```
- Tauri commands must be async-safe
- All file operations use Tauri APIs
- No direct filesystem access from JS
- Desktop-specific features only in botapp
- Shared logic stays in botserver
- Zero warnings required
```

### Tauri Command Pattern

```rust
use tauri::command;

#[command]
pub async fn my_command(
    window: tauri::Window,
    param: String,
) -> Result<MyResponse, String> {
    // Implementation
    Ok(MyResponse { /* ... */ })
}

// Register in main.rs
fn main() {
    tauri::Builder::default()
        .invoke_handler(tauri::generate_handler![
            my_command,
        ])
        .run(tauri::generate_context!())
        .expect("error running app");
}
```

### JavaScript Invocation

```javascript
// From frontend
const result = await window.__TAURI__.invoke('my_command', {
    param: 'value'
});
```

---

## Feature Flags

```toml
[features]
default = ["desktop"]
desktop = []
desktop-tray = ["dep:ksni", "dep:trayicon"]
```

---

## Dependencies

| Library | Version | Purpose |
|---------|---------|---------|
| tauri | 2 | Desktop framework |
| tauri-plugin-dialog | 2 | File dialogs |
| tauri-plugin-opener | 2 | URL/file opener |
| botlib | path | Shared types |
| reqwest | 0.12 | HTTP client |
| tokio | 1.41 | Async runtime |

---

## Platform-Specific Code

### Unix (Linux/macOS)

```rust
#[cfg(unix)]
use ksni;  // System tray on Linux
```

### Windows

```rust
#[cfg(windows)]
use trayicon;  // System tray on Windows
use image;     // Icon handling
```

---

## Tauri Configuration (tauri.conf.json)

Key settings:

```json
{
  "build": {
    "devPath": "ui",
    "distDir": "ui"
  },
  "package": {
    "productName": "General Bots",
    "version": "6.1.0"
  },
  "tauri": {
    "allowlist": {
      "all": false,
      "dialog": { "all": true },
      "fs": { "all": true, "scope": ["$HOME/**"] }
    },
    "windows": [{
      "title": "General Bots",
      "width": 1200,
      "height": 800
    }]
  }
}
```

---

## Adding Features

### Process

1. **Check if feature belongs here** - Only desktop-specific features
2. **Add Tauri command** in `src/main.rs`
3. **Register handler** in `tauri::Builder`
4. **Add JS invocation** in `js/app-extensions.js`
5. **Update UI** if needed

### Example: Add Screenshot

```rust
// src/main.rs
#[tauri::command]
async fn take_screenshot(window: tauri::Window) -> Result<Vec<u8>, String> {
    // Use platform-specific screenshot API
    Ok(screenshot_bytes)
}
```

```javascript
// js/app-extensions.js
async function takeScreenshot() {
    return await window.__TAURI__.invoke('take_screenshot');
}
```

---

## Icons

Required icon sizes in `icons/`:

```
icon.ico          # Windows (256x256)
icon.icns         # macOS
icon.png          # Linux (512x512)
32x32.png
128x128.png
128x128@2x.png
```

---

## Building

### Development

```bash
cargo tauri dev
```

### Production

```bash
# All platforms
cargo tauri build

# Specific target
cargo tauri build --target x86_64-unknown-linux-gnu
cargo tauri build --target x86_64-pc-windows-msvc
cargo tauri build --target x86_64-apple-darwin
```

### Output Locations

```
target/release/bundle/
├── deb/          # Debian package
├── appimage/     # AppImage
├── msi/          # Windows installer
├── dmg/          # macOS disk image
└── macos/        # macOS app bundle
```

---

## Environment Variables

```bash
BOTSERVER_URL=http://localhost:8081  # BotServer location
TAURI_DEBUG=1                         # Debug mode
```

---

## Testing

```bash
# Build check
cargo build

# Run dev mode
cargo tauri dev

# Run tests
cargo test
```

---

## Rules

- **Desktop-only features** - Shared logic in botserver
- **Tauri APIs** - No direct fs access from JS
- **Platform abstractions** - Use cfg for platform code
- **Security** - Minimal allowlist in tauri.conf.json
- **Zero warnings** - Clean compilation required
- **No cargo audit** - Exempt per project requirements