Skip to content

v1.0.1 — Add AppPaths Utility for Common Directory Resolution

Latest

Choose a tag to compare

@Maatify Maatify released this 11 Apr 20:01

✨ 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 AppPaths under the Maatify\SharedCommon\Path namespace
    • Centralizes access to commonly used project directories
  • 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

🏗 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.