Story File Mapping

Link source files to stories to track which parts of your codebase are affected by each piece of work. Linked files also power sprint scope visualization in the Code Browser.

Linking files to stories

Files can be linked to stories from the Code Browser:

1. Open the Code tab on your project
2. Browse to a file and open it in the viewer
3. The file can be linked to stories via the story sidebar

Linked files are stored on each story and visible in the story detail sidebar under a Linked Files section.

Viewing linked files

On the story detail page, the Linked Files section in the sidebar shows:

• File icon and filename for each linked file
• Full path shown on hover
• Remove button to unlink a file (only visible to editors)
• Browse Code link to jump to the Code tab

If no files are linked and you have edit access, the section shows a "Browse Code" button to get started.

Sprint scope visualization

When viewing the Code Browser with an active sprint, files that are linked to stories in that sprint are visually highlighted:

• A purple left border on the file entry in the tree
• A badge showing how many stories reference that file

This gives you a quick visual overview of which parts of the codebase your current sprint is touching — helpful for identifying potential merge conflicts, understanding scope, and reviewing sprint focus areas.

Linked stories in the file viewer

When viewing a file that's linked to one or more stories, the viewer shows a Linked Stories bar above the source code listing each story title. This lets you quickly understand why a file is being modified in the current sprint.