butterfly/tauri2-guide
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
11 Commits 1 Branch 0 Tags 439 KiB
01fb4e9405
Commit Graph

11 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Z User
01fb4e9405 add base.md — LLM index with raw Gitea links for agents 
Contains clickable URLs to every guide/doc file so agents can fetch
individual files via HTTP without cloning the repo.
 2026-05-30 21:07:06 +00:00
Z User
368a3db23d Split guide files into <8k token chunks for small LLMs 
- definitive-guide.md → 2 parts (core/arch/config/commands + windows/plugins/websocket/state/migration)
- error-resolution-guide.md → 2 parts (build/config/plugin errors + runtime/platform/mobile errors)
- agent-prompts.md → 2 parts (system prompt/common tasks + advanced tasks/checklist/migration map)
- Updated README.md with new file structure and per-topic routing table
- All files under ~7.5k tokens, suitable for 8k context windows
- Cross-reference links between split parts
 2026-05-30 20:52:16 +00:00
Z User
5972c96ff9 Comprehensive improvements across all guide documents 
definitive-guide.md:
- Add missing AsyncReadExt import in streaming example
- Fix v1/v2 WindowUrl table entry (v1 used WindowUrl not WebviewUrl)
- Rename 3-Step Pattern to 4-Step Pattern for plugins

agent-prompts.md:
- Add new Section 15: Prompt for debugging build/compile errors

error-resolution-guide.md:
- Improve A3 lib naming convention explanation
- Clarify G3 multiple definition root cause
- Add actionable WebView2 install commands to H1
- Add O9-O11 mobile build errors (Android SDK, macOS, CocoaPods)

cheatsheet.md:
- Add deep linking subsection with plugin example
- Add gen/schemas/ to file hierarchy
- Fix tokio::spawn -> tauri::async_runtime::spawn in WS example
- Bump tokio-tungstenite 0.21 -> 0.24

ws_server_client_inject_guide.md:
- Add WebSocket.OPEN guard to sendToAllWindows()

tauri2-links.md:
- Expand from 6 to 16 official documentation links
 2026-05-30 20:45:20 +00:00
turtle89431
e01e542d65 rm old app 2026-05-30 13:37:39 -07:00
Z User
75f2a30722 Rewrite README as LLM-navigable reference index 2026-05-30 20:34:25 +00:00
Z User
e3a78f335a Add comprehensive Tauri 2.0 error resolution guide 
- tauri2-guide/error-resolution-guide.md: ~1700 lines covering 18 error categories
  with 65+ specific errors, exact messages, root causes, and working solutions:

  Category A: Rust compilation errors (Cargo build, version mismatch, edition,
    missing tools, windows crate hangs)
  Category B: v1->v2 migration compile errors (api removals, type renames,
    feature changes, JS import paths)
  Category C: Async command & thread safety errors (lifetime issues, Mutex/RwLock
    Send bounds, non-Send types)
  Category D: Configuration errors (v1 keys in v2 config, allowlist, frontendDist)
  Category E: Capabilities & permission errors (plugin not allowed, scope denied,
    shell scope)
  Category F: Plugin integration errors (registration, version conflicts)
  Category G: IPC/command runtime errors (command not found, serialize issues)
  Category H: Webview & window errors (WebView2, blank screens, unstable feature)
  Category I: Event system errors (race conditions, cross-window events)
  Category J: CSP errors (ipc.localhost, CSS-in-JS)
  Category K: Frontend integration (Vite, Next.js, SvelteKit issues)
  Category L: WebSocket errors (broken pipe, unstable connections)
  Category M: Path & asset protocol errors (403 forbidden, traversal)
  Category N: Shell & sidecar errors (binary not found, naming)
  Category O: Mobile build errors (iOS code signing, Android NDK, targets)
  Category P: Platform-specific build errors (Linux deps, ICNS, linuxdeploy)
  Category Q: Panics & runtime crashes
  Category R: Error handling best practices

  Plus a quick-reference table of the 25 most common errors.
 2026-05-30 19:59:54 +00:00
Z User
5e7cbbae47 Remove all moxie-app references — make guides standalone 
All documents now reference only Tauri 2.0 official patterns and APIs
with no dependency on any specific reference application.
 2026-05-30 19:29:03 +00:00
Z User
04c128f509 Add definitive Tauri 2.0 guide, agent prompts, and WebSocket docs 
- tauri2-guide/definitive-guide.md: Comprehensive Tauri 2.0 reference covering project structure, configuration, capabilities/permissions, commands/IPC, events/channels, window management, plugin ecosystem, WebSocket server, script injection, state management, v1->v2 migration, anti-patterns, and quick reference cheat sheet.

- tauri2-guide/agent-prompts.md: Copy-paste ready prompts for instructing AI agents to build Tauri 2.0 apps. Includes universal system prompt with sandbox constraints, 10 task-specific prompts, verification checklist, and v1->v2 API map.

- tauri2-docs/ws_server_client_inject_guide.md: Complete WebSocket server/client/script injection guide based on the moxie-app reference implementation. Covers the native Tokio WebSocket server pattern, frontend client connections, and script injection into external webview windows.

All code validated against Tauri 2.0 official docs (https://v2.tauri.app).
 2026-05-30 19:24:21 +00:00
turtle89431
7f8eb17292 update gitignore 2026-05-30 11:23:20 -07:00
turtle89431
5bf8e2f21f working app and docs 2026-05-30 10:44:44 -07:00
butterfly
f11762efbe Initial commit 2026-05-30 10:30:15 -07:00