Skip to content

Added a new Block Diagram#59

Merged
braedonsaunders merged 2 commits into
braedonsaunders:mainfrom
AbdurRafay-Qureshi:main
May 22, 2026
Merged

Added a new Block Diagram#59
braedonsaunders merged 2 commits into
braedonsaunders:mainfrom
AbdurRafay-Qureshi:main

Conversation

@AbdurRafay-Qureshi
Copy link
Copy Markdown
Contributor

Added a new Block Diagram:

To view to make the repo architecture easier to understand. It creates a Mermaid-based diagram from the existing CodeFlow analysis results. The diagram groups files into higher-level sections instead of showing every file one by one, such as:

Application Entry
Frontend Routes / Views
Frontend Components
Backend / API Layer
Services / Business Logic
Shared / Utilities
Configuration
Content / Data
Uses:

Mermaid.js for rendering the diagram.
Reuses the existing CodeFlow analysis pipeline and file metadata instead of adding a separate analyzer from scratch.
Adds web-app and Next.js route detection for pages, layouts, routes, and framework-specific files.
Works best with web app projects, especially Next.js, React/Vite, and full-stack JavaScript/TypeScript repos.
Should work well with common project folders like:

src/app
pages
components
api
routes
services
middleware
config
Current limitations:

The classification works best for JavaScript/TypeScript web app structures.
Other languages and frameworks may still render, but the grouping may be less accurate.
Dynamic routes, custom aliases, generated files, or unusual folder structures may not always be detected perfectly.

Added a new Block Diagram view for architecture visualization.

uses:

mermaid block diagram.
@vercel
Copy link
Copy Markdown

vercel Bot commented May 21, 2026

@AbdurRafay-Qureshi is attempting to deploy a commit to the braedonsaunders' projects Team on Vercel.

A member of the Team first needs to authorize it.

@braedonsaunders braedonsaunders merged commit 612b45a into braedonsaunders:main May 22, 2026
1 check failed
@braedonsaunders
Copy link
Copy Markdown
Owner

Merged — thank you so much for this, @AbdurRafay-Qureshi! 🎉

The Block Diagram view is a genuinely useful addition: grouping files into higher-level sections (entry, routes, components, backend, services, shared, config) and rendering them with Mermaid makes the architecture far easier to read at a glance than the per-file graph. Nicely done — and thank you for reusing the existing analysis pipeline rather than bolting on a second analyzer, and for shipping it with real tests.

A few tiny cleanups folded in on merge, just so you know what changed:

  • Resolved a conflict with the PDF-export work that landed on main after you opened this — kept the theme-aware getEmbeddedSvgStyle()/exportSVG() so SVG export still embeds theme colors.
  • Restored the tests/fixtures/web-app-world fixture so the two web-app classification tests run (the fixture had been removed while the tests referencing it stayed).
  • Dropped the generated package.json — CodeFlow is a single-file static app, so it doesn't need one.

Full suite is green (29/29). Really appreciate the contribution — looking forward to more! 🙏

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants