{"id":13459622,"url":"https://github.com/yiliansource/party-js","last_synced_at":"2025-04-11T11:47:26.156Z","repository":{"id":37476734,"uuid":"306367093","full_name":"yiliansource/party-js","owner":"yiliansource","description":"A JavaScript library to brighten up your user's site experience with visual effects!","archived":false,"fork":false,"pushed_at":"2023-08-04T13:59:37.000Z","size":3427,"stargazers_count":1008,"open_issues_count":14,"forks_count":47,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-04-09T15:50:11.954Z","etag":null,"topics":["emitters","javascript-library","particles","party","visual-effects"],"latest_commit_sha":null,"homepage":"https://party.js.org","language":"TypeScript","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/yiliansource.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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}},"created_at":"2020-10-22T14:40:41.000Z","updated_at":"2025-04-05T05:30:51.000Z","dependencies_parsed_at":"2024-06-12T15:44:03.679Z","dependency_job_id":"7c21f705-f0b7-4b5f-b097-72b491d9f52b","html_url":"https://github.com/yiliansource/party-js","commit_stats":{"total_commits":80,"total_committers":6,"mean_commits":"13.333333333333334","dds":0.0625,"last_synced_commit":"481b4ed56cda5ae9e7973edc3fa3d6e4dd86b9d6"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yiliansource%2Fparty-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yiliansource%2Fparty-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yiliansource%2Fparty-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yiliansource%2Fparty-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yiliansource","download_url":"https://codeload.github.com/yiliansource/party-js/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248252696,"owners_count":21072701,"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":["emitters","javascript-library","particles","party","visual-effects"],"created_at":"2024-07-31T10:00:23.241Z","updated_at":"2025-04-11T11:47:26.133Z","avatar_url":"https://github.com/yiliansource.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","语言资源库","Uncategorized"],"sub_categories":["typescript","Uncategorized"],"readme":"\u003ch1 align=\"center\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/yiliansource/party-js/main/.github/banner.svg\"/\u003e\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e \u0026bull;\n    \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e \u0026bull;\n    \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://www.npmjs.com/package/party-js\"\u003e\u003cimg alt=\"npm\" src=\"https://img.shields.io/npm/v/party-js?style=flat\"/\u003e\u003c/a\u003e\n    \u003cimg alt=\"GitHub Repo stars\" src=\"https://img.shields.io/github/stars/yiliansource/party-js?style=flat\"\u003e\n    \u003cimg alt=\"GitHub Build Status\" src=\"https://img.shields.io/github/workflow/status/yiliansource/party-js/Node.js%20CI?style=flat\u0026logo=Node.js\"\u003e\n    \u003ca href=\"https://party.js.org/\"\u003e\u003cimg alt=\"GitHub Docs Status\" src=\"https://img.shields.io/github/workflow/status/yiliansource/party-js/Deploy%20documentation?color=blue\u0026label=docs\u0026logo=Read%20the%20Docs\u0026logoColor=white\"\u003e\u003c/a\u003e\n    \u003cimg alt=\"npm downloads\" src=\"https://img.shields.io/npm/dm/party-js?style=flat\"\u003e\n\u003c/p\u003e\n\n## Installation\n\nThe library is written in TypeScript and compiled to an UMD module to allow integration into different environments.\n\n### Browsers\n\nYou can grab the latest version from [jsdelivr](https://www.jsdelivr.com/).\n\n```html\n\u003cscript src=\"https://cdn.jsdelivr.net/npm/party-js@latest/bundle/party.min.js\"\u003e\u003c/script\u003e\n```\n\nThe library instance is loaded into the global `party` object.\n\n### Node.JS\n\nIf you are using a package-managed environment, you can also install the latest version via [npm].\n\n```bash\nnpm install party-js\n# or\nyarn add party-js\n```\n\nTo use it, simply `require` or `import` it.\n\n```ts\nimport party from \"party-js\";\n// or\nconst party = require(\"party-js\");\n```\n\n## Usage\n\nThe library essentially offers a fully customizeable particle-system implementation into HTML documents. Users of the library have the ability to create and fine-tune effects to their individual liking. The library offers a few simple effects right out-of-the-box, so you don't have to waste time re-creating simple effects.\n\n```js\ndocument.querySelector(\".button\").addEventListener(\"click\", function (e) {\n    party.confetti(this, {\n        count: party.variation.range(20, 40),\n    });\n});\n```\n\nIf you want to learn more, check out the [quick start](https://party.js.org/docs/) guide!\n\n## Known Issues\n\n-   _\"The particles are getting cut off inside the screen!\"_  \n    When creating the particle container, the library calculates the document `\u003cbody\u003e`'s size _once_. If your document size changes during the lifetime of your application you can either:\n\n    1. Remove the `#party-js-container`. This forces the library to re-initialize the container and will re-calculate the size. All particles will remain in memory, so nothing will be lost.\n    2. Manually calculate the needed container size and update it yourself. The library does **not** do this on a per-frame basis, in order not to unvoluntarily slow down older devices with timeout polling, and watching for document size changes is an expensive task, as of writing.\n\n## Contributing\n\nFirst of all, thank you so much for wanting to contribute to the project! ❤  \nPlease refer to the [contribution guidelines](./.github/CONTRIBUTING.md) when opening issues or creating pull requests.\n\n[npm]: https://www.npmjs.com/package/party-js\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyiliansource%2Fparty-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyiliansource%2Fparty-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyiliansource%2Fparty-js/lists"}