PHPackages                             bissolli/nova-phone-field - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. bissolli/nova-phone-field

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

bissolli/nova-phone-field
=========================

Nova Phone Number field with a dynamic mask based on the country code inserted by the user.

v0.0.4(6y ago)31413.4k↓29.1%5[5 issues](https://github.com/bissolli/nova-phone-field/issues)1MITVuePHP &gt;=7.1.0

Since Nov 12Pushed 6y ago2 watchersCompare

[ Source](https://github.com/bissolli/nova-phone-field)[ Packagist](https://packagist.org/packages/bissolli/nova-phone-field)[ Docs](https://github.com/bissolli/nova-phone-field)[ RSS](/packages/bissolli-nova-phone-field/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (4)DependenciesVersions (6)Used By (1)

A global Phone Number field for Laravel Nova
============================================

[](#a-global-phone-number-field-for-laravel-nova)

[![Latest Version on Packagist](https://camo.githubusercontent.com/d66c210d7cb45b0238610172a53445835879de7f4db056b59285b2942900a13f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626973736f6c6c692f6e6f76612d70686f6e652d6669656c642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bissolli/nova-phone-field)[![Total Downloads](https://camo.githubusercontent.com/0c14b9b73c3b60c0ce683b7a1eeb92d20670b3578e2dee3df485b9ee0fa13498/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626973736f6c6c692f6e6f76612d70686f6e652d6669656c642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bissolli/nova-phone-field)[![StyleCI](https://camo.githubusercontent.com/c0a5d884199b5ad3e3fc081cb3ccf2a31af0c19ab341ec4d409b54cc6dc53324/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3135373231393733332f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/157219733)

Nova Phone Number field with a dynamic mask based on the country code inserted by the user.

[![screenshot of the phone field](https://raw.githubusercontent.com/bissolli/nova-phone-field/master/screenshots/nova-phone-field.gif)](https://raw.githubusercontent.com/bissolli/nova-phone-field/master/screenshots/nova-phone-field.gif)

Requirements
------------

[](#requirements)

- Laravel Nova
- Laravel Framework **5.7+ / 6.0+**

**NOTE**: For Laravel version &lt;= 5.6 use our package version [v.0.0.3](https://github.com/bissolli/nova-phone-field/tree/v0.0.3)

Installation
------------

[](#installation)

You can install this package into a Laravel app that uses [Nova](https://nova.laravel.com) via composer:

```
composer require bissolli/nova-phone-field
```

Usage
-----

[](#usage)

Go straight to your Nova resource and use `Bissolli\NovaPhoneField\PhoneNumber` field:

```
namespace App\Nova;

use Bissolli\NovaPhoneField\PhoneNumber;

class Member extends Resource
{
    // ...

    public function fields(Request $request)
    {
        return [
            // ...

            PhoneNumber::make('Phone Number'),

            // ...
        ];
    }
}
```

Now you can view and add tags on the blog posts screen in your Nova app. All tags will be saved in the `tags` table.

### Filtering

[](#filtering)

By default, every country mask available inside `bissolli/nova-phone-field/resources/js/data/phone-masks.json` will be loaded and working. However, you can always select the desired countries calling the `onlyCountries()` method.

```
PhoneNumber::make('Phone Number')
    ->onlyCountries('BR', 'US', 'IE'),
```

### Custom number format

[](#custom-number-format)

You can also add custom phone formats with `withCustomFormats()`.

```
PhoneNumber::make('Phone Number')
    ->withCustomFormats('+123 ## #.#', '+123 ## ####.####'),
```

Or else use only your own phone formats calling for `withCustomFormats()` among with `onlyCustomFormats()`.

```
PhoneNumber::make('Phone Number')
    ->withCustomFormats('+123 ## #.#', '+123 ## ####.####')
    ->onlyCustomFormats(),
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security-related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Gustavo Bissolli](https://github.com/bissolli)

Special thanks to [Robin Herbots](https://github.com/RobinHerbots) who built one of the best [InputMask](https://github.com/RobinHerbots/Inputmask) from the internet.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

Support on Beerpay
------------------

[](#support-on-beerpay)

Hey dude! Help me out for a couple of 🍻!

[![Beerpay](https://camo.githubusercontent.com/9aab2bf96744ac1f8b8449ddb78906c8ba71efcd8c40c2a9d4e75d026bfc8b44/68747470733a2f2f626565727061792e696f2f626973736f6c6c692f6e6f76612d70686f6e652d6669656c642f62616467652e7376673f7374796c653d626565722d737175617265)](https://beerpay.io/bissolli/nova-phone-field) [![Beerpay](https://camo.githubusercontent.com/e2f499f07e4e69171c24b05d8bb81ad499d9a3ccc821b0ee231fe39781ca66e3/68747470733a2f2f626565727061792e696f2f626973736f6c6c692f6e6f76612d70686f6e652d6669656c642f6d616b652d776973682e7376673f7374796c653d666c61742d737175617265)](https://beerpay.io/bissolli/nova-phone-field?focus=wish)

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity46

Moderate usage in the ecosystem

Community16

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 73.9% 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 ~99 days

Total

4

Last Release

2491d ago

### Community

Maintainers

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

---

Top Contributors

[![bissolli](https://avatars.githubusercontent.com/u/1808444?v=4)](https://github.com/bissolli "bissolli (17 commits)")[![nibri10](https://avatars.githubusercontent.com/u/22533877?v=4)](https://github.com/nibri10 "nibri10 (5 commits)")[![drsdre](https://avatars.githubusercontent.com/u/809827?v=4)](https://github.com/drsdre "drsdre (1 commits)")

---

Tags

laravelnovainput maskphone mask

### Embed Badge

![Health badge](/badges/bissolli-nova-phone-field/health.svg)

```
[![Health](https://phpackages.com/badges/bissolli-nova-phone-field/health.svg)](https://phpackages.com/packages/bissolli-nova-phone-field)
```

###  Alternatives

[optimistdigital/nova-multiselect-field

A multiple select field for Laravel Nova.

3453.7M8](/packages/optimistdigital-nova-multiselect-field)[inspheric/nova-defaultable

Default values for Nova fields when creating resources and running resource actions.

52178.7k1](/packages/inspheric-nova-defaultable)[murdercode/nova4-tinymce-editor

Boost your Laravel Nova with the TinyMCE editor.

17186.3k1](/packages/murdercode-nova4-tinymce-editor)[datomatic/nova-detached-actions

A Laravel Nova tool to allow for placing actions in the Nova toolbar detached from the checkbox selection mechanism.

11273.0k](/packages/datomatic-nova-detached-actions)

PHPackages © 2026

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