File Browser
Search…
File Browser
Welcome
Features
Installation
Upgrade from 1.x
Command Line Interface
Configuration
Contributing
Authentication Provider
Translations
CI and Releases
Code of Conduct
Powered By GitBook
Contributing
If you're interested in contributing to this project, this is the best place to start. Before contributing to this project, please take a bit of time to read our Code of Conduct. Also, note that this project is open-source and licensed under Apache License 2.0.

Project Structure

The project is mainly composed by one repository, hosted on GitHub. The backend side of the application is written in Go, while the frontend (located on a subdirectory of the same name) is written in Vue.js, a framework to produce JavaScript, CSS and HTML.
Due to the tight coupling required by some features, basic knowledge of both Go and Vue.js is recommended.

Get the source code

We encourage you to use git to manage your fork. To clone the main repository, just run:
git clone https://github.com/filebrowser/filebrowser

Build

Frontend

We are using Node.js on the frontend to manage the build process. The steps to build it are:
# From the root of the repo, go to frontend/
cd frontend
# Install the dependencies
npm install
# Build the frontend
npm run build
This will install the dependencies and build the frontend so you can then embed it into the Go app. Although, if you want to play with it, you'll get bored of building it after every change you do. So, you can run the command below to watch for changes:
npm run watch

Backend

First of all, you need to download the required dependencies. We are using the built-in go mod tool for dependency management. To get the modules, run:
go mod download
The magic of File Browser is that the static assets are bundled into the final binary. For that, we use Go embed.FS. The files from frontend/dist will be embedded during the build process.
To build File Browser is just like any other Go program:
go build
Previous
Command Runner
Next
Authentication Provider
Last modified 9mo ago
Copy link
Outline
Project Structure
Get the source code
Build
Frontend
Backend