README

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.