Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Beliagal/qa-report-automation/llms.txt

Use this file to discover all available pages before exploring further.

Valoraclick QA Tool is a professional Windows desktop application built specifically for QA analysts who need to produce structured, evidence-rich test reports without manual overhead. From a single interface, analysts fill in test metadata, log individual test steps with Pass/Fail verdicts, attach screenshot evidence, and export a polished PDF — all while the tool silently auto-saves their work and syncs a CSV backup to Google Drive. Whether you’re working on a solo regression cycle or coordinating evidence for a formal audit, Valoraclick QA Tool keeps your documentation consistent, complete, and always recoverable.

The Problem It Solves

Traditional QA documentation is a time sink. Analysts copy test results into spreadsheets, paste screenshots into Word documents, manually format pass/fail indicators, and risk losing hours of work to an unexpected crash or closed tab. Backing up evidence to a shared drive is a separate, often forgotten step. Valoraclick QA Tool eliminates every one of these pain points: reports are formatted automatically, screenshots are embedded inline, sessions are persisted to local JSON after every step, and CSV backups are pushed to Google Drive the moment a PDF is exported — no extra clicks required.

Key Features

Instant PDF Reporting

Generate professional, fully formatted PDF test reports in one click using the fpdf2 engine. Pass results are highlighted in green and Fail results in red, making status instantly visible to any stakeholder who opens the document.

Screenshot Evidence Embedding

Attach PNG or JPEG screenshots directly to individual test steps. Images are embedded inside the PDF report, keeping all visual evidence self-contained and portable — no external folders or file links needed.

Session Persistence

Every test step you add is immediately saved to a local sesion_testing.json file. If the application closes unexpectedly, your metadata, step log, and attached image paths are fully restored the next time you launch the tool.

Google Drive CSV Backup

When you export a PDF, the tool automatically resolves your Google Drive sync path via a Windows .lnk shortcut and writes a CSV backup of the session data — a transparent, zero-friction safety net for your test records.

Modern CustomTkinter GUI

The interface is built on CustomTkinter, delivering a clean, dark-themed desktop experience that feels native on Windows. The scrollable control panel keeps metadata fields, step entry forms, and action buttons all within reach on any screen size.

Real-time Report Preview

A live log panel inside the application renders a color-coded preview of your report as you type — blue headers, green Pass steps, and red Fail steps — so you can spot issues before you ever click Export.

Tech Stack

ComponentLibraryVersion
GUI FrameworkCustomTkinter5.2.2
PDF Enginefpdf22.8.7
Image HandlingPillow12.2.0
Binary BuildPyInstaller6.20.0
Test SuitePytest9.0.3
Windows APIpywin32311

Platform Requirements

Valoraclick QA Tool is a Windows-only application. The Google Drive CSV backup feature relies on pywin32 (version 311) to resolve Windows .lnk shortcut files that point to your local Google Drive sync folder. This mechanism is not available on macOS or Linux. All other features — PDF generation, screenshot embedding, and session persistence — are cross-platform in principle, but the application is packaged, tested, and supported exclusively on Windows.

Get Started

Quickstart

Download the pre-built exe and generate your first PDF report in under two minutes — no Python required.

Installation

Set up the Python development environment to run from source, contribute, or build a custom executable.

Build docs developers (and LLMs) love