How nilbuild/diffity works
Diffity is a macOS GitHub-style code-review app. A user opens a repository, selects a working-tree diff, commit, range, branch, or pull request, reviews rendered changes, and adds threads; reviews can be sent to Claude or submitted/synchronized with GitHub. The graph separates the React UI, frontend data bridge, Rust repository services, agent runtime, and GitHub integration. README statements support the documented product flows; source-index references and excerpts support only the cited internal connections, so unsampled implementation links are omitted.
Main entry points: tauri.ts Tauri bridge · repo-layout.tsx Repository views · service.rs PR review service · file-block.tsx Diff review
Components 22
Review interface
- App routing
src/App.tsx - Repository views
src/routes/repo-layout.tsx - Diff review
src/components/diff/file-block.tsx - Comment threads
src/components/comments/thread-card.tsx - File browser
src/components/tree/tree-page.tsx - Open projects
src/routes/welcome.tsx - Submit review
src/features/review/finish-review.tsx
Frontend data
- Frontend API
src/lib/api.ts - Tauri bridge
src/lib/tauri.ts - Query definitions
src/queries/diff.ts
Repository services
- App commands
src-tauri/src/commands - Diff and Git
src-tauri/src/core/diff.rs - File tree
src-tauri/src/core/tree.rs - Review storage
src-tauri/src/core/store.rs
Agent workflows
- Claude actions
src/features/claude/claude-runner.ts - Agent manager
src-tauri/src/agents/manager.rs - Agent session
src-tauri/src/agents/session.rs
GitHub integration
- PR review service
src-tauri/src/github/service.rs - GitHub API
src-tauri/src/github/graphql.rs
Other components
- Reviewer
- GitHub
- Claude Code
Connections 29
- Reviewer → Open projects: opens repository
README.md - Reviewer → Repository views: selects changes
README.md - App routing → Open projects: routes to
src/App.tsx - App routing → Repository views: routes to
src/App.tsx - Repository views → Diff review: shows diff
README.md - Repository views → File browser: opens files
README.md - Reviewer → Comment threads: adds comments
README.md - Diff review → Comment threads: anchors threads
README.md - Diff review → Query definitions: requests diff
src/components/diff/file-block.tsx - Query definitions → Frontend API: uses API
- Frontend API → Tauri bridge: fetches diff
src/lib/api.ts - Frontend API → Tauri bridge: loads threads
src/lib/api.ts - Tauri bridge → App commands: invokes commands
src/lib/tauri.ts - App commands → Diff and Git: serves repository data
- App commands → Review storage: persists review data
- Reviewer → Claude actions: starts Claude review
README.md - Comment threads → Claude actions: sends comments
README.md - Claude actions → Tauri bridge: starts agent action
src/features/claude/ask-claude-review.tsx - Tauri bridge → Agent manager: dispatches agent action
- Agent manager → Review storage: loads chat records
src-tauri/src/agents/manager.rs - Agent manager → Agent session: starts session
src-tauri/src/agents/manager.rs - Agent session → Claude Code: runs agent
README.md - Reviewer → Submit review: submits review
README.md - Submit review → Tauri bridge: posts review
src/lib/tauri.ts - Tauri bridge → PR review service: invokes review commands
- PR review service → GitHub API: queries GitHub
src-tauri/src/github/service.rs - GitHub API → GitHub: sends GraphQL
README.md - PR review service → Review storage: syncs thread IDs
src-tauri/src/github/service.rs - GitHub → PR review service: returns review data
README.md