Skip to content

CodeCharta is a visualization tool that transforms complex software architecture and code metrics into interactive, customizable visual maps, empowering everyone to communicate and analyze your codebase. Improve code quality, maintainability, and architectural decisions

License

Notifications You must be signed in to change notification settings

MaibornWolff/codecharta

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 


CodeCharta
CodeCharta

a tool to help you visualize and understand code in 3D.

Release Analysis Release Visualization Quality Gate Analysis Quality Gate Visualization

Latest Release:
Analysis 1.128.0 | Visualization 1.130.0

Key FeaturesHow To UseFeedbackFurther InfoAbout

Screenshot of visualization

Key Features

  • CodeCharta Visualization:

    • CC visualizes code bases as 3D cities, so that you can understand it - view the Web Demo.
    • It uses code metrics from .cc.json files.
    • The imported files are validated using JSON Schema as defined in generatedSchema.json.
    • You can change the way the file is displayed and save and later load it as a Custom View.
  • CodeCharta Analysis:

    • CC Analysis is used to calculate or to import metrics from third party tools for a code base.
    • It generates .cc.json files for CC Visualization through a Command-Line-Tool.
    • It includes some pre-defined importers for e.g. SonarQube, SourceMonitor, Git, generic CSV data
    • It also includes commands to validate and merge multiple .cc.json files.

Requirements

For using CodeCharta the following needs to be installed on your system:

  • Node >= 20
  • Java >= 11, <= 21

How To Use

How to use Visualization?

  • Online: You can try the web visualization without any installation and explore the CodeCharta code (shown by default).
  • Local: See here.

How to use Analysis?

  • Analysis is split into different parsers that generate .cc.json files. To run these parsers you need the CodeCharta Shell.

In this example we will generate a .cc.json from JUnit4 using the Source Code Parser (that parses java projects).

# Install codecharta-analysis globally
$ npm i -g codecharta-analysis
# Clone the junit4 repository
$ git clone https://github.com/junit-team/junit4
# Parse sources with CodeCharta Shell
$ ccsh sourcecodeparser junit4 -p junit4 -o junit4.source.cc.json
# Now you can upload `junit4.source.cc.json` to CodeCharta Visualization

Note If you want to be guided through selecting the arguments. Just execute ccsh and you can run the parsers interactively with dialogs.

Feedback

Have a bug, a feature request or any question? Please open a new issue. Feedback is always welcome.

Want to have even more information? Please check our documentation and news.

Further Information

About CodeCharta

License

MIT


maibornwolff.de  ·  GitHub @MaibornWolff