Project Folder Guard
Folder Validation Tool • Rule-Based Scanning • WinForms + Core Engine
Introduction
Project Folder Guard is a Windows desktop utility designed to validate project folder structures against configurable rules. It is built for real-world scenarios such as construction workflows, document compliance, and internal auditing processes.
The system scans a selected project directory, verifies required folders and files, highlights issues visually, and allows exporting structured results for reporting and review.
Features
- Validate required folder structures
- Verify required files using regex patterns
- Color-coded validation results (OK / Missing / Wrong)
- Summary counts for quick analysis
- Clickable file and folder paths
- Direct folder access from within the app
- Export scan results to CSV
- Rules presets (Save / Load / Delete)
- Open presets folder for advanced users
- Resizable and scalable UI layout
How It Works
- Select a Project Folder
- Select a Rules JSON file or preset
- Run the scan
- Review validation results
- Export results if needed
System Design
The application is built with a modular architecture separating the validation logic from the user interface. A core engine handles rule parsing, folder scanning, and validation, while a WinForms UI provides interaction and visualization of results.
This separation allows the scanning logic to be tested independently and reused across different entry points, including a console-based test runner.
Screenshots
Tech Stack
Status
Feature-complete, production-ready, and designed as a reusable validation tool for structured project environments.