3.0.0

Release Notes - Laravel Running Number v3.0.0

Release Date: November 13, 2025

Version 3.0.0 is a major release featuring significant enhancements, comprehensive documentation, and breaking changes. This release modernizes the package with native PHP 8.1+ features and introduces powerful new capabilities.

---

🚀 Major Enhancements

Traitify Integration

• Native PHP 8.1+ enums support (migrated from spatie/laravel-enum) - Enums Configuration
• UUID support for all running number records via InteractsWithUuid trait
• Enhanced enum capabilities: values(), labels(), options(), descriptions() methods

Running Number Management

• Reset/restart functionality with custom starting points - Artisan Commands
• Date-based formatting for time-organized numbers (e.g., INV-2024-01-001) - Date-Based Formats
• Multiple sequences per type with scope support (branch-specific, department-specific) - Multiple Sequences
• Custom starting numbers per type - Custom Starting Numbers
• Number range management with overflow detection - Range Management

Generation Features

• Preview mode to check next number without persisting - Preview & Batch
• Bulk generation for multiple numbers in single operation - Preview & Batch
• Improved concurrency handling for high-volume generation
• Optional audit trail with generation history tracking

Developer Experience

• HasRunningNumber Eloquent trait for seamless model integration - Model Integration
• Artisan commands: list, reset, restart, preview, and statistics - Artisan Commands
• Events system: RunningNumberGenerated and RunningNumberReset - Events
• REST API endpoints for remote generation - REST API
• Enhanced service container integration
• Helper functions, facades, and improved type hints

Documentation Overhaul

• 20+ dedicated documentation files organized in 7 major sections - Documentation
• Progressive learning path from basics to advanced topics - Getting Started
• Real-world examples and common scenarios - Common Scenarios
• Advanced integration patterns - Integration Patterns
• Custom presenters and generators guides - Custom Presenters | Custom Generators
• Developer contribution guidelines - Contributing

---

⚠️ Breaking Changes

• Enum Migration: Updated from Spatie enums to native PHP 8.1+ enums with Traitify
• Database Schema: Added required uuid column to running_numbers table
• Configuration: Extended with new options for reset periods, date formats, starting numbers, and audit trail
• Minimum Requirements: PHP 8.1+ now required

Migration Guide: See Upgrade Guide for complete v3.0.0 upgrade instructions

---

📦 Dependencies

• Added cleaniquecoders/traitify ^1.2.1
• PHP 8.1 | 8.2 | 8.3 | 8.4
• Laravel 9.x | 10.x | 11.x | 12.x

---

📚 Documentation

Complete documentation available at here

---

Full Changelog: 2.3.0...3.0.0

Added Laravel 12 and PHP 8.4 Support

What's Changed

• Bump aglipanci/laravel-pint-action from 2.3.1 to 2.4 by @dependabot in #26
• Bump dependabot/fetch-metadata from 1.6.0 to 2.1.0 by @dependabot in #27
• Bump ramsey/composer-install from 2 to 3 by @dependabot in #24
• Bump actions/checkout from 3 to 4 by @dependabot in #21
• Bump dependabot/fetch-metadata from 2.1.0 to 2.2.0 by @dependabot in #28
• Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in #29
• Bump aglipanci/laravel-pint-action from 2.4 to 2.5 by @dependabot in #30

Full Changelog: 2.2.0...2.3.0

Added Laravel 11 Support

What's Changed

• Bump aglipanci/laravel-pint-action from 2.1.0 to 2.2.0 by @dependabot in #16
• Bump dependabot/fetch-metadata from 1.3.6 to 1.4.0 by @dependabot in #17
• Bump dependabot/fetch-metadata from 1.4.0 to 1.5.1 by @dependabot in #18
• Bump dependabot/fetch-metadata from 1.5.1 to 1.6.0 by @dependabot in #20
• Bump stefanzweifel/git-auto-commit-action from 4 to 5 by @dependabot in #22
• Bump aglipanci/laravel-pint-action from 2.2.0 to 2.3.1 by @dependabot in #23

Full Changelog: 2.1.0...2.2.0

Added Laravel 10 Support

2.1.0

Merge

Added Laravel 9 Support

2.0.0

Fix github action

Fixed migration class name

Full Changelog: 1.0.3...1.0.4

Update README

Full Changelog: 1.0.2...1.0.3

Update

Full Changelog: 1.0.1...1.0.2

Update README

1.0.1

Update README

First Release

1.0.0

Merge branch 'main' of https://github.com/nasrulhazim/laravel-running…