Edit Your Map

As collaborators on a Map, you have access to tools to help your team onboard to the codebase, understand team ownership, learn key flows, and more.

Real-time Collaboration

Real-time Collaboration allows multiple users to make changes to a Map at the same time. Users actively collaborating in the Map are represented with avatars containing their initial and a cursor that follows their activity on the Map.

Modes

Maps have three Modes: Edit, View, and Playground.

ModeHow it worksReal-time collaborationWhat Map-Permission is required
ViewRead only: You can view the map, but you cannot make any editsYes. You will see cursors of other users on the same mapAny
EditRead/Write: You can make any edits.Yes. All edits are immediately saved and shared.Write
PlaygroundThink of this like a sandbox. You can make edits, freely experiment, but nothing is saved.No. This is a one-player only mode, and no changes are saved.Any

Tours

Tours are a way to create asynchronous, visual walkthroughs on a Map. Tours can be used for anything that comes to mind, showing where features are, tricky flows through files, helping to debug, and more.

Here's a video of all of the Tours!

Create Tours

  1. Click on the Tours icon on your left toolbar.
  2. Click "Add a Tour."
  3. Provide a name for the Tour.
  4. Click "Add a Step."
  5. Click the node in the Map where you want to place the first step of your Tour.
  6. Add a description to the Tour step.
  7. Go back to Step 4 and create as many Tour steps as you'd like!

View Tours

Tours will automatically display at the top of your Map interface.

To navigate between multiple Tours:

  1. Select the dropdown next to the name of your Tour.
  2. Select the Tour you would like to view.

Additional Tour Options

Click on the overflow button (•••) in the toolbar to:

  • Add a second Tour.
  • Rename a Tour.
  • Delete a Tour.

Labels and Colors

The legend is a panel in the upper-right corner of the Map. Here you can choose colors and labels that you can apply to files or folders in your Map.

To add a new Label to the legend:

  1. Click “Add a new label.”
  2. Click on the placeholder text “New Label” to edit the text for the label at any time.
  3. Click the colored tile on the left to select a color for files and folders with that Label.
  4. You can use labels to designate and color-code team ownership, indicate different codebase features, mark hotspots or tech debt, or whatever would be useful to you.

To assign colors to files or folders:

  1. Click the Color tool, then select the color you’d like to use.
  2. Click on the files or folders you want to paint with that selected color.

Animated screenshot showing creating a new label, setting its color, and using the color tool to set the colors on nodesAnimated screenshot showing creating a new label, setting its color, and using the color tool to set the colors on nodes

Right-Click Menu

Screenshot of CodeSee's right-click menuScreenshot of CodeSee's right-click menu

By right-clicking on a file or folder, you'll get the following options:

Hide selected items

This will hide the items you've selected from the Map.

Show only selected items

This will hide all items that are not selected.

Show all

This will show all files and folders.

Add/edit note

This will allow annotating items.

Notes

Use the Notes tool to add additional context to any file and folder.

  1. Click on the “Notes” tool.
  2. Click on the file or folder you would like to annotate.
  3. Type your note, then press "Enter" on your keyboard to add it to the file or folder.

Notes on folders are available only when the folder is collapsed.

Screenshot of CodeSee's Notes ToolScreenshot of CodeSee's Notes Tool

Comments

Users with "write" access can participate in a real-time chat experience on any file or folder in your Codebase Map.

When you select any node in the map, you'll see a chat bubble on the right side of the selected node. Click the chat bubble to begin or continue a conversation.

Select a node then click the chat bubble to start a conversation.Select a node then click the chat bubble to start a conversation.

Select a node then click the chat bubble to start a conversation.

If there is an existing conversation on a node, you will see the chat icon inside the node along the right edge.

The chat icon indicates that this file has an existing conversationThe chat icon indicates that this file has an existing conversation

The chat icon indicates that this file has an existing conversation

You can select the node, then click the chat bubble that appears to view the existing chat.

Chat between two users about this file in the mapChat between two users about this file in the map

Chat between two users about this file in the map

When there are comments anywhere in a map, a chat icon will appear in the upper-right corner of the header. You can also click that chat icon to see all existing comment threads. Click a thread to jump to the file or folder where the conversation is taking place.

Viewing comments in the comment side-panelViewing comments in the comment side-panel

Viewing comments in the comment side-panel

When there are unread comments either on a specific node or anywhere in the map, the appropriate chat icon will have a red dot.

Viewing comments in the comment side-panelViewing comments in the comment side-panel

Duplicate a Map

To create a copy of a Map, click on the overflow button (•••), then select “Duplicate.”

Create filtered views to share by selecting specific parts of your diagram to show and hide via the File Browser or the Right-Click Menu.


What’s Next