{"id":23436913,"url":"https://github.com/logseq/marketplace","last_synced_at":"2025-04-04T09:10:02.953Z","repository":{"id":37014536,"uuid":"402725704","full_name":"logseq/marketplace","owner":"logseq","description":"A centralized packages manager for Logseq marketplace plugins.","archived":false,"fork":false,"pushed_at":"2024-04-13T03:27:27.000Z","size":20806,"stargazers_count":224,"open_issues_count":16,"forks_count":251,"subscribers_count":14,"default_branch":"master","last_synced_at":"2024-04-22T12:23:50.430Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/logseq.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}},"created_at":"2021-09-03T10:05:22.000Z","updated_at":"2024-04-09T20:26:16.000Z","dependencies_parsed_at":"2024-04-14T16:14:12.187Z","dependency_job_id":null,"html_url":"https://github.com/logseq/marketplace","commit_stats":{"total_commits":1117,"total_committers":209,"mean_commits":5.344497607655502,"dds":0.5908683974932856,"last_synced_commit":"473a84608e7252fecef7b8b46785ad262848d80f"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/logseq%2Fmarketplace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/logseq%2Fmarketplace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/logseq%2Fmarketplace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/logseq%2Fmarketplace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/logseq","download_url":"https://codeload.github.com/logseq/marketplace/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246563370,"owners_count":20797444,"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":"2024-12-23T13:34:53.437Z","updated_at":"2025-04-04T09:10:02.932Z","avatar_url":"https://github.com/logseq.png","language":"JavaScript","funding_links":[],"categories":["HTML"],"sub_categories":[],"readme":"# Marketplace packages\n\nA packages manager for Logseq marketplace plugins.\n\n## How to write a plugin for Logseq?\n\nThis [repo](https://github.com/logseq/logseq-plugin-samples) contains sample code illustrating the Logseq Plugin API. You can read, play with or adapt from these samples to create your own plugins.\n\nPlugin APIs: https://plugins-doc.logseq.com/.\n\n\u003e ⚠️ To avoid loading plugin failures occasionally and for performance reasons, \n\u003e it is recommended to keep the plugin SDK [@logseq/libs](https://www.npmjs.com/package/@logseq/libs) as up-to-date as possible.\n\nEnsure that your plugin has a `publish.yml` file, so when you create a release from a tag, it will do the build dance and make you a zip file. Then make a tag (something like v0.0.1), and create a release from it. Ensure the following are true before submitting your plugin:\n- The release has a zip file attached in addition to the \"Source code (zip)\" link. (It might take a minute for build system to create the zip after creating the release.)\n- It's clear from your README what the plugin does, and how to use it.\n- It has at least one image or gif showing it in action.\n\n## How to submit your plugin?\n\n0. Fork this repo to your Github account.\n1. Create a package directory under `./packages` root based on your plugin name.\n2. Write a [manifest.json](./packages/logseq-dev-theme/manifest.json) file to the package root. Valid fields as follows:\n    - `title`- A title for plugin list item display.\n    - `description`- A short description about your plugin.\n    - `author`- The author's name.\n    - `repo`- The GitHub repository identifier, like `{user}/{repo}`.\n    - `icon`- [optional] A logo for better recognition. default: `\"\"`\n    - `theme`- [optional] A theme plugin? default: `false`\n    - `sponsors` - [optional] Sponsor external links. default: `[]`\n    - `web` - [optional] Whether the web browser platform is supported. default: `false`\n    - `effect` - [optional] Whether the sandbox is running under the same origin with host. default: `false`\n      \u003e ⚠️ `effect`? - it's not recommended to turn on this option if you don't \n      need a specific feature (_the current built-in plugin API does not satisfy_), \n      which may affect the stability of the program. If it does need to be turned on, \n      the market review process will be more strict, while there is no guarantee \n      that it will not be allowed to be turned on in the future.\n3. Make a Github Pull Request :)\n\n## How to update plugins' stat?\n\nNote: This step is optional!\n\nTo update the plugins' stat,\nyou need run `scripts/build.mjs` script with a valid\n[GitHub access token](https://github.com/settings/tokens).\nAssuming you have a token,\ntake the following steps:\n\n```sh\nyarn install\ncd scripts\nLSP_MK_TOKEN=YOUR_TOKEN ./build.mjs --stat\n```\n\nEnsure only `stats.json` file is updated.\nIf `errors.json` is changed,\nrerun the steps to ensure no plugin is missed.\n\n## How to report an unavailable or malicious plugin\nIf a plugin is unavailable or you think it contains malicious code, please email [support@logseq.com](mailto:support@logseq.com). Mention the name of the plugin and the URL of its GitHub repository.\n\nThe Logseq team usually responds within a business day.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flogseq%2Fmarketplace","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flogseq%2Fmarketplace","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flogseq%2Fmarketplace/lists"}