{"id":19869913,"url":"https://github.com/khubaibkhan4/alert-kmp","last_synced_at":"2025-06-23T06:41:12.211Z","repository":{"id":247091762,"uuid":"824011298","full_name":"KhubaibKhan4/Alert-KMP","owner":"KhubaibKhan4","description":"Alert-KMP is a Kotlin Multiplatform (KMP) library designed to facilitate native notification displays across Android, iOS, Web, and Desktop","archived":false,"fork":false,"pushed_at":"2024-12-15T16:30:58.000Z","size":3661,"stargazers_count":81,"open_issues_count":2,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-20T15:06:23.915Z","etag":null,"topics":["composemultiplatform","desktop-library","ios-library","kmp-library","kotlin","kotlin-library","kotlin-multiplatform-library","multiplatform-kotlin-library","web-library"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","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/KhubaibKhan4.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"KhubaibKhan4","patreon":"MuhammadKhubaibImtiaz","open_collective":null,"ko_fi":"muhammadkhubaibimtiaz","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"khubaibkhan","custom":"https://paypal.me/18.bscs"}},"created_at":"2024-07-04T07:31:34.000Z","updated_at":"2025-05-14T18:47:40.000Z","dependencies_parsed_at":"2024-11-10T16:26:14.811Z","dependency_job_id":"d8687875-cbcf-4d59-8ab7-2eb776d398ce","html_url":"https://github.com/KhubaibKhan4/Alert-KMP","commit_stats":null,"previous_names":["khubaibkhan4/alert-kmp"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/KhubaibKhan4/Alert-KMP","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhubaibKhan4%2FAlert-KMP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhubaibKhan4%2FAlert-KMP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhubaibKhan4%2FAlert-KMP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhubaibKhan4%2FAlert-KMP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KhubaibKhan4","download_url":"https://codeload.github.com/KhubaibKhan4/Alert-KMP/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhubaibKhan4%2FAlert-KMP/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261430859,"owners_count":23157164,"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":["composemultiplatform","desktop-library","ios-library","kmp-library","kotlin","kotlin-library","kotlin-multiplatform-library","multiplatform-kotlin-library","web-library"],"created_at":"2024-11-12T16:07:18.561Z","updated_at":"2025-06-23T06:41:07.192Z","avatar_url":"https://github.com/KhubaibKhan4.png","language":"Kotlin","funding_links":["https://github.com/sponsors/KhubaibKhan4","https://patreon.com/MuhammadKhubaibImtiaz","https://ko-fi.com/muhammadkhubaibimtiaz","https://buymeacoffee.com/khubaibkhan","https://paypal.me/18.bscs"],"categories":[],"sub_categories":[],"readme":"# Alert-KMP\n\n[![Maven Central](https://img.shields.io/maven-central/v/io.github.khubaibkhan4/alert-kmp.svg?label=Maven%20Central)](https://search.maven.org/artifact/io.github.khubaibkhan4/alert-kmp)\n![GitHub License](https://img.shields.io/github/license/KhubaibKhan4/Alert-KMP)\n![GitHub Issues](https://img.shields.io/github/issues/KhubaibKhan4/Alert-KMP)\n![GitHub Pull Requests](https://img.shields.io/github/issues-pr/KhubaibKhan4/Alert-KMP)\n![GitHub Last Commit](https://img.shields.io/github/last-commit/KhubaibKhan4/Alert-KMP)\n![GitHub Stars](https://img.shields.io/github/stars/KhubaibKhan4/Alert-KMP?style=social)\n\n![Supported Platforms](https://img.shields.io/badge/platform-Android-green.svg)\n![Supported Platforms](https://img.shields.io/badge/platform-iOS-blue.svg)\n![Supported Platforms](https://img.shields.io/badge/platform-JS-yellow.svg)\n![Supported Platforms](https://img.shields.io/badge/platform-WASM-yellow.svg)\n![Supported Platforms](https://img.shields.io/badge/platform-JVM-red.svg)\n\u003cimg src=\"https://img.shields.io/liberapay/patrons/KhubaibKhanDev.svg?logo=liberapay\"\u003e\n[![Android CI](https://github.com/KhubaibKhan4/Alert-KMP/actions/workflows/android.yml/badge.svg)](https://github.com/KhubaibKhan4/Alert-KMP/actions/workflows/android.yml)\n\n\n## Overview\n\nAlert-KMP is a Kotlin Multiplatform (KMP) library designed to facilitate native notification displays across Android, iOS, Web, and Desktop platforms using JetBrains Compose Multiplatform. It provides a unified API for triggering notifications that seamlessly integrates into Kotlin's multiplatform ecosystem.\n\n## Features\n\n- **Platform Agnostic:** Supports Android, iOS, Web, and Desktop platforms through Kotlin Multiplatform.\n- **Compose Multiplatform Integration:** Seamlessly integrates with JetBrains Compose Multiplatform UI framework.\n- **Customizable Notifications:** Easily customize notification content, icons, actions, and behaviors to suit application needs.\n- **Event Handling:** Provides callbacks and event listeners for notification actions and dismissal.\n- **Local Notifications Support**\n\n## Plans\n\n- **FCM Implementation**\n- **Schedule Native Notifications**\n\n## Installation\n\nYou can include Alert-KMP in your project by adding the following dependency:\n\n### Compose Multiplatform Setup\n\n**Version Catalog**\n```toml\n[versions]\nalertKmp = \"2.0.0\"\n\n[libraries]\nalert-kmp = { module = \"io.github.khubaibkhan4:alert-kmp\", version.ref = \"alertKmp\" }\n```\n\n```groovy\nimplementation(\"io.github.khubaibkhan4:alert-kmp:2.0.0\")\n```\n\n### Platform Specific\n```\n**alert-kmp-jvm**\nimplementation(\"io.github.khubaibkhan4:alert-kmp-jvm:2.0.0\")\n\n**alert-kmp-android**\nimplementation(\"io.github.khubaibkhan4:alert-kmp-android:2.0.0\")\n\n**alert-kmp-js**\nimplementation(\"io.github.khubaibkhan4:alert-kmp-js:2.0.0\")\n\n\n**alert-kmp-wasm-js**\nimplementation(\"io.github.khubaibkhan4:alert-kmp-wasm-js:2.0.0\")\n\n\n```\n\n\n## Usage\n```groovy\nimport io.github.khubaibkhan4.alert.Notification\nimport io.github.khubaibkhan4.alert.NotificationType\nimport io.github.khubaibkhan4.alert.createNotification\n\nfun main() {\n    val notification = createNotification(NotificationType.TOAST)\n    notification.show(\"Hello, World!\")\n\nOR \n\n Notify(message= \"Hellow World!\", duration=NotificationDuration.SHORT)\n}\n```\n## Notification Types\nThe library supports multiple notification types:\n\n- **NotificationType.TOAST** - Displays a toast message.\n- **NotificationType.ALERT** - Displays an alert dialog.\n- **NotificationType.TOP** - Displays a notification at the top of the screen.\n- **NotificationType.CUSTOM** - Displays a custom notification (implementations vary by platform).\n\n## Future Plan's \n- System Level Notificationa.\n\n## 🤝 Connect with Me\n\nLet's chat about potential projects, job opportunities, or any other collaboration! Feel free to connect with me through the following channels:\n\n[![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-blue?style=for-the-badge\u0026logo=linkedin)](https://www.linkedin.com/in/khubaibkhandev)\n[![Twitter](https://img.shields.io/badge/Twitter-Follow-blue?style=for-the-badge\u0026logo=twitter)](https://twitter.com/codespacepro)\n[![Email](https://img.shields.io/badge/Email-Drop%20a%20Message-red?style=for-the-badge\u0026logo=gmail)](mailto:18.bscs.803@gmail.com)\n\n  ## 💰 You can help me by Donating\n  [![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://buymeacoffee.com/khubaibkhan) [![PayPal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge\u0026logo=paypal\u0026logoColor=white)](https://paypal.me/18.bscs) [![Patreon](https://img.shields.io/badge/Patreon-F96854?style=for-the-badge\u0026logo=patreon\u0026logoColor=white)](https://patreon.com/MuhammadKhubaibImtiaz) [![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/muhammadkhubaibimtiaz) \n\n## Screenshots\n| \u003cimg src=\"https://github.com/KhubaibKhan4/Alert-KMP/blob/master/assests/screenshots/1.png\" alt=\"Mobile Screenshot\" width=\"300\"\u003e |\n ![Screenshot 2](https://github.com/KhubaibKhan4/Alert-KMP/blob/master/assests/screenshots/2.png) \n ![Screenshot 3](https://github.com/KhubaibKhan4/Alert-KMP/blob/master/assests/screenshots/3.png) \n\n ## Web Toast\n ![Screenshot 2024-07-19 114919](https://github.com/user-attachments/assets/617a3bc6-c129-45fb-acd2-83fb52866ce9)\n ## Web Top Toast\n ![Screenshot 2024-07-19 115339](https://github.com/user-attachments/assets/dd0ba090-21d9-4566-8097-7cc6eaae252d)\n ## Web Custom \n ![Screenshot 2024-07-19 115753](https://github.com/user-attachments/assets/cfdc1782-8f13-4fff-bda3-dc97214f495f)\n ## Desktop\n ![Screenshot 2024-07-19 120052](https://github.com/user-attachments/assets/d3a58b21-75c4-4f6d-ad92-d86be8fa5429)\n\n ## iOS Alerts\nhttps://github.com/user-attachments/assets/484e976a-0b8d-47fa-84d6-53b3d4733aaa\nhttps://github.com/user-attachments/assets/bd642ecb-55e1-4441-b3fe-a44eb6b84c2d\n\n## Demo\n\nhttps://github.com/KhubaibKhan4/Alert-KMP/assets/98816544/f554204b-d484-49a3-b409-caa7e95c5d04\n\n## Star History\n\n\u003ca href=\"https://star-history.com/#KhubaibKhan4/Alert-KMP\u0026Timeline\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=KhubaibKhan4/Alert-KMP\u0026type=Timeline\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=KhubaibKhan4/Alert-KMP\u0026type=Timeline\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=KhubaibKhan4/Alert-KMP\u0026type=Timeline\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n**Stargazers**\n\n[![Stargazers repo roster for @KhubaibKhan4/Alert-KMP](http://reporoster.com/stars/dark/KhubaibKhan4/Alert-KMP)](https://github.com/KhubaibKhan4/Alert-KMP/stargazers)\n\n**Forkers**\n\n[![Forkers repo roster for @KhubaibKhan4/Alert-KMP](http://reporoster.com/forks/dark/KhubaibKhan4/Alert-KMP)](https://github.com/KhubaibKhan4/Alert-KMP/network/members)\n\n\n  ## Contribution Guidelines\nWe welcome contributions to the Alert-KMP Library Project! To contribute, please follow these guidelines:\n\n- **Reporting Bugs**: If you encounter a bug, please open an issue and provide detailed information about the bug, including steps to reproduce it.\n- **Suggesting Features**: We encourage you to suggest new features or improvements by opening an issue and describing your idea.\n- **Submitting Pull Requests**: If you'd like to contribute code, please fork the repository, create a new branch for your changes, and submit a pull request with a clear description of the changes.\n\n## Code of Conduct\nWe expect all contributors and users of the Alert-KMP Library Project to adhere to our code of conduct. Please review the [Code of Conduct](CODE_OF_CONDUCT.md) for details on expected behavior and reporting procedures.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhubaibkhan4%2Falert-kmp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhubaibkhan4%2Falert-kmp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhubaibkhan4%2Falert-kmp/lists"}