Transform your codebase into a clean, semantic architecture map.
Mapify is a powerful VS Code extension that converts complex project structures into readable, architecture-aware project maps with intelligent semantic labels.
Instead of showing only raw folders and files, Mapify understands common software architecture patterns and explains the purpose of directories inside your codebase.
Perfect for:
- 🤖 AI prompts
- 📚 Documentation
- 🏗️ Architecture understanding
- 👥 Team onboarding
- 🚀 Developer productivity
- 🌳 Codebase exploration
✨ Features
🧠 Semantic Codebase Understanding
Mapify doesn't just print folders.
It recognizes architectural patterns like:
controllers/ ← request handlers
services/ ← business logic
components/ ← UI components
hooks/ ← React hooks
repositories/ ← data access
auth/ ← authentication
It transforms raw filesystem structures into understandable software architecture.
🌳 Beautiful ASCII Tree Generation
Generate clean project maps instantly.
Example:
my-app/ [next.js app]
├── app/ ← pages / views
├── components/ ← UI components
├── hooks/ ← React hooks
├── lib/ ← utilities
├── services/ ← business logic
├── prisma/ ← ORM layer
├── public/ ← static assets
├── styles/ ← styles
├── package.json
└── tsconfig.json
8 directories, 12 files
Project type: next.js app
⚡ AI-Friendly Context Export
Mapify is designed for the AI era.
Instantly generate structured codebase context for tools like:
- ChatGPT
- Claude
- GitHub Copilot
- Cursor
- Windsurf
Instead of manually explaining your project architecture, Mapify generates a clean project overview automatically.
🧩 Project Type Detection
Mapify intelligently detects technologies based on known project files.
| File Detected | Project Type |
|---|---|
package.json |
Node project |
pom.xml |
Java / Maven |
requirements.txt |
Python project |
go.mod |
Go module |
schema.prisma |
Prisma ORM |
next.config.js |
Next.js app |
docker-compose.yml |
Docker services |
main.tf |
Terraform |
manage.py |
Django app |
And many more.
🚀 Explorer Integration
Generate maps directly from the VS Code Explorer.
Right-click any folder:
Mapify: Generate Map from Here
Or use:
Ctrl + Shift + P
→ Mapify: Generate Project Map
📦 Installation
From VS Code Marketplace
Search for:
Mapify
Or install directly from the marketplace.
🛠️ Usage
Generate Full Workspace Map
- Open your project in VS Code
- Open Command Palette:
Ctrl + Shift + P
- Run:
Mapify: Generate Project Map
Generate Map From Specific Folder
- Open Explorer
- Right-click any folder
- Select:
Mapify: Generate Map from Here
⚙️ Extension Settings
Mapify provides several configurable options.
mapify.maxDepth
Controls maximum folder depth displayed.
"mapify.maxDepth": 4
mapify.showSemanticLabels
Enable or disable semantic folder labels.
"mapify.showSemanticLabels": true
mapify.copyToClipboard
Automatically copy generated map to clipboard.
"mapify.copyToClipboard": true
🧠 Semantic Label System
Mapify recognizes many common architectural conventions.
Frontend
| Folder | Meaning |
|---|---|
components |
UI components |
hooks |
React hooks |
pages |
Pages / views |
styles |
Styling |
assets |
Static assets |
Backend
| Folder | Meaning |
|---|---|
controllers |
Request handlers |
services |
Business logic |
repositories |
Data access |
middleware |
Middleware |
graphql |
GraphQL layer |
Database
| Folder | Meaning |
|---|---|
migrations |
DB migrations |
seeds |
Seed data |
prisma |
ORM layer |
Infrastructure
| Folder | Meaning |
|---|---|
docker |
Containers |
infra |
Infrastructure |
deploy |
Deployment |
config |
Configuration |
🚫 Smart Ignore System
Mapify automatically ignores unnecessary folders and generated artifacts.
Examples:
node_modules
.git
dist
build
coverage
.cache
.next
target
venv
This keeps output clean and focused.
💡 Why Mapify?
Modern codebases are huge.
Understanding architecture quickly has become difficult.
Mapify helps developers:
- understand unfamiliar projects,
- visualize structure,
- explain architecture,
- generate AI context,
- improve onboarding,
- create documentation faster.
Instead of reading hundreds of folders manually, Mapify gives you a clean architectural overview instantly.
🔥 Example Use Cases
🤖 AI Prompting
Paste generated project maps into AI tools for better coding assistance.
👥 Team Onboarding
Help new developers understand project architecture quickly.
🌍 Open Source Projects
Improve contributor experience by exposing project structure clearly.
📚 Documentation
Generate architecture trees for README files and docs.
🏢 Large Monorepos
Understand complex repositories faster.
🏗️ Architecture
Mapify is built around three core systems:
extension.js → VS Code integration
tree.js → recursive tree generation
semantics.js → semantic architecture understanding
🚀 Roadmap
Planned future features:
- AI architecture summaries
- Dependency analysis
- Visual graph mode
- Token-aware AI export
- Interactive tree viewer
- Smart importance ranking
- Monorepo understanding
- Architecture diagrams
- Markdown export
- JSON export
- AI context compression
🧪 Local Development
Clone Repository
git clone https://github.com/BHARGAV-RUE/Mapify.git
cd Mapify
Install Dependencies
npm install
Run Extension
Press:
F5
This launches the VS Code Extension Development Host.
📄 Example Output
backend/ [java / maven]
├── controllers/ ← request handlers
├── services/ ← business logic
├── repositories/ ← data access
├── auth/ ← auth
├── config/ ← config
├── migrations/ ← DB migrations
├── pom.xml
└── application.yml
6 directories, 8 files
Project type: java / maven
🤝 Contributing
Contributions, ideas, and feedback are welcome.
Feel free to:
- open issues,
- suggest features,
- improve semantic detection,
- add new architecture patterns,
- optimize performance.
📜 License
MIT License
⭐ Support
If you like Mapify:
- ⭐ Star the repository
- 🚀 Share it with developers
- 🧠 Use it in your workflow
- 🤝 Contribute new ideas
🧭 Mapify
Understand your codebase at a glance.