PHPackages                             justbetter/statamic-postcodenl - 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 & Helpers](/categories/utility)
4. /
5. justbetter/statamic-postcodenl

ActivePackage[Utility & Helpers](/categories/utility)

justbetter/statamic-postcodenl
==============================

Package for adding Postcode.nl form fields

4.0.3(1mo ago)0520PHPPHP ^8.4

Since Jun 16Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/justbetter/statamic-postcodenl)[ Packagist](https://packagist.org/packages/justbetter/statamic-postcodenl)[ RSS](/packages/justbetter-statamic-postcodenl/feed)WikiDiscussions master Synced today

READMEChangelog (10)Dependencies (6)Versions (16)Used By (0)

[ ![Banner](./art/banner.png)](https://github.com/justbetter/statamic-postcodenl "JustBetter")Statamic Postcode.nl
====================

[](#statamic-postcodenl)

> This addon adds Postcode.nl field types to the Form Builder.

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

[](#installation)

```
composer require justbetter/statamic-postcodenl
```

Configuration
-------------

[](#configuration)

Add the following items to your .env, these settings consist of the Key and Secret provided by Postcode.nl.

```
POSTCODENL_KEY=""
POSTCODENL_SECRET=""
```

How to Use
----------

[](#how-to-use)

### Form settings

[](#form-settings)

When building a form it's now possible to make use of the Postcode.nl fields. When selecting the Postcode.nl field you need to select the according field type, these consist of:

- Zipcode (Required)
- House number (Required)
- House number addition (Optional)
- Street (Required)
- City (Required)

Make sure to add all the required field types to your form as they are needed for this to work.

### Usage

[](#usage)

First of all import the javascript in your projects javascript file:

```
import './../../vendor/justbetter/statamic-postcodenl/resources/js/postcodenl.js'
```

After that, you can use the alpinejs x-data on a wrapper of the fields:

```

```

The parameters are the id's of the postcodeNL fields. This can be left empty if the examples above are used as ID.

As the Postcode.nl field types are an extend of the normal text field type, you can use this type the same way as the text field type for your forms. For example you could still look at the `input_type` field to determine the field type you need to load into your form.

Make sure you're using the correct variable when passing the formId, this variable should be the handle of your form. i.e 'contact'.

###  Health Score

51

—

FairBetter than 95% of packages

Maintenance94

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 92.3% 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 ~98 days

Recently: every ~154 days

Total

12

Last Release

30d ago

Major Versions

1.0.3 → 2.0.02023-06-27

2.0.1 → 3.0.02024-06-25

3.0.1 → 4.0.02026-04-07

PHP version history (2 changes)1.0.0PHP ^8.0|^8.1

4.0.0PHP ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/2d00b3f55cd4ae8b8cfb001a644ed6c7a1127a956c24375bcfe16ce12bd89bed?d=identicon)[justbetter](/maintainers/justbetter)

---

Top Contributors

[![kevinmeijer97](https://avatars.githubusercontent.com/u/9716909?v=4)](https://github.com/kevinmeijer97 "kevinmeijer97 (36 commits)")[![BobWez98](https://avatars.githubusercontent.com/u/23509926?v=4)](https://github.com/BobWez98 "BobWez98 (3 commits)")

### Embed Badge

![Health badge](/badges/justbetter-statamic-postcodenl/health.svg)

```
[![Health](https://phpackages.com/badges/justbetter-statamic-postcodenl/health.svg)](https://phpackages.com/packages/justbetter-statamic-postcodenl)
```

###  Alternatives

[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135224.7k7](/packages/statamic-rad-pack-runway)[duncanmcclean/statamic-cargo

Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity.

3416.9k](/packages/duncanmcclean-statamic-cargo)[statamic/seo-pro

68516.6k](/packages/statamic-seo-pro)[marcorieser/statamic-livewire

A Laravel Livewire integration for Statamic.

23111.5k14](/packages/marcorieser-statamic-livewire)[aerni/livewire-forms

A Statamic forms framework powered by Laravel Livewire

2915.1k](/packages/aerni-livewire-forms)[aerni/advanced-seo

Comprehensive SEO addon for Statamic with flexibility in mind

1818.2k](/packages/aerni-advanced-seo)

PHPackages © 2026

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