Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
December 4, 2020 14:31
December 2, 2020 15:15
December 2, 2020 15:15
May 25, 2021 21:45
March 15, 2023 10:34
December 2, 2020 15:15
March 19, 2021 14:36
March 15, 2023 10:34
December 2, 2020 15:15



Open source platform for deploying static sites and frontend applications.

Docs (proudly hosted on Meli !) - Twitter


We are looking for maintainers ! Interested to take over ? Shoot us an email at

Meli demo screenshot

Getting started

Want to change the way you ship front-end, forever ? Let's get started !

  1. Head to our installation instructions
  2. After you have installed Meli and have successfully logged in:
    1. Create a site in your dashboard, say my-site
    2. Upload a release with the @getmeli/meli CLI
    3. Setup to point to your Meli server at



  1. Run docker-compose -f ./docker-compose-dev.yml up -d
  2. Configure server/.env (copy server/.env.example to start with)
  3. Run npm i && npm start

You can now browse at http://localhost:8080:

  • http://localhost:8080/ => UI
  • http://localhost:8080/api, http://localhost:8080/auth, http://localhost:8080/system and http://localhost:8080/ => API
  • => your sites will be served here

DNS config

You need to configure your machine to allow wildcard domains for development. We've got a few ways to do this.


We've configured to point to, so you can develop with it. Update your .env.

Your sites will be served at *

Pros: simple, no config required Cons: you need to be connected to the internet

Using /etc/hosts

Unfortunately, /etc/hosts doesn't support wildcard domains, so you'll need to edit /etc/hosts for every site added to Meli: my-site.test

Pros: simple, can develop without internet Cons: have to reconfigure every time you add a site

Using dnsmasq

brew install dnsmasq

# tell dsnmasq to point *.test to
echo "address=/test/" > /usr/local/etc/dnsmasq.conf

# start daemon
brew services start dnsmasq

# make OSX point to dnsmasq
sudo mkdir -p /etc/resolver

# tell os x to point *.test to
sudo echo "nameserver" > /etc/resolver/test

ping hello.test

Your sites will be served at *.test.

Pros: you don't need to be connected to the internet, no need to reconfigure /etc/hosts Cons: a bit complex, config required


The words "Open Source" in our README refer to the definition given by many well-recognized dictionaries of various languages, which is " used to describe software for which the original source code is made available to anyone".

The words "Open Source" in our license, introduced and written by MariaDB, refer to the definition given by the Open Source Foundation. Though we adopted this license to make it easier for users to recognize it, we disagree with this sentence being part of it and are working on this matter.

The BSL license allows you to modify, share, redistribute and use this software for free with the only condition that you do not run a competing SAAS service based on this project, which would both be unfair and jeopardize the options of making this tool sustainable.

We chose the BSL license because we believe it is fair for both users and maintainers. It allows us to secure a monetization path while providing proper support in the long run. Also, our license converts automatically within 4 years of each release to a license officially recognized by the Open Source Foundation, which secures a way for the community to see the sole restriction removed.

We are aware of the debate around the BSL conflicting with rule number 9 of the definition given by the Open Source Foundation. We do believe that, in specific cases, this rule should be relaxed as it prevents platform maintainers to secure a path to sustaining the development of their tool and support of their community while preventing large players from running unfair competition by leveraging their infrastructure and name. There is sufficient material on this matter available on the internet for users to make up their mind.

As a side note, rule number 9 conflicts similarly with the BSL than with the GPL3.0, which does restrict the creation of other software in its own way, while still being officially recognized by the Open Source Foundation.