Skip to content

Introduction

VueFinder is a sleek, developer-friendly file manager component for Vue 3.

What is VueFinder?

VueFinder is a modern, customizable file manager component built for Vue 3. It provides a beautiful, reactive interface that works just like a native file explorer, allowing users to organize, preview, and manage their files seamlessly.

Easily integrate it into your app, connect to any storage (local, S3, etc.), and craft your own cloud experience with full control over uploads, search, and customization.

Key Highlights

Core Capabilities

  • Production-ready file manager — Full-featured, ready for production
  • Zero backend lock-in — Works with any backend (PHP, Node.js, Python, Go, Rust, etc.)
  • Built-in text editor — Edit files directly in the browser
  • Image crop tool — Built-in image cropping and editing
  • Multi-format preview — Preview images, videos, audio, PDFs, and text files
  • Deep search — Recursive folder search with filters
  • Archive management — Create and extract ZIP archives

User Experience

  • Native-like interface — Familiar file explorer UX
  • Context menus — Right-click actions
  • Keyboard shortcuts — Full hotkey support
  • External drag & drop — Drag files from your desktop
  • Tree view sidebar — Hierarchical folder navigation
  • Pinned folders — Quick access to favorites
  • Multiple view modes — Grid and list views
  • Image thumbnails — Lazy-loaded thumbnails
  • Toast notifications — User-friendly feedback

Developer Experience

  • Customizable slots — Customize icons and status bar
  • Flexible selection — Single or multiple selection with MIME type filtering
  • Custom event handlers — Override default double-click behavior
  • Modern tech stack — Built with TanStack Query, Uppy, and Vue 3 Composition API
  • Backend-agnostic architecture — Driver-based system for any storage backend
  • Persistent state — Optional localStorage persistence for user preferences
  • Developer tools — Debug mode and comprehensive error handling

Performance & Quality

  • Lazy loading — Optimized thumbnail loading
  • Efficient rendering — Virtual columns for large file lists
  • Type-safe — Full TypeScript support
  • Accessible — Built with accessibility in mind

Business Value

  • Rapid integration — Get started in minutes, not days
  • Customizable — Extensive theming and feature control
  • Scalable — Handles local storage to cloud backends
  • Well-maintained — Active development and community support

Version

Current Version: 4.0

Version Note

Version 3.0 was skipped for organizational reasons. VueFinder 4.0 represents a significant evolution of the library with a driver-based architecture, enhanced features system, and improved TypeScript support.

Technical Details

  • Vue 3 Compatible - Built from the ground up for Vue 3
  • TypeScript Support - Comprehensive type definitions included
  • Multiple Themes - 12 beautiful themes: light, dark, midnight, latte, rose, mythril, lime, sky, ocean, palenight, arctic, code
  • Multi-language Support - 17 languages: en, tr, ru, de, es, fr, it, ja, nl, pl, pt, sv, ar, fa, he, hi, zhCN, zhTW
  • Flexible Features System - Enable or disable features as needed
  • Local and Remote Drivers - Support for both in-memory and HTTP API backends

If you like it, please follow and ⭐ star on GitHub!