{"id":15773915,"url":"https://github.com/akaspanion/css-houdini-bubbles","last_synced_at":"2025-03-14T05:32:11.593Z","repository":{"id":57210910,"uuid":"331413728","full_name":"AKAspanion/css-houdini-bubbles","owner":"AKAspanion","description":"🎨 A CSS Houdini Paint Worklet to draw background bubbles.","archived":false,"fork":false,"pushed_at":"2021-01-27T20:39:08.000Z","size":885,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-26T22:42:31.775Z","etag":null,"topics":["background","bubbles","css","css-houdini","houdini","paint","paintworklet","worklet"],"latest_commit_sha":null,"homepage":"https://codepen.io/spanion/pen/rNMgerx","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AKAspanion.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-01-20T19:45:01.000Z","updated_at":"2021-02-03T12:30:56.000Z","dependencies_parsed_at":"2022-09-01T04:20:28.044Z","dependency_job_id":null,"html_url":"https://github.com/AKAspanion/css-houdini-bubbles","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AKAspanion%2Fcss-houdini-bubbles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AKAspanion%2Fcss-houdini-bubbles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AKAspanion%2Fcss-houdini-bubbles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AKAspanion%2Fcss-houdini-bubbles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AKAspanion","download_url":"https://codeload.github.com/AKAspanion/css-houdini-bubbles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243532517,"owners_count":20306151,"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":["background","bubbles","css","css-houdini","houdini","paint","paintworklet","worklet"],"created_at":"2024-10-04T16:04:04.264Z","updated_at":"2025-03-14T05:32:11.241Z","avatar_url":"https://github.com/AKAspanion.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CSS Houdini Bubbles\n[![NPM](https://img.shields.io/npm/v/css-houdini-bubbles.svg)](https://www.npmjs.com/css-houdini-bubbles) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/AKAspanion/ui-neumorphism/blob/master/LICENSE)\n\u003e A CSS Houdini Paint Worklet to draw background bubbles.\n\n![CSS Houdini Bubbles](https://github.com/AKAspanion/css-houdini-bubbles/blob/main/assets/demo.png?raw=true)\n\n## Usage\n\n### 1. Getting Started\n### Installing using UNPKG\nUsing CDN is the easiest way to add the library: \n\n```javascript\nif ('paintWorklet' in CSS) {\n    CSS.paintWorklet.addModule('https://unpkg.com/css-houdini-bubbles/dist/bubbles.js');\n}\n```\n\nFor old browsers, you need to add a pollyfill.  \nInclude the [css-paint-polyfill](https://github.com/GoogleChromeLabs/css-paint-polyfill) before loading the Worklet.\n\n```javascript\n\u003cscript\u003e\n(async function() {\n    if (CSS['paintWorklet'] === undefined) {\n        await import('https://unpkg.com/css-paint-polyfill');\n    }\n\n    CSS.paintWorklet.addModule('https://unpkg.com/css-houdini-bubbles/dist/bubbles.js');\n})()\n\u003c/script\u003e\n```\n\n#### Installing it Locally\n\nYou can install the `css-houdini-bubbles` locally using NPM.\n\n```bash\nnpm install css-houdini-bubbles\n```\n\n### Usage in CSS\nTo use Bubbles Paint Worklet you need to set the background-image property to `paint(bubbles)`\n```css\n.bubbles {\n    background-image: paint(bubbles);\n}\n```\nBubbles Paint Worklet has few custom properties for tweaking its appearance.\n```css\n.bubbles {\n    --bubbles-colors: #007C8E, #7940c1;\n    --bubbles-min-radius: 20;\n    --bubbles-max-radius: 100;\n    --bubbles-total-num: 30;\n    --bubbles-is-dark: no;\n\n    background-image: paint(bubbles);\n}\n```\n\n| property | description | default value |\n| -------- | ----------- | ------------- |\n| --bubbles-colors | **Colors to use**, one or more hexadecimal colors comma separated | `#007C8E, #7940c1`|\n| --bubbles-min-radius | **Minimum radius**, minimum bubble radius | `10` |\n| --bubbles-max-radius | **Maximum radius**, maximum bubble radius | `60` |\n| --bubbles-total-num | **Number of Bubbles to draw** | `20` |\n| --bubbles-is-dark | **Render bubbles on dark background**, (accepts `yes` or `no` ) | `no` |\n\n## Demo\nPlay around on Codepen [https://codepen.io/spanion/pen/rNMgerx](https://codepen.io/spanion/pen/rNMgerx)\n\n## Acknowledgement\nGot the inspiration from this [video](https://www.youtube.com/watch?v=5eBar5TI71M) by [@una](https://github.com/una)\n\n## License\nMIT","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakaspanion%2Fcss-houdini-bubbles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakaspanion%2Fcss-houdini-bubbles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakaspanion%2Fcss-houdini-bubbles/lists"}