File Browser
Navigate and search your codebase from the Browse tab.
Project-Aware Browsing
The file browser automatically syncs with your selected project. When you select a project in Sessions or Projects, Browse shows that directory.
Navigation
Path Display
- Tap title - Show full breadcrumb path
- Breadcrumb chips - Tap any segment to navigate there
- ".." entry - Go up one directory
App Bar
- Back arrow - Go up directory or close browser
- Path title - Current location (tap for breadcrumb)
- Search button - Open search mode
- Project button - Jump to current project root
- Connection indicator - Small status dot
File List
Each item in the file list shows:
| Element | Description |
|---|---|
| Icon | Folder or file type icon |
| Name | File/folder name |
| Subtitle | "Folder" or file size |
| Git Status | M/A/D/R/? badges for changes |
| Chevron | Navigate arrow |
File Icons
File icons are assigned by extension:
| Extension | Icon |
|---|---|
| .dart | Code (blue) |
| .ts, .tsx, .js, .jsx | JavaScript (yellow) |
| .json | Data object |
| .yaml, .yml | Settings |
| .md | Document |
| .png, .jpg, .jpeg, .gif, .svg | Image |
| Other | Generic file |
Git Status Badges
Files with git changes show colored badges:
| Badge | Color | Meaning |
|---|---|---|
| M | Primary | Modified |
| A | Green | Added |
| D | Red | Deleted |
| R | Orange | Renamed |
| C | Blue | Copied |
| ? | Gray | Untracked |
| ! | Gray | Ignored |
Git Status
Git status is only shown when browsing within a project directory. The status is fetched from your system and updates when you refresh.
Search
Tap the search icon to enter search mode. Three search types are available:
File Search
- Search files by name
- Results show full path
- Tap to open file
Text Search
- Search content within files
- Results show filename + line number
- Preview of matching line
- Tap to open at that location
Symbol Search
- Search functions, classes, variables
- Results show symbol name + type
- Icon indicates symbol kind (class, function, variable, etc.)
- Tap to open file at definition
Use the dropdown menu (icon in search bar) to switch between search types.
Viewing Files
Tap any file to open the viewer:
Code Files
- Syntax highlighting - Language-specific colors
- Line numbers - Along left edge
- Copy button - Copy entire file to clipboard
- Language indicator - Shows detected language in subtitle
Images
- Inline preview - Display directly in viewer
- Pinch to zoom - Standard gesture
- Pan - Drag to move around
Binary Files
- Type indicator - Shows file type
- Size warning - For large files
- "Cannot Preview" - Unsupported types
Large Files
Files over a certain size limit cannot be previewed to prevent memory issues. You'll see a "File too large" message with the file size.
Empty Folder
When a folder is empty, you'll see:
- Folder icon
- "Empty folder" message
- Pull down to refresh
Navigation Tips
- Swipe back - iOS gesture to go up a directory
- Project button - Quick jump to project root
- Breadcrumb navigation - Tap path to see full breadcrumb
- Pull to refresh - Update file list