Morph Map

Morph Map provides a powerful tool to visualize and interact with codebases or public websites in a new and engaging way. By scanning real projects, Morph Map generates an editable map where components are represented as boxes, and connections are shown as arrows. This allows users to explore how different parts interrelate and to model how a project should ideally function.

Key Features

• Scan: Transform a code folder or public website into a visual map, revealing the structure of files and their relationships.
• Plan: Create a secondary map called Planned that allows for modifications, including adding, deleting, renaming, and connecting boxes, with options for leaving notes for future development.
• Play: Animate the transition from Today to Planned, providing insight into complexity changes through a display of a complexity score that decreases as simplification occurs.
• Report: Generate reports outlining scores and findings based on the scan, highlighting actionable items and potential improvements.
• Brief: Convert the differences between the current and planned maps into concrete instructions for AI coding assistants.
• Learn: Gain insights into the code structure, allowing developers to identify key areas for study, such as core files and complex import loops.
• Blast Radius: Examine the potential impact of changes from any given component by exploring all reachable elements within the map.

Quick Start

Scan a Code Project

Utilize Node.js to scan a project directory and produce a JSON file representation:

node scanner/morph-scan.js ./your-project --out my-map.json

Afterward, simply open index.html to import the JSON map.

Map a Website

To map a public website, open it in the browser and run the following JavaScript code in the console:

<insert script here>

This will capture up to 40 pages and create a corresponding map.

Plan and Play

Switch to the Planned view to make adjustments, and when ready, press Play to visualize the changes on the map.

Complexity Scoring

The complexity of a project is assessed on a scale from 0 to 100, evaluating size, tangle, depth, and data duplication to derive a comprehensive score. The scores categorize projects into Light, Medium, and Heavy complexity levels.

Reports and Findings

Morph Map's learning and auditing capabilities can uncover critical insights about codebases and websites, including:

• Code Analysis: Identify where programs initiate, dependencies, and files with excessive lines.
• Website Assessment: Evaluate structures for efficiency and ensure best practices in security settings, all while respecting privacy and ethical scanning guidelines.

Tested on Real Projects

Morph Map has been effectively utilized on various projects, showcasing its practical application and reliability in identifying and suggesting improvements. Examples include the evolution of Express.js and notable public websites.

Responsible Use

It’s vital to scan only the codebases that are permitted and to respect the guidelines set by public websites.

What's Included

Morph Map features a straightforward setup including an HTML application for mapping and analysis, along with scripts for scanning both code and web projects. A directory of examples also accompanies the project for user reference.

Future Developments

Plans for future enhancements include streamlined scanning processes and improved visualizations for complex site structures.