{"id":32149551,"url":"https://github.com/kudit/particleeffects","last_synced_at":"2025-10-21T10:00:05.690Z","repository":{"id":238076166,"uuid":"795808988","full_name":"kudit/ParticleEffects","owner":"kudit","description":"ParticleEffects allows developers to create particle systems with minimal effort that are compatible with macOS, iOS, iPadOS, visionOS, tvOS, and watchOS.","archived":false,"fork":false,"pushed_at":"2025-06-12T03:36:13.000Z","size":8907,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-21T09:59:43.905Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Swift","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/kudit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","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":"2024-05-04T05:49:12.000Z","updated_at":"2025-06-12T03:36:17.000Z","dependencies_parsed_at":"2024-05-07T06:31:19.435Z","dependency_job_id":"4b352e93-70ac-4390-99db-5c017cdc2df9","html_url":"https://github.com/kudit/ParticleEffects","commit_stats":null,"previous_names":["kudit/motioneffects","kudit/particleeffects"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/kudit/ParticleEffects","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kudit%2FParticleEffects","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kudit%2FParticleEffects/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kudit%2FParticleEffects/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kudit%2FParticleEffects/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kudit","download_url":"https://codeload.github.com/kudit/ParticleEffects/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kudit%2FParticleEffects/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280240317,"owners_count":26296527,"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","status":"online","status_checked_at":"2025-10-21T02:00:06.614Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-10-21T10:00:02.026Z","updated_at":"2025-10-21T10:00:05.685Z","avatar_url":"https://github.com/kudit.png","language":"Swift","funding_links":["http://paypal.me/kudit"],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"/Development/Resources/Assets.xcassets/AppIcon.appiconset/Icon.png\" height=\"128\"\u003e\n\n[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fkudit%2FParticleEffects%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/kudit/ParticleEffects)\n\n# ParticleEffects.swiftpm\nParticleEffects allows developers to create particle systems with minimal effort that are compatible with macOS, iOS, iPadOS, visionOS, tvOS, and watchOS.\n\nThe primary goals are to be easily maintainable by multiple individuals, employ a consistent API that can be used across all platforms, and to be maintainable using Swift Playgrounds on iPad and macOS.  APIs are typically present even on platforms that don't support all features so that availability checks do not have to be performed in external code, and where irrelevant, code can simply return optionals.\n\nThis is actively maintained so if there is a feature request or change, we will strive to address within a week.\n\n\n## Features\n- Can develop and modify without Xcode using Swift Playgrounds on iPad!\n- SF Symbol particles\n- Image particles\n- Emoji particles\n- Text particles\n- Easily specify multiple symbols/images/emoji/text to use by comma-separating a string.\n- Emmitter customizations\n\n\n## Requirements\nMost of these minimums are dictated by our usage of Date.now which is needed.\n- iOS 15+ (15.2+ minimum required for Swift Playgrounds support)\n- macOS 12+\n- macCatalyst 13.0+ (first version available)\n- tvOS 15.0+\n- watchOS 8.0+\n- visionOS 1.0+\n- Theoretically should work with Linux, Windows, and Vapor, but haven't tested.  If you would like to help, please let us know.\n\n\n## Known Issues\n*See CHANGELOG.md for known issues and roadmap*\n\n\n## Installation\nInstall by adding this as a package dependency to your code.  This can be done in Xcode or Swift Playgrounds!\n\n### Swift Package Manager\n\n#### Swift 5+\nYou can try these examples in a Swift Playground by adding package: `https://github.com/kudit/ParticleEffects`\n\nIf the repository is private, use the following link to import: `https://\u003cyour-PAT-string\u003e@github.com/kudit/ParticleEffects.git`\n\nOr you can manually enter the following in the Package.swift file:\n```swift\ndependencies: [\n    .package(url: \"https://github.com/kudit/ParticleEffects.git\", from: \"1.0.0\"),\n]\n```\n\n\n## Usage\nFirst make sure to import the framework:\n```swift\nimport ParticleEffects\n```\n\nHere are some usage examples.\n\n### Get the version of ParticleEffects that is imported.\n```swift\nlet version = ParticleEffects.version\n```\n\n### Create a simple fire emitter.\n```swift\nParticleSystemView(behavior: .fire)\n    .font(.largeTitle)\n    .aspectRatio(contentMode: .fit)\n```\n\n### Create a rainbow sunburst emitter.  Note the ability to take a base behavior and modify specific values.\n```swift\nParticleSystemView(behavior:\n    .sun.modified(\n        string: \"star.fill\",\n        birthRate: .frequent,\n        blur: Blur.none,\n        coloring: .rainbow\n    )\n).aspectRatio(contentMode: .fit)\n```\n\n### Create an emoji confetti emitter.\n```swift\nParticleSystemView(behavior: .fountain, string: \"😊,👍,☺️,👏,🙌\")\n```\n\nAll these tests can be demonstrated using previews or by running the app executable that is bundled in the Development folder of the module.\n\n## Thanks\nInspired by [Effects Library by GetStream](https://github.com/GetStream/effects-library)\n\n## Contributing\nIf you have the need for a specific feature that you want implemented or if you experienced a bug, please open an issue.\nIf you extended the functionality yourself and want others to use it too, please submit a pull request.\n\n\n## Donations\nThis was a lot of work.  If you find this useful particularly if you use this in a commercial product, please consider making a donation to http://paypal.me/kudit\n\n\n## License\nFeel free to use this in projects, however, please include a link back to this project and credit somewhere in the app.  Example Markdown and string interpolation for the version:\n```swift\nText(\"Open Source projects used include [ParticleEffects](https://github.com/kudit/ParticleEffects) v\\(ParticleEffects.version)\n```\n\n\n## Contributors\nThe complete list of people who contributed to this project is available [here](https://github.com/kudit/ParticleEffects/graphs/contributors).\nA big thanks to everyone who has contributed! 🙏\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkudit%2Fparticleeffects","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkudit%2Fparticleeffects","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkudit%2Fparticleeffects/lists"}