File Browser
Relevant source files
The following files were used as context for generating this wiki page:
The File Browser serves as the centralized hub for project management within the Acode editor. It manages files from internal storage, external SD cards via the Android Storage Access Framework (SAF), and remote servers including FTP and SFTP.
Users interact with the File Browser through two primary states: the Home View for connection management and the Project/Folder View for content manipulation. The system integrates with the Sidebar to establish an Active Workspace, allowing for persistent access to project directories while editing.
Sources: user-guide/file-browser.md:20-22, user-guide/index.md:37-41
Home View and Connection Management
The Home View manages storage paths and remote connections. Users add local or remote storage to the environment via the "Add Connection" menu.
The diagram above illustrates the navigation flow from the Home View to various connection and configuration options.
Top Bar Actions
The Home View interface includes specific controls for batch operations and connection maintenance:
| Icon Name | Action | Description |
|---|---|---|
| Selection Mode | Toggle | Enables selection of multiple items for batch operations like deletion. |
| Add Connection | Open Menu | Provides options for local paths, FTP, or SFTP setup. |
| Menu | Open Actions | Accesses settings, connection resets, and list reloading. |
Sources: user-guide/file-browser.md:28-48
Project and Folder View
Entering a directory transitions the UI to focus on content creation and file manipulation. This view displays the contents of the selected path and provides tools for initializing development environments.
File and Project Creation
Within a folder, the creation menu provides four primary actions:
- New File: Generates a blank file in the current directory.
- New Folder: Creates a new subdirectory.
- New Project: Initializes a project using built-in templates.
- Import Project: Extracts content from a
.ziparchive into the current path.
Sources: user-guide/file-browser.md:52-64
Contextual Actions
Performing a long press on a file or folder activates a context menu for item-specific operations.
This sequence shows the interaction pattern for modifying existing file system entries.
| Action | Result |
|---|---|
| Delete | Permanently removes the item. |
| Rename | Modifies the file or folder name. |
| Info | Displays properties: size, permissions, and full path. |
| Open With | Forces a specific mode or external application for the file. |
| Copy URI | Copies the absolute file path to the clipboard. |
Sources: user-guide/file-browser.md:66-79
Active Workspace Integration
The File Browser defines the Active Workspace by setting the currently visible folder into the side panel.
- Navigate to the desired directory.
- Click the Open button (Check icon) at the bottom right.
- The directory loads into the sidebar for rapid access during editing sessions.
Sources: user-guide/file-browser.md:81-87
Global Configuration
File Browser behavior is governed by global application settings. These settings control how files are discovered, displayed, and remembered across sessions.
| Setting | Function | Source |
|---|---|---|
| Remember Folders | Reopens previously active folders upon application launch. | app-settings.md:23 |
| Exclude Files | Uses glob patterns (e.g., **/node_modules/**) to hide files from indexing and search. | app-settings.md:25 |
| Check File Changes | Monitors the file system for external changes to notify or reload files. | app-settings.md:24 |
| Show Hidden Files | Toggles visibility of dotfiles/hidden entries in the browser. | file-browser.md:46 |
Sources: user-guide/settings/app-settings.md:21-25, user-guide/file-browser.md:46
Summary
The File Browser provides the foundational interface for managing the Acode project lifecycle. It bridges local Android storage (via SAF) with remote development environments (FTP/SFTP). Through its dual-view architecture, it enables both high-level connection management and granular file operations, while its integration with the Active Workspace and global settings ensures a persistent and customizable development environment.
Sources: user-guide/file-browser.md:20-87, user-guide/index.md:37-41