Help

How to Analyze Your Project

The code map generator is a PHP-based, AI-friendly tool that scans your web project and produces a structured code_map.json — a full map of your codebase. This file gives AI models (like ChatGPT, Claude, or Gemini) a complete view of your project’s structure, logic, and relationships. It also helps you understand and maintain your own codebase better.

📁 Selecting the Project Folder

By default, the tool scans the folder it's running from. You can specify a different target folder by entering a relative path in the input field:

../folder/yourproject — moves up one level and into a folder
./subfolder — scans a subfolder
../../folder — goes up two levels

The generated code_map.json will be saved inside the folder that was scanned. If you're using an IDE like VSCode or PhpStorm, it will appear right inside your project folder.

📂 Exclusion Options (You Control What to Analyze)

You can specify folders and files to exclude using filters. The tool does not automatically guess what to skip — you tell it.

Exclude folders (one per line): vendor, node_modules, backup, etc.
Exclude specific files/patterns: *.min.js, backup*.php, etc.

Only files that pass these filters are included in the code map and analysis.

🧠 Code Analysis Capabilities

PHP: functions, globals, constants, dependencies
JS: AJAX calls (fetch, axios, jQuery, etc.)
HTML: forms with IDs/actions
CSS: class/ID selectors
SQL: table/column structure (if parsing is enabled)

🔗 Dependency Mapping

Detects static references: require, include, <script>, <link>
Maps AJAX URLs, form handlers, and project file relations

📊 Size Estimation and Token Budget

Each block is measured by characters, bytes, and token estimate (~4 chars/token)
Useful for managing AI request size and efficiency

🧭 Full Structure Map

Once the scan is complete, you’ll get two key outputs:

code_map.json — a clean, AI-ready representation of your project
Analysis Summary Blocks — a detailed report for you, with file-by-file insights and structure breakdowns

📌 Included File Types

Only actual code files are included in the code map — no binaries, no images, and no minified vendor files. Specifically:

✅ PHP (.php)
✅ JavaScript / TypeScript (.js, .ts)
✅ HTML (.html)
✅ CSS (.css)
🚫 Excludes images, fonts, videos, PDFs, and other non-code files
🚫 Excludes minified assets like *.min.js or *.min.css (unless you remove that from filters)

This ensures the resulting code map remains clean, relevant, and optimized for AI processing.

📦 Smart Output

Empty or irrelevant blocks are automatically filtered out to keep your code map small and meaningful. Only significant content is retained.

If you have any questions, feature requests, need help, or want to give feedback — feel free to contact us at