AGENTS.md

Scope

This file applies to BitFun-Installer. Use the top-level AGENTS.md for repository-wide rules.

What matters here

BitFun-Installer is a separate Tauri + React app, not part of the main Cargo workspace.

Important areas called out by the module README:

src-tauri/src/installer/commands.rs: Tauri IPC and uninstall execution
src-tauri/src/installer/registry.rs: Windows registry integration
src-tauri/src/installer/shortcut.rs: shortcut creation
src-tauri/src/installer/extract.rs: archive extraction
src/hooks/useInstaller.ts: frontend installer state flow
src/i18n/: installer-only strings; locale metadata is generated from src/shared/i18n/contract/locales.json

Install flow:

Language Select → Options → Progress → Model Setup → Theme Setup

Commands

These are command references, not the default precheck list. Use Verification below for PR scope.

pnpm --dir BitFun-Installer run installer:dev
pnpm --dir BitFun-Installer run tauri:dev
pnpm --dir BitFun-Installer run type-check
pnpm --dir BitFun-Installer run build            # React build / CI reproduction
pnpm --dir BitFun-Installer run installer:build  # packaging only

Verification

Use the smallest matching check:

pnpm run i18n:audit                                                   # resource-only i18n
pnpm run i18n:generate && pnpm run i18n:contract:test && pnpm run i18n:audit
pnpm --dir BitFun-Installer run type-check                            # frontend i18n/runtime
cargo check --manifest-path BitFun-Installer/src-tauri/Cargo.toml      # Tauri/Rust changes

Run the full installer build only for packaging, payload, native bundling, install/uninstall flow, registry, shortcut, or extraction changes:

pnpm --dir BitFun-Installer run type-check && pnpm --dir BitFun-Installer run installer:build

If you modify uninstall flow, also validate the uninstall mode entry points described in BitFun-Installer/README.md.