JS implementation of Lychee frontend
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



This repository contains the source of the JS frontend in order to allow its use with different backends.

A great looking and easy-to-use photo-management-system.

Since the 1st of April 2018 this project has moved to it's own Organisation (https://github.com/LycheeOrg) where people are able to submit their fixes to it. We, the Organisation owners, want to thank electerious (Tobias Reich) for the opportunity to make this project live on.

Lychee Lychee

Lychee is a free photo-management tool, which runs on your server or web-space. Installing is a matter of seconds. Upload, manage and share photos like from a native application. Lychee comes with everything you need and all your photos are stored securely. Try the Live Demo or read more on our Website.


To run Lychee, everything you need is a web-server with PHP 5.5 or later and a MySQL-Database. Follow the instructions to install Lychee on your server. Installation »


The frontend send POST requests to the server through. Calls are described in API ».

How to build

If you want to contribute and edit CSS or JS files, you need to rebuild Lychee. Build »

# Clone Lychee
git clone https://github.com/LycheeOrg/Lychee.git

# Initialize the submodules (doc and frontend)
git submodule init

# Get the documentations
git submodule update docs

# Get the frontend
git submodule update Lychee-front

# Go into the frontend
cd Lychee-front


First you have to install the following dependencies:

After installing Node.js you can use the included npm package manager to download all dependencies:

npm install

Build and Generated Files

The Gulpfile is located in <path to lychee>/Lychee-front/ and can be executed using the npm run compile command. The generated files will placed into ../dist/ or <path to lychee>/dist/.

Watch for changes

While developing, you might want to use the following command to automatically build Lychee everytime you save a file:

npm start