desktop

SKILL.md

Electron desktop development guide for LobeHub's main-renderer architecture.

Covers controller creation, IPC type definitions, renderer services, and store actions for adding new desktop features

Includes security best practices: input validation, limited API exposure, and preload script patterns for safe main-renderer communication

Provides structured references for feature implementation, local tools workflow, menu configuration, and window management

Emphasizes async methods, batch data transfers, and user feedback for performance and UX

Desktop Development Guide

Architecture Overview

LobeHub desktop is built on Electron with main-renderer architecture:

Main Process (apps/desktop/src/main): App lifecycle, system APIs, window management

Renderer Process: Reuses web code from src/

Preload Scripts (apps/desktop/src/preload): Securely expose main process to renderer

Adding New Desktop Features

1. Create Controller

Location: apps/desktop/src/main/controllers/

import { ControllerModule, IpcMethod } from '@/controllers';