CodeCity - Visualize Your JavaScript As A City
Written by Ian Elliot   
Monday, 29 May 2017

If you haven't encountered the idea of CodeCity before then this is going to be fun. Even if you have it is worth checking out what some familiar JavaScript code libraries look like as cities.

The  CodeCity software visualization metaphor was originally proposed by Wettel and Lanza in 2011 to visualize object-oriented code. JSCity is an implementation of these ideas in JavaScript for JavaScript by three researchers Marcos Viana, Andre Hora and Marco Tulio Valente based in Brazil. 

In the original CodeCity classes are represented as buildings, but this has had to be adapted because JavaScript is not a simple, class-based, language. The obvious thing to do is to replace class by functions.

JSCity represents a JavaScript program as a city; folders are districts and files are sub-districts; the buildings are functions; inner functions are represented as buildings on the top of their enclosing function/building. The Number Of Lines of source Code (LOC) represents the height of the buildings/functions; the Number Of Variables (NOV) in a function correlates to the building’s base size.


So when you view the cityscape, big buildings correspond to big functions. 

The program was implemented in JavaScript using the Esprima framework to generate an abstract syntax tree for the code and ThreeJS for the 3D graphics. Once the city is rendered you can move around, change the camera angle and zoom in to view it better. The software is available on GitHub for you to try out.

The researchers also analyzed 40 well-known JavaScript code bases and they present three as being particularly interesting - AngularJS core functions, Bower and jQuery - see if you can guess which is which:








I have to admit that I recognized my favorite JavaScript library almost at once! The identity of each city can be found at the very very end of this news item - scroll down.

More Information

CodeCity for (and by) JavaScript


Related Articles

Does Python Smell Like Java?

On the Unhappiness of Software Developers


To be informed about new articles on I Programmer, sign up for our weekly newsletter, subscribe to the RSS feed and follow us on Twitter, Facebook or Linkedin.



Java 17 Release Promises Faster Performance

Java Development Kit 17 and Java 17 are now generally available. JDK 17 was announced by the Open JDK group and Oracle released the new version under a commercial license for those using the Oracle JD [ ... ]

On This Day in 1927 Creator of LISP Born

John McCarthy, the man who invented the LISP programming language was born on September 4, 1927 in Boston Massachusetts. He is also remembered as the organizer of the summer workshop at Dartmouth Coll [ ... ]

More News





or email your comment to:


The Cities

  • A is jQuery
  • B is AngularJS
  • C is Bower.




Last Updated ( Monday, 29 May 2017 )