{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":2286,"path":"application-development/project-explorer.md","title":"Project explorer","bundle":null,"doc_type":null,"release":"australia","body":"\n# Project explorer\n\nThe Project Explorer is the primary file management panel in Lux Lab. It provides a hierarchical view of your project's files and folders, and is the starting point for navigating, creating, and organizing your work.\n\n## Panel location\n\nThe Project Explorer occupies the left sidebar when the **Explorer** icon, the top icon in the Activity Bar, is active. It shows the full directory tree rooted at your current project folder.\n\n## Opening and switching projects\n\nYou open and switch projects from the title bar drop-down list. Selecting the project name in the title bar reveals the project picker, which has the options in the following table.\n\n|Option|Description|\n|------|-----------|\n|**Recent**|Recently opened projects and workspaces. Select any project to switch to it.|\n|**Open Folder…**|Option to open an existing project folder from disk|\n|**New Project**|Option to create a Lux project from a template|\n|**New Workspace**|Option to create a multi-root workspace|\n\nFor the steps to open an existing project folder, see [Open a project folder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/open-a-project-folder.md).\n\n## Creating files and folders\n\nYou create files and folders directly in the tree. When you hover over any folder, Lux Lab reveals its action icons, including **New File**.\n\nFor the steps to add a file, see [Create a file](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/create-a-file.md). For the steps to add a subfolder, see [Create a folder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/create-a-folder.md).\n\n## File tree navigation\n\nThe following table lists the keys for moving through the file tree.\n\n|Action|Method|\n|------|------|\n|Expand folder or open file|→ arrow or select the chevron|\n|Collapse folder|← arrow|\n|Open file or toggle folder|Enter|\n|Quick peek preview|Space \\(press Esc to close\\)|\n|Move focus up or down|↑ / ↓|\n|Delete focused item|Del|\n|Reveal active file in tree|Cmd+Shift+E|\n|Jump to a file by name|Cmd+P \\(Quick Open\\)|\n\n## Explorer keyboard shortcuts\n\nThe following table lists the Explorer keyboard shortcuts for macOS and Windows.\n\n|Action|macOS|Windows|\n|------|-----|-------|\n|New file in folder|Cmd+N|Ctrl+N|\n|New folder|Cmd+Shift+N|Ctrl+Shift+N|\n|Rename|F2|F2|\n|Duplicate file|Cmd+D|Ctrl+D|\n|Select all|Cmd+A|Ctrl+A|\n|Copy absolute path|Cmd+Shift+C|Ctrl+Shift+C|\n|Copy relative path|Cmd+Shift+Option+C|Ctrl+Shift+Alt+C|\n|Reveal active file in tree|Cmd+Shift+E|Ctrl+Shift+E|\n|Focus explorer search|Cmd+Shift+F|Ctrl+Shift+F|\n|Toggle dotfiles|Cmd+Shift+.|Ctrl+Shift+.|\n|Undo last file operation|Cmd+Z|Ctrl+Z|\n\n## Explorer panel context menu\n\nRight-clicking the Explorer panel background, rather than a file, shows the panel-level actions in the following table.\n\n|Action|Description|\n|------|-----------|\n|**Add Folder to Workspace**|Adds another project folder to the current workspace|\n|**Expand All**|Expands all folders in the tree|\n|**Collapse All**|Collapses all folders in the tree|\n|**Show Dotfiles**|Toggles visibility of dotfiles such as `.env` and `.gitignore`|\n|**Open Focused Root in Terminal**|Opens a terminal session at the project root|\n|**Reveal Focused Root in Finder**|Opens the project root in Finder \\(macOS\\)|\n\n## File and folder context menu\n\nRight-clicking a file or folder reveals the actions in the following table.\n\n|Action|Description|\n|------|-----------|\n|**New File**|Creates a new file inside the selected folder|\n|**New Folder**|Creates a new subfolder|\n|**Add Page…**|Scaffolds a new Lux page inside the project|\n|**Add Extension Target…**|Adds a new extension target to the project|\n|**Add Glide View Page…**|Scaffolds a new Glide View page|\n|**Copy**|Copies the file or folder|\n|**Cut**|Cuts the file or folder|\n|**Duplicate**|Creates a copy of the file in the same location|\n|**Copy Path**|Copies the absolute path to the clipboard|\n|**Copy Relative Path**|Copies the path relative to the project root|\n|**Reveal in Finder**|Opens the file location in Finder \\(macOS\\)|\n|**Open in Terminal**|Opens a terminal session rooted at this folder|\n|**Rename**|Renames the file or folder inline|\n|**Delete**|Deletes the file or folder|\n\n**Note:** **Add Page…**, **Add Extension Target…**, and **Add Glide View Page…** are unique to Lux Lab and scaffold the corresponding Lux application artifacts directly into your project.\n\n## Inline run and preview icons\n\nFor files that support it, Lux Lab shows the action icons in the following table when you hover over the file in the Explorer tree.\n\n|File type|Icon|Action|\n|---------|----|------|\n|Page file, for example `page.js`|View icon \\(eye\\)|Opens the page in the Preview panel|\n|Server script|Play icon \\(▶\\)|Runs the server script|\n\nThese icons also appear on the parent folder of the file.\n\n## File status markers\n\nThe Explorer reflects Git status using the color and badge markers in the following table.\n\n|Color or marker|Meaning|\n|---------------|-------|\n|Green text|New file \\(untracked or newly added\\)|\n|Yellow or amber text|Modified file|\n|Gray text|Ignored by `.gitignore`|\n|Badge with count|Folder contains N changed files|\n\n## Filtering and searching files\n\nPress Cmd+Shift+F while the Explorer panel is focused to filter the file tree by name. Enter a partial file or folder name, and the tree filters in real time. Press Escape to clear the filter.\n\n## Moving, copying, and selecting files\n\n-   Move: Drag a file onto a destination folder to move it.\n-   Copy: Hold Option \\(macOS\\) or Ctrl \\(Windows\\) while dragging to copy.\n-   Multi-select: Hold Cmd \\(macOS\\) or Ctrl \\(Windows\\) and select multiple files, or use Shift+click for a range.\n\n"}}