{"id":26241900,"url":"https://github.com/ddev/addon-registry","last_synced_at":"2026-03-16T22:34:34.310Z","repository":{"id":271931342,"uuid":"914999589","full_name":"ddev/addon-registry","owner":"ddev","description":"A registry for DDEV add-ons where users can discover, explore, and leave comments on available add-ons.","archived":false,"fork":false,"pushed_at":"2025-03-08T00:09:56.000Z","size":346,"stargazers_count":1,"open_issues_count":4,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-08T01:19:54.496Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ddev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["ddev"],"custom":["https://www.paypal.com/donate/?hosted_button_id=MCNCSZHC7LHSQ","https://ddev.com/support-ddev/"]}},"created_at":"2025-01-10T18:45:14.000Z","updated_at":"2025-03-08T00:10:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"ab96bdf8-cad4-4aff-81ae-7559ac330409","html_url":"https://github.com/ddev/addon-registry","commit_stats":null,"previous_names":["stasadev/ddev-addon-registry","ddev/addon-registry"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2Faddon-registry","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2Faddon-registry/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2Faddon-registry/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddev%2Faddon-registry/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ddev","download_url":"https://codeload.github.com/ddev/addon-registry/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243374207,"owners_count":20280657,"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":[],"created_at":"2025-03-13T08:46:09.199Z","updated_at":"2025-12-29T22:15:33.097Z","avatar_url":"https://github.com/ddev.png","language":"HTML","funding_links":["https://github.com/sponsors/ddev","https://www.paypal.com/donate/?hosted_button_id=MCNCSZHC7LHSQ","https://ddev.com/support-ddev/"],"categories":[],"sub_categories":[],"readme":"[![Deploy to GitHub Pages](https://github.com/ddev/addon-registry/actions/workflows/deploy-to-github-pages.yml/badge.svg)](https://ddev.github.io/addon-registry/)\n\n# DDEV Add-on Registry\n\nA registry of DDEV add-ons where users can discover, explore, and leave comments on available add-ons.\n\nSee [DDEV Add-on Registry Introduction](https://ddev.com/blog/ddev-addon-registry-introduction/).\n\nWhile `ddev add-on list` is a fantastic tool, it only scratches the surface when it comes to discovering and exploring add-ons.\n\nThe need for a dedicated registry became clear as we sought to streamline access to add-ons, reduce API limitations, and lessen the maintenance burden.\n\nFor inspiration, [@stasadev](https://github.com/stasadev) looked to the simplicity and functionality of projects like [GTFOBins](https://gtfobins.github.io/), which is built with Jekyll.\n\n## Used Tools\n\nHere are the key tools used to build the DDEV Add-on Registry:\n\n- [GitHub Pages and Jekyll](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll): Jekyll powers the static site, while GitHub Pages hosts it.\n- [List.js](https://listjs.com/): For sorting and searching add-on entries.\n- Add-on comments: [giscus integration](https://github.com/ddev/giscus-comments).\n- Golang: Used to aggregate add-on data into Markdown files, which are transformed into Liquid templates for Jekyll.\n\n## How to Set Up the Registry Locally\n\nGetting started with the DDEV Add-on Registry locally is straightforward. Here's how:\n\n1. Clone the repository: \u003chttps://github.com/ddev/addon-registry\u003e\n2. Run `ddev start` to spin up the environment\n3. Then, launch it by running `ddev launch :4000`\n4. To blacklist an add-on, add it to the `blacklist` array in `go/main.go` at the top of the file. The changes will take effect after `git push`\n5. To update add-ons manually (not required, as it's automated using GitHub Actions):\n    ```bash\n    export DDEV_ADDON_REGISTRY_TOKEN=your-classic-github-token-no-privileges\n    cd go\n    go mod vendor\n    go run main.go\n    ```\n\nYou'll now be able to explore the add-ons within the registry right on your local machine.\n\n## Key Components and Structure\n\nHere's a breakdown of where important content and configuration files live:\n\n- **`.bundle`**: Contains config for local bundler.\n- **`.ddev`**: The DDEV configuration directory.\n- **`.github`**: The GitHub workflows that handle the deployment process.\n- **`_addons`**: Custom Jekyll collection that holds all the add-ons fetched from the community.\n- **`_data`**: User-defined Jekyll data types.\n- **`_includes`**: HTML partials used across the site.\n- **`_layouts`**: The layout templates for Jekyll pages.\n- **`_pages`**: Jekyll pages overrides.\n- **`assets`**: Contains styles and static assets.\n- **`go`**: The Golang app that collects add-on data and populates `_addons`.\n- **`Gemfile`**: The Ruby equivalent of `composer.json`, managing dependencies.\n- **`_config.yml`**: The main configuration file for the Jekyll site.\n- **`addons.json`**: A JSON representation of all the DDEV add-ons.\n- **`index.html`**: The homepage of the registry.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddev%2Faddon-registry","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fddev%2Faddon-registry","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddev%2Faddon-registry/lists"}