How gtsteffaniak/filebrowser works
Project type and purpose
• This is a full-stack, self-hosted web-based file manager (“FileBrowser Quantum”).
• It provides a Vue.js single-page application (SPA) frontend, a Go-based REST API backend, file storage adapters, a BoltDB database, real-time indexing and preview services, pluggable authentication (OIDC, TOTP, proxy), and a CLI.
File structure
• Top-level “frontend/”: contains a Vite/Vue 3 SPA with components, router, store, assets, CSS, API client modules, and Playwright end-to-end tests.
• Top-level “backend/”: a Go module with subpackages for HTTP (router, middleware, Swagger), authentication, adapters (FS, cache), database (Bolt), indexing, preview engines, events, settings, and CLI commands.
• “_docker/”: Dockerfiles and compose configurations for different runtime modes (general, noauth, proxy) and for running Playwright tests.
• Configuration files: YAML for both backend and Docker.
• Test suites: Go unit tests, JavaScript unit tests, and Playwright E2E.
Extract additional insights from README
• Tech stack: Vue 3 + Vite + Playwright; Go 1.x; BoltDB; Docker.
• Architectural highlights: modular monolith in Go with clear adapter boundaries, real-time indexing, preview pipeline, Swagger API docs, multiple deployment modes.