apsonex/laravel-font

This is my package laravelfont

v1.0.3 2025-05-26 17:50 UTC

This package is auto-updated.

Last update: 2025-05-26 17:50:55 UTC


README

Latest Version License

apsonex/laravelfont is a Laravel wrapper around the core apsonex/font package, allowing you to easily manage fonts from supported providers like Bunny Fonts.

โœจ Features

  • List, search, and retrieve fonts by key, family, or type.
  • Support for Bunny Fonts.
  • Laravel auto-discovery with service provider and facade.
  • Clean, chainable API.
  • Ready for testing using Pest PHP.

๐Ÿš€ Installation

composer require apsonex/laravelfont

๐Ÿ“† Usage

Resolving the Font Manager

use Apsonex\LaravelFont\Facades\LaravelFont;

$manager = LaravelFont::bunny();

Or via service container:

$manager = app(\Apsonex\LaravelFont\LaravelFontManager::class)->bunny();

๐Ÿ“š API Methods

Set Provider

$manager->bunny();

List Fonts

$manager->list(limit: 20, page: 1);

Search Fonts

$manager->search(keyword: 'abo', limit: 20, page: 1);

Find by Key

$manager->findByKey('abel');

Find by Keys

$manager->findByKeys(['abel', 'aboreto'], limit: 10);

Find by Family

$manager->findByFamily('Abel', limit: 10);

Find by Families

$manager->findByFamilies(['Abel', 'Aboreto'], limit: 10);

Find by Type

$manager->findByType('sans-serif', limit: -1); // -1 to get all

๐Ÿ“„ FontDTO

Each font is returned as a FontDTO with the following structure:

FontDTO {
    string $key         // "abel"
    string $provider    // "bunny"
    string $category    // "sans-serif"
    string $family      // "Abel"
    string $urlString   // "abel:400,400i"
}

๐Ÿงช Testing

Run the test suite using:

vendor/bin/pest

๐Ÿ›  Development

If you're working on this package, install dependencies and test it via:

composer install
composer test

๐Ÿ“œ License

The MIT License (MIT). Please see License File for more information.