Browse the repository's files

The Files tab swaps the commit graph for a file browser on the same repository: the file tree in the panel on the left, the current directory's contents in the middle, and a file search in the toolbar. It lists the files git tracks — the same set the repository shows on its forge — as they are on disk right now, and the Graph tab puts the graph back exactly where it was.

Opening the file explorer lists the working tree

The Files tab swaps the commit graph for a browser over the same repository: the file tree in the left panel, where the branches sit on the graph, and the current folder's contents in the middle. The toolbar changes with it — a file search replaces the git actions, which have nothing to act on here. What it lists is the files git tracks, as they are on disk right now: the same set the repository shows on GitHub, rather than whatever your working directory happens to hold. A file you have created but not yet staged belongs to the working-tree panel on the Graph tab, not here — and the Graph tab puts the graph back exactly where it was.

Captured from the running app by this scenario.

Do this

1. Open the file explorer

You should see

• The file explorer is shown
• The file tree sidebar is shown
• The file explorer lists the file app.txt

Filtering the tree narrows it to the matching file

The search field above the tree filters it live, by name — useful the moment a repository has more files than fit on screen at once. A query that matches nothing says so, rather than leaving the tree just looking empty.

Captured from the running app by this scenario.

Do this

1. Open the file explorer
2. Filter the file tree by nothing-matches-this

You should see

• The file tree sidebar lists app.txt
• The file tree sidebar does not list app.txt
• The file tree sidebar reports no matches

The tree sidebar can be hidden and stays recoverable

The tree takes up room a wide file deserves once you already know your way around a repository. Hiding it gives that space back to the file list and the preview, and the toolbar's own panel toggle — not a control local to this view — is what brings it back.

Captured from the running app by this scenario.

Do this

1. Open the file explorer
2. Hide the file tree sidebar

You should see

• The file tree sidebar is hidden

---

This page is generated from apps/e2e/features/file-explorer.feature, the end-to-end test that drives the feature it describes.