Locsight

See through your source code.

---

A blazing-fast ⚡ desktop app that scans, visualizes, and grades your codebase in seconds. Built with Rust and Tauri v2 for native speed. Supports 546+ programming languages.

✨ Highlights

🔍 Feature	Description
📊 Dashboard	LOC, language distribution, complexity histograms, COCOMO cost estimation
🫀 Health Score	DRYness, comment density, semantic role breakdown with letter grading (A+ → F)
📦 Asset Intelligence	Scans, classifies, and estimates savings for Multimedia (image/video/audio), 3D/Game assets, and CAD drawing dependencies
🔐 Secrets Scanner	Detects exposed AWS keys, GitHub tokens, JWT, private keys — auto-masked
📝 Annotations	Searchable TODO / FIXME / HACK / BUG tracker with filters
💡 Insights	Analyzes code issues, security bugs, and refactoring recommendations
🔥 Git Hotspots	Finds high-risk files where complexity × churn is dangerous
🌳 Treemap	Interactive squarified treemap sized by LOC
🕸️ Dep Graph	Circular module coupling graph with zoom, search, and filters
📁 546+ Languages	From Rust to COBOL, Solidity to GDScript — with shebang detection
📄 Export	JSON · CSV · Markdown · HTML reports

🚀 Quick Start

Locsight is a pre-compiled desktop app. You do not need to clone the code or install Node.js/Rust to use it.

1. Download the installer for your operating system from Releases.
2. Install and launch:
   • Windows: Run the .msi or .exe installer.
   • macOS: Drag the .dmg application to your /Applications directory.
   • Linux: Install the .deb package or execute the .AppImage.

💡 For detailed setup guides, security bypass instructions (SmartScreen/Gatekeeper), system dependency packages, and graphics hardware troubleshooting for Virtual Machines (blank screen fix), please consult the Full Installation Guide.

🛠️ Development Setup

If you want to compile Locsight from source:

# 1. Clone repository
git clone https://github.com/ThanhNguyxnOrg/Locsight.git
cd Locsight

# 2. Install dependencies
npm install

# 3. Launch dev environment
npm run tauri dev

📋 Prerequisites: Node.js (v18+), Rust (v1.75+), and Tauri v2 prerequisites for compilation.

⚙️ Tech Stack

Backend   →  Rust · Tauri v2 · Rayon · WalkDir · SHA-256 · Regex
Frontend  →  React 19 · TypeScript · Vite · Tailwind CSS · Recharts
CI/CD     →  GitHub Actions · Dependabot · Auto-merge

📖 Documentation

📄 Document	Description
🚀 Installation	Cross-platform setup, security bypass, and VM troubleshooting
📐 Architecture	System design, module breakdown, data flow
✨ Features	Detailed feature guide with examples
💻 Development	Local setup, project structure, debugging
🤝 Contributing	How to contribute, code style, PR guidelines
📋 Changelog	Version history and release notes
🔒 Security	Vulnerability reporting policy
📜 Code of Conduct	Community standards
⚖️ License	MIT License

📸 Screenshots

Coming soon — build the app and explore!

---

_{Made with 🦀 Rust + ⚛️ React by ThanhNguyxn}