{"id":13395339,"url":"https://github.com/getmeli/meli","last_synced_at":"2025-05-15T11:08:32.416Z","repository":{"id":41434447,"uuid":"317239950","full_name":"getmeli/meli","owner":"getmeli","description":"Platform for deploying static sites and frontend applications easily. Automatic SSL, deploy previews, reverse proxy, and more.","archived":false,"fork":false,"pushed_at":"2023-03-15T10:46:34.000Z","size":3051,"stargazers_count":2418,"open_issues_count":41,"forks_count":96,"subscribers_count":26,"default_branch":"beta","last_synced_at":"2025-04-14T19:58:51.569Z","etag":null,"topics":["angular","deploy","deployment","deployment-automation","frontend","gatsby","getmeli","hosting","jamstack","meli","react","vue","webdev"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getmeli.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-11-30T13:56:42.000Z","updated_at":"2025-03-31T12:32:07.000Z","dependencies_parsed_at":"2024-01-06T07:53:12.864Z","dependency_job_id":"d709fcf5-59e8-49fa-9889-cdc291c8b383","html_url":"https://github.com/getmeli/meli","commit_stats":null,"previous_names":[],"tags_count":68,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getmeli%2Fmeli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getmeli%2Fmeli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getmeli%2Fmeli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getmeli%2Fmeli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getmeli","download_url":"https://codeload.github.com/getmeli/meli/tar.gz/refs/heads/beta","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254328385,"owners_count":22052632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","deploy","deployment","deployment-automation","frontend","gatsby","getmeli","hosting","jamstack","meli","react","vue","webdev"],"created_at":"2024-07-30T17:01:53.053Z","updated_at":"2025-05-15T11:08:32.393Z","avatar_url":"https://github.com/getmeli.png","language":"TypeScript","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://meli.sh\"\u003e\n    \u003cimg alt=\"meli-logo\" src=\"https://raw.githubusercontent.com/gomeli/meli-brand/latest/logo/meli-logo-circle-black.svg\" width=\"100\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003emeli\u003c/h1\u003e\n\u003cp align=\"center\"\u003eOpen source platform for deploying static sites and frontend applications.\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://docs.meli.charlie-bravo.be\"\u003eDocs\u003c/a\u003e (proudly hosted on Meli !) - \u003ca href=\"https://twitter.com/getmeli\"\u003eTwitter\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://discord.gg/TFTaCUEdX6\" target=\"_blank\"\u003e\n        \u003cimg alt=\"Discord\" src=\"https://img.shields.io/discord/789462736320856075?label=community\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003e We are looking for maintainers ! Interested to take over ? Shoot us an email at info@charlie-bravo.be\n\n![Meli demo screenshot](https://raw.githubusercontent.com/getmeli/meli-brand/latest/screens/meli-site-branch.png)\n\n## Getting started\n\nWant to change the way you ship front-end, forever ? Let's get started !\n\n1. Head to our [installation instructions](https://docs.meli.charlie-bravo.be/get-started/installation)\n1. After you have installed Meli and have successfully logged in:\n    1. Create a site in your dashboard, say `my-site`\n    1. [Upload a release with the `@getmeli/meli` CLI](https://docs.meli.charlie-bravo.be/get-started/upload-a-site-to-meli)\n    1. Setup `my-domain.com` to point to your Meli server at `my-site.mymeli.com`\n\n## Features\n\n- Deploy unlimited static sites under a primary domain\n- Unlimited organizations, teams, users and sites\n- Seamless custom domains redirection\n- [Many ways to authenticate](https://docs.meli.charlie-bravo.be/authentication)\n- [Automatic HTTPs certificate issuing with letsencrypt (or private ACME server)](https://docs.meli.charlie-bravo.be/configuration/ssl)\n- [Deploy branches](https://docs.meli.charlie-bravo.be/get-started/branches)\n- [API with per-endpoint scopes](https://docs.meli.charlie-bravo.be/api/get-started)\n- Integrations ([Webhooks](https://docs.meli.charlie-bravo.be/integrations/webhooks), [Slack](https://docs.meli.charlie-bravo.be/integrations/slack)\n  , [Mattermost](https://docs.meli.charlie-bravo.be/integrations/mattermost), [Email](https://docs.meli.charlie-bravo.be/integrations/email))\n- Easily [deploy](https://docs.meli.charlie-bravo.be/get-started/installation#installation)\n  and [upgrade](https://docs.meli.charlie-bravo.be/get-started/upgrade-and-downgrade) with Docker Compose\n- [Password protected pages](https://docs.meli.charlie-bravo.be/branches/password-protected-pages)\n- [Path overrides with in-memory files or reverse proxies](https://docs.meli.charlie-bravo.be/branches/redirects#redirects)\n- [Single page application mode](https://docs.meli.charlie-bravo.be/get-started/single-page-applications-spa)\n- Get deploy URL in pull requests and commit status\n- [Heavily customizable](https://docs.meli.charlie-bravo.be/environment-reference/server)\n- [ ] Increase test coverage\n- [ ] API documentation\n- [ ] Documentation\n- [ ] Build an official project website\n- [ ] Create a community discussion branch\n- [ ] Deploy a cloud version\n- [ ] Translations\n- [ ] Extend integrations\n- [ ] Accessibility\n\n## Development\n\n1. Run `docker-compose -f ./docker-compose-dev.yml up -d`\n1. Configure `server/.env` (copy `server/.env.example` to start with)\n1. Run `npm i \u0026\u0026 npm start`\n\nYou can now browse at `http://localhost:8080`:\n\n- `http://localhost:8080/` =\u003e UI\n- `http://localhost:8080/api`, `http://localhost:8080/auth`, `http://localhost:8080/system` and `http://localhost:8080/socket.io` =\u003e API\n- `http://loopback.sh` =\u003e your sites will be served here\n\n### DNS config\n\nYou need to configure your machine to allow wildcard domains for development. We've got a few ways to do this.\n\n#### Use loopback.sh\n\nWe've configured loopback.sh to point to 127.0.0.1, so you can develop with it. Update your `.env`.\n\n```\nMELI_SITES_URL=loopback.sh\n```\n\nYour sites will be served at `*.loopback.sh`.\n\nPros: simple, no config required Cons: you need to be connected to the internet\n\n#### Using /etc/hosts\n\nUnfortunately, /etc/hosts doesn't support wildcard domains, so you'll need to edit /etc/hosts for every site added to Meli:\n\n```\n127.0.0.1 my-site.test\n127.0.0.1 my-channel.my-site.test\n```\n\nPros: simple, can develop without internet Cons: have to reconfigure every time you add a site\n\n#### Using dnsmasq\n\n```\nbrew install dnsmasq\n\n# tell dsnmasq to point *.test to 127.0.0.1\necho \"address=/test/127.0.0.1\" \u003e /usr/local/etc/dnsmasq.conf\n\n# start daemon\nbrew services start dnsmasq\n\n# make OSX point to dnsmasq\nsudo mkdir -p /etc/resolver\n\n# tell os x to point *.test to 127.0.0.1\nsudo echo \"nameserver 127.0.0.1\" \u003e /etc/resolver/test\n\nping hello.test\n```\n\nYour sites will be served at `*.test`.\n\nPros: you don't need to be connected to the internet, no need to reconfigure /etc/hosts Cons: a bit complex, config required\n\n## License\n\nThe words \"Open Source\" in our README refer to the definition given by many well-recognized dictionaries of various languages, which is \"\nused to describe software for which the original source code is made available to anyone\".\n\nThe words \"Open Source\" in our license, introduced and written by MariaDB, refer to the definition given by the Open Source Foundation.\nThough 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\non this matter.\n\nThe BSL license allows you to modify, share, redistribute and use this software for free with the only condition that you do not run a\ncompeting SAAS service based on this project, which would both be unfair and jeopardize the options of making this tool sustainable.\n\nWe chose the BSL license because we believe it is fair for both users and maintainers. It allows us to secure a monetization path while\nproviding proper support in the long run. Also, our license converts automatically within 4 years of each release to a license officially\nrecognized by the Open Source Foundation, which secures a way for the community to see the sole restriction removed.\n\nWe are aware of the debate around the BSL conflicting with rule number 9 of the definition given by the Open Source Foundation. We do\nbelieve that, in specific cases, this rule should be relaxed as it prevents platform maintainers to secure a path to sustaining the\ndevelopment of their tool and support of their community while preventing large players from running unfair competition by leveraging their\ninfrastructure and name. There is sufficient material on this matter available on the internet for users to make up their mind.\n\nAs 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\nits own way, while still being officially recognized by the Open Source Foundation.\n","funding_links":[],"categories":["TypeScript","angular"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetmeli%2Fmeli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetmeli%2Fmeli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetmeli%2Fmeli/lists"}