✨ Release Overview
This release introduces AppPaths to Maatify SharedCommon, providing a
centralized and reusable utility for resolving common application directories.
The goal of this addition is to reduce duplicated path-building logic across
projects, improve consistency, and provide a clearer foundation for filesystem
and configuration access in a framework-agnostic way.
✅ What’s New
-
Application Paths Utility
- Added
AppPathsunder theMaatify\SharedCommon\Pathnamespace - Centralizes access to commonly used project directories
- Added
-
Built-in Path Helpers
root()publicPath()publicImages()storage()config()logs()
-
Nested Storage Resolver
- Added
storagePath(string $subfolder)for consistent generation of
subpaths inside the storage directory
- Added
🏗 Why This Matters
Applications often repeat filesystem path construction in multiple places,
which can lead to inconsistency and harder maintenance.
By introducing AppPaths, this release provides:
- a single source of truth for common directory resolution
- improved readability when accessing project paths
- easier reuse across modules and applications
- safer and clearer path handling in shared infrastructure code
📦 Installation
composer require maatify/shared-common🔧 Requirements
- PHP 8.2+
📚 Documentation
This release is documented in:
CHANGELOG.md
The new utility can be used directly in application and infrastructure layers
where centralized path resolution is needed.
🔒 Security
If you discover a security issue, please review the project's
Security Policy.
📜 License
MIT License.