PHPackages                             fanmade/laravel-nanoid - 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. fanmade/laravel-nanoid

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

fanmade/laravel-nanoid
======================

A small package to add Nano IDs to Laravel

1.1.0(1y ago)09.9k↓24.5%1MITPHPPHP ^8.1CI failing

Since May 14Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Fanmade/laravel-nanoid)[ Packagist](https://packagist.org/packages/fanmade/laravel-nanoid)[ RSS](/packages/fanmade-laravel-nanoid/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (7)Versions (3)Used By (0)

Laravel Nano ID
===============

[](#laravel-nano-id)

[![Laravel Nano ID Logo](/art/laravel-nano-id-logo.png)](/art/laravel-nano-id-logo.png)

Introduction
------------

[](#introduction)

A simple package to generate Nano IDs in Laravel.

What is a Nano ID?
==================

[](#what-is-a-nano-id)

A Nano ID is a URL-friendly, unique string ID.
It is similar to UUIDs, but shorter and more readable.
Nano IDs are 21 characters long by default and can be customized to be longer or shorter.

- Read more on Medium: [Nano ID: A Tiny, Secure URL-friendly Unique String ID Generator](https://medium.com/@gaspm/nano-id-popular-secure-and-url-friendly-unique-identifiers-1fa86c9fdf7c)
- Or on GitHub: [Nano ID](https://github.com/ai/nanoid)

Table of Contents
=================

[](#table-of-contents)

- [Features](#features)
- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [Configuration](#configuration)
- [Testing](#testing)
- [Alternatives (and inspirations)](#alternatives-and-inspirations)

Features
--------

[](#features)

- A facade to generate Nano IDs
- A helper function to use as alternative to the facade
- Configuration options to customize the defaults for your Nano IDs
    - Prefix
    - Suffix
    - Alphabet
    - Size
    - Random string generator
    - More to come
- Easily extensible with custom validation rules (like uniqueness or swear word checks)

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

[](#requirements)

- PHP &gt;= 8.0

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

[](#installation)

```
composer require fanmade/laravel-nanoid
```

Usage
-----

[](#usage)

```
use Fanmade\NanoId\Facades\NanoID;

echo NanoID::generate(); // Returns a Nano ID

echo NanoID::generate(length: 10); // Returns a Nano ID with a length of 10

echo NanoID::generate(length: 10, prefix: 'prefix_'); // Returns a Nano ID with a length of 10 and a prefix of 'prefix_'

echo NanoID::generate(suffix: '_suffix'); // Returns a Nano ID with a suffix of '_suffix'

echo NanoID::generate(alphabet: '0123456789'); // Returns a Nano ID only containing numbers

echo nano_id(); // The helper function accepts the same parameters as the generate method
```

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

[](#configuration)

Publish the configuration file

```
php artisan vendor:publish --tag=nanoid-config
```

OptionDescriptionDefault`prefix`An optional prefix which will be added to the Nano ID`''``suffix`An optional suffix which will be added to the Nano ID`''``alphabet`The alphabet to use for generating the Nano ID`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ_`+
`abcdefghijklmnopqrstuvwxyz-``size`The default size/length of the Nano ID`21``generator`The generator class to use for generating random strings`\Fanmade\NanoId\Generator\HidehaloStringGenerator``include_prefix_in_length`Controls if the prefix is included or excluded in the size limitationtrue`include_suffix_in_length`Controls if the suffix is included or excluded in the size limitationtrueTesting
-------

[](#testing)

```
vendor/bin/pest
```

or

```
composer test
```

Alternatives (and inspirations)
-------------------------------

[](#alternatives-and-inspirations)

- [hidehalo/nanoid-php](https://github.com/hidehalo/nanoid-php) - The original Nano ID package for PHP. This is also used in the background of this package.
- [yondifon/laravel-nanoid](https://github.com/yondifon/laravel-nanoid) - More focused on adding the Nano IDs to the models.
- [ttbooking/laravel-nanoid](https://github.com/ttbooking/laravel-nanoid) - This one has more focus on extending the string helpers.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance45

Moderate activity, may be stable

Popularity26

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 96% 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 ~307 days

Total

2

Last Release

427d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/03ee7b67b9a5fc7e28528dcd9756394b83f8923c6592fde5aaa43189d0022f7b?d=identicon)[Fanmade](/maintainers/Fanmade)

---

Top Contributors

[![Fanmade](https://avatars.githubusercontent.com/u/2896491?v=4)](https://github.com/Fanmade "Fanmade (24 commits)")[![erossdev](https://avatars.githubusercontent.com/u/78756041?v=4)](https://github.com/erossdev "erossdev (1 commits)")

---

Tags

laravelnanoidlaravel-nanoidnano-id

###  Code Quality

TestsPest

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/fanmade-laravel-nanoid/health.svg)

```
[![Health](https://phpackages.com/badges/fanmade-laravel-nanoid/health.svg)](https://phpackages.com/packages/fanmade-laravel-nanoid)
```

###  Alternatives

[livewire/volt

An elegantly crafted functional API for Laravel Livewire.

4195.3M84](/packages/livewire-volt)[gehrisandro/tailwind-merge-laravel

TailwindMerge for Laravel merges multiple Tailwind CSS classes by automatically resolving conflicts between them

341682.2k18](/packages/gehrisandro-tailwind-merge-laravel)[nickurt/laravel-akismet

Akismet for Laravel 11.x/12.x/13.x

97139.6k2](/packages/nickurt-laravel-akismet)[whitecube/laravel-timezones

Store UTC dates in the database and work with custom timezones in the application.

106106.2k](/packages/whitecube-laravel-timezones)[riipandi/laravel-optikey

Use UUID, Ulid, or nanoid as optional or primary key in Laravel.

429.1k](/packages/riipandi-laravel-optikey)[forxer/laravel-gravatar

A library providing easy gravatar integration in a Laravel project.

4235.6k](/packages/forxer-laravel-gravatar)

PHPackages © 2026

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