jay123anta

jay123anta / laravel-api-versionist

Public

Intelligent API version manager for Laravel — one codebase, infinite API versions via bidirectional transformers.

packagist.orgpackagesjayantalaravel-api-versionist api composer laravel middleware php
11
3
100% credibility
Found Mar 12, 2026 at 11 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
PHP
AI Summary

A tool for web services built with Laravel that automatically adapts incoming requests from old versions to the latest and outgoing responses back to the client's version using simple transformation rules.

How It Works

1
📱 Your apps need updates

You run a web service that apps rely on, but when you improve it, old apps break and users complain.

2
🔍 Find the versioning helper

You discover a simple tool that lets your service speak old and new languages automatically, inspired by big companies like Stripe.

3
🛠️ Add it to your service

With one easy step, you bring the helper into your web service setup.

4
✏️ Describe the changes

You write short notes explaining exactly what data shifted between old and new versions, like renaming a field or changing a list.

5
🛤️ Turn it on for your pages

You tell your service to use this magic on the pages where apps connect.

6
🧪 Test old and new apps

You try requests from outdated apps and shiny new ones – both get exactly what they expect, seamlessly.

🎉 Updates without heartbreak

Now you evolve your service freely, old apps keep working perfectly, and everyone stays happy.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 11 to 11 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is laravel-api-versionist?

Laravel-api-versionist is an intelligent API version manager for Laravel apps, handling multiple API versions from one codebase using bidirectional transformers. It detects client versions via URL prefixes, headers, query params, or Accept headers, upgrades incoming requests to your latest format, and downgrades responses back—keeping controllers blissfully unaware. PHP-based, it supports Laravel 10-12 and works with flat JSON or enveloped responses like {"data": {...}}.

Why is it gaining traction?

Unlike duplicating controllers or littering if/else checks, it chains small transformers for field renames, type shifts, or restructures, inspired by Stripe's approach—pure structural magic without behavioral hacks. Artisan commands like `api:make-transformer v2`, `api:versions`, `api:changelog`, and `api:audit` make versioning feel effortless, plus deprecation headers and request macros like `$request->isApiVersionAtLeast('v3')` add polish. Bidirectional pipelines ensure round-trip fidelity for intelligent APIs.

Who should use this?

Backend devs on Laravel teams maintaining public APIs for mobile apps, third-party integrations, or legacy clients stuck on v1. Ideal if you're evolving payloads (e.g., username to handle, role to roles[]) without breaking old consumers, but skip for heavy behavioral changes like new auth logic.

Verdict

Promising for structural API evolution, with solid docs, tests, and CLI tools, but at 10 stars and 1.0% credibility, it's early—test thoroughly in non-prod first. Grab it if multi-version pain hits now; otherwise, watch for adoption.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.