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(2mo ago)0523PHPPHP ^8.4

Since Jun 16Pushed 2mo 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 1w ago

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

48

—

FairBetter than 94% of packages

Maintenance85

Actively maintained with recent releases

Popularity14

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

75d 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.

137236.2k8](/packages/statamic-rad-pack-runway)[duncanmcclean/statamic-cargo

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

3622.8k](/packages/duncanmcclean-statamic-cargo)[statamic/statamic

Statamic

832182.1k](/packages/statamic-statamic)[statamic/seo-pro

71548.3k](/packages/statamic-seo-pro)[aerni/advanced-seo

Comprehensive SEO addon for Statamic with flexibility in mind

1818.9k](/packages/aerni-advanced-seo)[crumbls/layup

A visual page builder plugin for Filament 5 — Divi-style grid layouts with extensible widgets.

604.0k2](/packages/crumbls-layup)

PHPackages © 2026

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