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

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 fields you need instead of retrieving every field.
Available modifiers:

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

Sort
Order results in ascending or descending order.

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

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 - rodrigogalura3rd@gmail.com

☕️ 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)