rodrigogalura/tuner

A Laravel package to fine-tune your APIs — let clients shape the data with powerful query modifiers.

v1.1.3 2025-10-22 05:35 UTC

Requires

• php: 8.3.*

Requires (Dev)

• laravel/pint: ^1.21
• mockery/mockery: ^1.6
• orchestra/testbench: ^10.1
• pestphp/pest: ^3.7
• pestphp/pest-plugin-laravel: ^3.1
• rector/rector: dev-main

MIT

• Rodrigo Galura

README

A Laravel package to fine-tune your APIs — let clients shape the data with powerful query modifiers.
Explore the docs »

Report Bug · Request Feature

Table of Contents

1. About The Project
2. Main Features
3. Roadmap
4. Contributing
5. License
6. Contact
7. Buy Me a Coffee

About The Project

This package was born out of real-world needs in my own projects. I created it to cut down on boilerplate and give frontend consumers more control and flexibility. I’m simply sharing the tools that helped me build faster — and I hope they’ll do the same for you.

Main Features

Projection
Select only the columns you need instead of retrieving every column.
Available modifiers:

1. columns – Include only the specified columns.
2. columns! – Exclude the specified columns (opposite effect).

Sort
Order results in ascending or descending order.

• Use the sort modifier to define one or more sort columns.

Search
Filter results based on a search keyword with optional wildcards.

• Use the search modifier.

Available wildcards:

1. *term – Match at the beginning.
2. term* – Match at the end.
3. *term* – Match anywhere (flexible).

Filter
Go beyond simple search with advanced filtering.
Available modifiers:

1. filter
2. in
3. between

filter
Supports relational and arithmetic operators:

• = : Equal
• > : Greater than
• < : Less than
• >= : Greater than or equal
• <= : Less than or equal
• <> : Not equal

in
Filter results that match any value in a given list.

between
Filter results within a range of values (numbers, text, or dates).

Logical operators are supported for advanced filtering:

• AND
• OR
• AND!
• OR!

Limitation
Restrict the number of results returned by specifying a maximum limit.

Pagination
Leverage Laravel’s built-in pagination system for efficient, page-based responses.

(back to top)

Roadmap

You can access the Tuner roadmap here.

License

The Tuner is open-sourced software licensed under the MIT license.

Contact

If you discover any security vulnerabilities, please contact me. This allows me to address the issue promptly and responsibly.

Rodrigo Galura - [e-mail]

☕️ Buy Me a Coffee

If this project helped you or saved you time, consider buying me a coffee. Your support means a lot and helps keep this project active and maintained!

(back to top)