vuefinder

Vuefinder File Manager

About

A modern, customizable file manager component built for Vue.

Organize, preview, and manage your files through a beautiful, reactive interface — just like a native file explorer.

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.

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

Demo

Live Demo - Explore Vuefinder's features and capabilities in action.

Installation

npm i vuefinder

For detailed installation instructions, configuration options, and usage examples, visit the documentation website.

Backend

You can use any backend language. VueFinder talks to your server through the driver you provide. A driver simply calls your HTTP endpoints and returns data in the expected shape. This keeps VueFinder backend-agnostic while giving you full control over auth, storage, and business rules.

• PHP (recommended for plug‑and‑play): VueFinder Php
• CloudFlare R2: Cloudflare R2

Data contracts are stable and designed to be simple to implement. If you use the PHP package, these endpoints are already provided. For other stacks, mirror the same responses and you're good to go.

The complete API specification is available as an OpenAPI 3.0 specification for easy integration and validation.

Older ecosystem libraries (for VueFinder 3.x and earlier):

• Python: Python WSGI
• Go: vuefinder-go
• Rust: vuefinder-rust

Collaboration

If you want to contribute to the project, please feel free to fork the repository and submit your changes as a pull request. Ensure that the changes you submit are applicable for general use rather than specific to your project.

Dependencies

• Vue 3+
• vue-advanced-cropper : JavaScript image cropper
• viselect : Selection utility
• Uppy : Upload library
• vanilla-lazyload : lightweight and flexible lazy loading for thumbnails
• mitt : Tiny 200 byte functional event emitter / pubsub
• OverlayScrollbars : scrollbar plugin
• nanostores : A tiny state manager
• @nanostores/i18n : Internationalization backend for nanostores
• vue-sonner : Toast notification component
• @floating-ui/dom : Floating UI positioning library
• @tanstack/vue-query : fetching, caching, synchronizing and updating server state

License

Copyright (c) 2018 Yusuf ÖZDEMİR, released under the MIT license