Documents
Browse and download project files directly from your code editor. Navigate folder hierarchies, view file details, and access documents without switching to a browser.
The Problem This Solves
Project files — design mockups, specifications, contracts, assets — live in the project management tool. When you need to reference a design while coding or check a specification, you switch to a browser tab, navigate to the right folder, find the file, and switch back.
GitScrum Studio puts the document browser inside an editor panel. Access project files alongside your code in the same window.
What You Are Looking At
Click Documents under the Knowledge section in the sidebar tree. The panel opens with a file browser interface.
Folder Navigation
The top of the panel shows breadcrumb navigation displaying your current location in the folder hierarchy:
Project Files / Design / WireframesClick any breadcrumb segment to navigate up the hierarchy. Click a folder in the listing to navigate into it.
File Listing
Files and folders display in the main content area. Two view modes are available:
Grid View: Files appear as visual cards with icons representing their file type. Ideal for browsing design assets or mixed content.
List View: Files appear in a detailed table format with columns for name, size, type, and date. Ideal for large folders with many files.
Toggle between views using the view switcher in the panel header.
File Details
Each file entry shows:
| Property | Description |
|---|---|
| Filename | Name of the file with extension |
| Type | MIME type or file format |
| Size | File size in human-readable format |
| Uploader | Team member who uploaded the file |
| Date | When the file was uploaded |
Downloading Files
Click a file to access its download link. The file opens in your default browser or downloads directly, depending on your editor and OS configuration.
Search
Use the search field at the top of the panel to filter files and folders by name. Results update in real-time as you type, making it easy to find specific documents in large project repositories.
View-Only Access
The Documents panel in the VS Code extension is a read-only browser. File uploads, folder creation, and file management (rename, move, delete) are handled through the GitScrum web application.
To upload files or manage the folder structure, open the project in the GitScrum web application at studio.gitscrum.com.
Pro Tips (Once You Are Comfortable)
- Split view with code. Open the Documents panel alongside your code to reference design mockups or specifications while implementing.
- Use list view for large folders. The detailed table format makes it easier to find files by size, type, or date.
- Use search to jump directly. If you know the filename, type it in search instead of navigating folder by folder.
Permissions
The extension respects your GitScrum account permissions:
- Agency Owners and Managers: Full access to view and download all project files
- Developers: Can view and download files in assigned projects
- Clients: Can view and download files (if granted project access)
How to Report a Problem or Request a Feature
If files do not load, downloads fail, or folders appear empty when they should have content, open a support ticket in the GitScrum web application. Navigate to Support Tickets in the sidebar and describe the issue. Include the extension version and editor details.