-
Notifications
You must be signed in to change notification settings - Fork 0
Home
factory-droid[bot] edited this page Jul 5, 2026
·
3 revisions
QA Scribe is a local-first desktop testing notepad that helps testers capture a bounded testing Session and turn the raw material into structured Testware. The current application is a Rust/Tauri 2 desktop app with a React/Vite renderer, a Rust-owned SQLite store, and optional AI generation through already-authenticated local CLI tools.
QA Scribe collects Notes, Findings, Drafts, screenshots, logs, API responses, and context in a local Session Library. The product language comes from CONTEXT.md, while the current implementation is described in README.md and split across crates/qa-scribe-core, src-tauri, and frontend.
| Area | Where to start | Purpose |
|---|---|---|
| Desktop app | src-tauri/src/main.rs |
Opens the app-data directory, SQLite database, Tauri state, and command handler. |
| Rust core | crates/qa-scribe-core/src/lib.rs |
Exports domain, storage, services, attachments, AI, and generation modules. |
| React renderer | frontend/src/App.tsx |
Mounts AppShell with the controller from frontend/src/app/useAppController.ts. |
| Smoke harness | crates/qa-scribe-app/src/main.rs |
Runs a non-GUI workflow for storage, attachments, generation context, drafts, and findings. |
| Release tooling | .github/workflows/release.yml |
Builds signed desktop artifacts and Linux package repository assets. |
- Download the English video overview directly (MP4).
- Video overview has the video download, captions, and source links.
- Architecture explains how the renderer, Tauri bridge, core service layer, SQLite, files, and provider CLIs connect.
- Getting started lists install, run, build, and verification commands.
- Features covers Sessions, rich records, managed attachments, AI-assisted Testware, and settings.
- Rust core and Frontend shell are the main subsystem pages.
- QA Scribe
- Download overview video (MP4)
- Architecture
- Getting started
- Glossary
- By the numbers
- Lore
- Fun facts
- Video overview
- How to contribute
- Development workflow
- Testing
- Debugging
- Patterns and conventions
- Tooling
- Applications
- Desktop app
- Smoke harness
- Systems
- Rust core
- Tauri command bridge
- Frontend shell
- Generation jobs
- Provider detection
- Release tooling
- Features
- Session capture
- Rich record editing
- Managed attachments
- AI-assisted Testware
- Settings and provider setup
- Crates
- qa-scribe-core
- qa-scribe-app
- Primitives
- Session
- Entry
- Finding
- Draft
- Evidence
- API
- Tauri commands
- Deployment
- Security
- Background
- Architecture decisions
- Migration context
- Cleanup opportunities
- TODOs and FIXMEs
- Complexity hotspots
- Reference
- Configuration
- Data models
- Dependencies