New concept Mr Ahmed
I wanted to suggest a possible future direction that could make the tool useful for a different type of user: people who understand software concepts, servers, requests, APIs, databases, and product logic, but do not write code themselves. For this type of user, a visual code diagram is helpful, but it still requires them to think like a developer. They still have to understand files, functions, imports, modules, and dependencies.
Instead of only showing how files connect to each other, the tool could also generate a human-centered view of how the software actually works.
For example, after entering a GitHub repo, the tool could identify the main user journeys or system flows:
- User signs up
- User logs in
- User creates a project
- User uploads a file
- User makes a payment
- Admin reviews something
- Data gets processed in the background
The user could click one of these flows and see a step-by-step explanation of what happens inside the software.
Example:
User logs in
- The login form collects the email and password.
- The frontend sends this information to the backend.
- The backend checks if the user exists.
- The password is validated securely.
- A session or token is created.
- The frontend stores the login state.
- Future requests use that session/token to identify the user.
Each step could then link back to the actual files, functions, routes, and components involved.
So the tool would not replace the current diagram. It would add a layer above it:
Product behavior → System flow → Related files → Actual code
Source: ahmedkhaleel2004/gitdiagram