PHPackages                             ikromjon/nativephp-mobile-local-notifications - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail &amp; Notifications](/categories/mail)
4. /
5. ikromjon/nativephp-mobile-local-notifications

ActiveNativephp-plugin[Mail &amp; Notifications](/categories/mail)

ikromjon/nativephp-mobile-local-notifications
=============================================

Local notifications plugin for NativePHP Mobile - schedule, cancel, and manage local notifications with channels, badges, sounds, and repeat intervals

v1.10.0(2mo ago)6203↓61.1%1[1 PRs](https://github.com/Ikromjon1998/nativephp-mobile-local-notifications/pulls)MITPHPPHP ^8.3CI passing

Since Mar 8Pushed 2mo agoCompare

[ Source](https://github.com/Ikromjon1998/nativephp-mobile-local-notifications)[ Packagist](https://packagist.org/packages/ikromjon/nativephp-mobile-local-notifications)[ RSS](/packages/ikromjon-nativephp-mobile-local-notifications/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (10)Dependencies (15)Versions (36)Used By (0)

 [![Local Notifications Logo](logo.png)](logo.png)

NativePHP Mobile Local Notifications
====================================

[](#nativephp-mobile-local-notifications)

[![Latest Version on Packagist](https://camo.githubusercontent.com/6079893bf373f4b6c82255dcc17b2ddd909e5ca760c15247674782f8fc3a4ad5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696b726f6d6a6f6e2f6e61746976657068702d6d6f62696c652d6c6f63616c2d6e6f74696669636174696f6e732e737667)](https://packagist.org/packages/ikromjon/nativephp-mobile-local-notifications)[![Tests](https://github.com/Ikromjon1998/nativephp-mobile-local-notifications/actions/workflows/tests.yml/badge.svg)](https://github.com/Ikromjon1998/nativephp-mobile-local-notifications/actions/workflows/tests.yml)[![Total Downloads](https://camo.githubusercontent.com/63db033c92a900bf7ce23899f6c038c89de91c2a83b885333cf1ac2c6f521775/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f696b726f6d6a6f6e2f6e61746976657068702d6d6f62696c652d6c6f63616c2d6e6f74696669636174696f6e732e737667)](https://packagist.org/packages/ikromjon/nativephp-mobile-local-notifications)[![License](https://camo.githubusercontent.com/5478dd01e2914384cb5e0dd0db57db79b1340b69ae0bf58a3414d80a2cbb887a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f696b726f6d6a6f6e2f6e61746976657068702d6d6f62696c652d6c6f63616c2d6e6f74696669636174696f6e732e737667)](https://packagist.org/packages/ikromjon/nativephp-mobile-local-notifications)

Schedule, manage, and cancel local notifications in your NativePHP Mobile app — no server or Firebase required.

Quick Start
-----------

[](#quick-start)

```
use Ikromjon\LocalNotifications\Facades\LocalNotifications;

// Request permission (required on Android 13+ and iOS)
LocalNotifications::requestPermission();

// Schedule a notification in 10 seconds
LocalNotifications::schedule([
    'id' => 'welcome',
    'title' => 'Hello!',
    'body' => 'Your first local notification',
    'delay' => 10,
]);
```

How is this different?
----------------------

[](#how-is-this-different)

PluginWhat it doesRequires**nativephp/mobile-dialog**Toast/snackbar messages (in-app only, disappear when app closes)Nothing**nativephp/mobile-firebase**Push notifications from a server via FCM/APNsFirebase project, server, internet**This plugin**Local notifications scheduled on-deviceNothing — works offlineFeatures
--------

[](#features)

- Schedule notifications with a delay or at a specific time
- Repeat intervals: minute, hourly, daily, weekly, monthly, yearly
- Custom repeat intervals (any duration &gt;= 60 seconds)
- Day-of-week scheduling (e.g. every Mon/Wed/Fri at 9 AM)
- Repeat count limits (fire N times then stop)
- Rich content: images, subtitles, and expanded text
- Action buttons with text input support (configurable limit, default 3)
- Native snooze (reschedules without opening the app)
- Custom sounds, badges, and data payloads
- Cancel individual or all notifications
- List pending notifications
- Update existing notifications
- Permission management (Android 13+, iOS)
- Laravel Notification channel support
- Survives device reboot (Android)
- Events for notification lifecycle (scheduled, received, tapped, action pressed)
- Cold-start tap event auto-flush via Blade component
- Works completely offline — no server or Firebase needed

Documentation
-------------

[](#documentation)

GuideDescription[Getting Started](docs/getting-started.md)Installation, configuration, cold-start setup, requirements[Scheduling](docs/scheduling.md)Schedule, cancel, update, list notifications, type-safe DTO[Events](docs/events.md)Listen in Livewire, Laravel event listeners, or JavaScript[Repeat Intervals](docs/repeat-intervals.md)Standard intervals, custom durations, day-of-week, count limits[Rich Content](docs/rich-content.md)Images, subtitles, expanded text[Custom Sounds](docs/custom-sounds.md)Custom sound files per notification[Action Buttons](docs/action-buttons.md)Tap actions, text input, native snooze[Laravel Notification Channel](docs/laravel-notification-channel.md)Standard `$user->notify()` pattern[JavaScript API](docs/javascript-api.md)Full API for Vue, React, and Inertia apps[Permissions](docs/permissions.md)Android and iOS permission requirements[Troubleshooting](docs/troubleshooting.md)Common issues and solutions[Upgrading](docs/upgrading.md)Migration guides between versionsExample App
-----------

[](#example-app)

**[Daily Habits](https://github.com/Ikromjon1998/daily-habits)** is a full, open-source mobile app built with this plugin. It demonstrates scheduling, action buttons, snooze, custom sounds, the Laravel Notification channel, and a notification debug panel with 9 test scenarios.

Testing
-------

[](#testing)

```
composer test        # Run tests
composer analyse     # Run static analysis
```

Contributing
------------

[](#contributing)

Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions, development workflow, and guidelines.

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for a list of changes in each release.

Roadmap
-------

[](#roadmap)

See [ROADMAP.md](ROADMAP.md) for planned features and their status.

Support
-------

[](#support)

For questions or issues, use [GitHub Issues](https://github.com/Ikromjon1998/nativephp-mobile-local-notifications/issues) or contact:

License
-------

[](#license)

MIT

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance86

Actively maintained with recent releases

Popularity21

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

22

Last Release

78d ago

PHP version history (2 changes)v1.0.0PHP ^8.2

v1.1.0PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/e842ce53c5da80b37318566ca16f298f971b9494b1c7afea5f9ae0b65d208e01?d=identicon)[Ikromjon1998](/maintainers/Ikromjon1998)

---

Top Contributors

[![Ikromjon1998](https://avatars.githubusercontent.com/u/57859849?v=4)](https://github.com/Ikromjon1998 "Ikromjon1998 (95 commits)")

---

Tags

laravelnotificationsschedulemobilenativephpreminderslocal-notifications

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ikromjon-nativephp-mobile-local-notifications/health.svg)

```
[![Health](https://phpackages.com/badges/ikromjon-nativephp-mobile-local-notifications/health.svg)](https://phpackages.com/packages/ikromjon-nativephp-mobile-local-notifications)
```

###  Alternatives

[propaganistas/laravel-disposable-email

Disposable email validator

6012.9M7](/packages/propaganistas-laravel-disposable-email)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
