How yorukot/superfile works
superfile is a terminal file manager. The main workflow starts in the CLI, loads configuration, launches the Bubble Tea application, and presents file-navigation and preview UI; users can also manage files and inspect metadata. The tree and excerpts support major UI and image-preview components, while README documents themes, hotkeys, and plugins. Some UI and operation wiring is unsampled, so those relationships are omitted rather than inferred; paths for documented but unsampled capabilities use existing enclosing directories.
Main entry points: model.go Application model · main.go CLI and startup · image_preview.go Image preview engine · update.go File panels
Components 22
Application entry
- CLI and startup
src/cmd/main.go
Application state
- Application model
src/internal/model.go - Configuration and hotkeys
src/internal/common/load_config.go - Themes
src/config
Navigation panels
- File model
src/internal/ui/filemodel/update.go - File panels
src/internal/ui/filepanel/update.go - Sidebar
src/internal/ui/sidebar/sidebar.go - Directory jump
src/internal/ui/zoxide/model.go
File features
- File preview panel
src/internal/ui/preview/render.go - File metadata
src/internal/ui/metadata/model.go - File operations
src/internal/handle_file_operations.go - Operation progress
src/internal/ui/processbar/model.go - Clipboard panel
src/internal/ui/clipboard/model.go - Help menu
src/internal/ui/helpmenu/data.go - Plugins
src/internal
Preview and rendering
- Image preview engine
src/pkg/file_preview/image_preview.go - Thumbnail generation
src/pkg/file_preview/thumbnail_generator.go - Preview cache
src/pkg/cache/cache.go - Terminal rendering
src/internal/ui/rendering/renderer.go
Other components
- Terminal user
- Terminal
- Release service
Connections 16
- Terminal user → CLI and startup: starts
- CLI and startup → Configuration and hotkeys: loads
src/cmd/main.go - CLI and startup → Application model: launches
src/cmd/main.go - Application model → File model: updates
src/internal/model.go - Application model → File panels: coordinates
src/internal/model.go - Application model → Sidebar: updates
src/internal/model.go - Application model → File preview panel: updates
src/internal/model.go - Application model → File metadata: requests
src/internal/model.go - Application model → Directory jump: dispatches
src/internal/model.go - File panels → Image preview engine: renders images
- Image preview engine → Preview cache: reads and writes
src/pkg/file_preview/image_preview.go - Image preview engine → Thumbnail generation: generates previews
- File preview panel → Terminal rendering: uses rendering
src/internal/ui/preview/render.go - File operations → Operation progress: reports progress
- Application model → Terminal: renders UI
- CLI and startup → Release service: checks releases
src/cmd/main.go