CodeFlow is a browser-based codebase visualization tool that transforms any GitHub repository URL into an interactive architecture map showing file dependencies and connections.
The tool addresses the challenge of understanding unfamiliar codebases by generating visual dependency graphs that reveal how files connect and interact. It works entirely in the browser without requiring installation, accounts, or data transmission to external servers. Users paste a GitHub URL or select local files, and CodeFlow renders an interactive map where clicking nodes highlights their dependencies. The visualization supports dragging, zooming, and exploring relationships across the codebase.
CodeFlow suits developers who need rapid architectural understanding of new projects, whether for onboarding, code review, or impact analysis. It works well for teams evaluating whether changes to a file will break dependent code, since the blast radius analysis immediately shows affected files. The tool includes security scanning for hardcoded secrets, SQL injection patterns, dangerous eval usage, and production debug statements, plus pattern detection for common architectural patterns and anti-patterns. A health score grades codebases on dead code, circular dependencies, coupling, and security issues. The project also offers a GitHub Action that generates self-updating health cards for README files and optional PR comments analyzing change impact. For documentation-heavy projects, CodeFlow can visualize markdown directories and Obsidian vaults as connected note graphs using wiki-links and relative paths.
The project shows active development with regular feature additions across multiple analysis dimensions. Work spans security scanning capabilities, architectural pattern recognition, and integration tooling like the GitHub Action card generator. The codebase includes specialized handling for different file types and contexts, such as excluding test directories from certain security checks while monitoring CI workflows for credential leaks. Development has expanded the tool's scope from basic dependency visualization to comprehensive codebase health assessment and documentation graph analysis.
