forked from imbytecat/fullstack-starter
imbytecat
29969550ed
- 移除 Tauri v2 代码 (src-tauri/, copy.ts) - 添加 Electrobun 配置和入口 (electrobun.config.ts, src/bun/index.ts) - 更新 package.json 使用 catalog 管理 electrobun 依赖 - 移除 server 中的 @tauri-apps/api 依赖 - 更新 AGENTS.md 文档
1.6 KiB
1.6 KiB
AGENTS.md - Desktop App Guidelines
Electrobun desktop shell - loads the server app in a native window.
Architecture
- Type: Electrobun desktop application
- Design: Bun main process + system webview (or CEF)
- Dev mode: Connects to
localhost:3000(requires server dev running) - Prod mode: Embeds server bundle and starts local HTTP server
Commands
# Development (from apps/desktop/)
bun dev # Start Electrobun dev mode
# Build
bun build # Build canary release
bun build:stable # Build stable release
Directory Structure
apps/desktop/
├── src/
│ └── bun/
│ └── index.ts # Electrobun main process entry
├── electrobun.config.ts # Electrobun configuration
├── package.json
└── tsconfig.json
Development Workflow
- Start server dev first:
cd ../server && bun dev - Start Electrobun:
bun dev(from apps/desktop/) - Electrobun connects to localhost:3000
Electrobun Patterns
BrowserWindow
import { BrowserWindow } from 'electrobun/bun'
new BrowserWindow({
title: 'My App',
url: 'http://localhost:3000',
frame: {
x: 100,
y: 100,
width: 1200,
height: 800,
},
})
Events
import Electrobun from 'electrobun/bun'
Electrobun.events.on('will-quit', () => {
console.log('App quitting...')
})
Critical Rules
DO:
- Run server dev before desktop dev
- Use
catalog:for dependencies - Handle server startup gracefully
DON'T:
- Hardcode dependency versions (use catalog)
- Block main thread during server wait