Show HN: Cartograph – AI-generated code documentation and architecture diagrams

[vivekkalyan]

Hey there HN! We're Vivek and Si-Yan from Cartograph (https://cartograph.app). We've built an AI-powered code documentation platform that automatically generates reference documentation and creates a visual interactive map of the codebase that serves as both high level architecture diagram and allows you to zoom in to specific implementations.

How it works: We use static analysis to read a codebase and get its symbols and their dependencies, creating a complete map that includes function calls. We use LLMs (Gemini + Claude) to add metadata to this map, as well as augment it in cases where static analysis doesn't work (e.g. HTTP calls). This map is then used to create an interactive map that you can explore to understand the system of your codebase. This works on both monorepos and multi repo projects. We also make use of this map to generate reference documentation for various functions/classes/structs etc in the codebase.

Some demo repos:

NextJS e-commerce template: https://cartograph.app/share/demo/vercel-commerce-next-js-ec...

FastAPI + React template: https://cartograph.app/share/demo/full-stack-react-fastapi-t...

Rust tokenizers library: https://cartograph.app/share/demo/huggingface-tokenizers-rus...

FastAPI/NextJS RAG chatbot: https://cartograph.app/share/demo/weaviate-verba-rag-chatbot...

If you'd like us to process more public repos, please comment below and we will process it on our end.

We plan to improve things significantly over the coming months, but we want to hear your feedback on our product and/or any use cases you think this could be useful for.

[tejaskumar_]

Really interesting tool! Would love to see how it handles database integration patterns. We've been working with Astra DB in some projects, and having auto-generated documentation for different database access patterns would be super helpful for the team. Have you considered adding specific support for database architecture visualization?

[vivekkalyan]

Yes definitely, adding database schemas and queries is on our roadmap for capturing "indirect links" across codebases. We are thinking of something similar to Supabase studio's schema visualizer [1], but integrated with the map of the codebase so that which parts of the code read/writes to different tables. Is that what you have in mind? Or do you mean something else by database access patterns?

1: https://supabase.com/blog/supabase-studio-3-0#schema-visuali...