horlerdipo/pretend

A simple package to impersonate users when building APIs with Laravel Sanctum, allowing administrators to generate temporary tokens and act on behalf of other users without using sessions.

v0.1.0 2025-08-23 08:51 UTC

Requires

• php: ^8.1
• illuminate/contracts: ^10.0||^11.0||^12.0
• laravel/sanctum: ^3.3 || ^4.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^2.9.4 || ^3.0
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.1.1||^7.10.0
• orchestra/testbench: ^10.0.0||^9.0.0||^8.22.0
• pestphp/pest: ^2.0||^3.0
• pestphp/pest-plugin-arch: ^2.5||^3.0
• pestphp/pest-plugin-laravel: ^2.0||^3.0
• phpstan/extension-installer: ^1.3
• phpstan/phpstan-deprecation-rules: ^1.1||^2.0
• phpstan/phpstan-phpunit: ^1.3||^2.0

MIT

• Umar Oladipo

• laravel
• Umar Oladipo
• pretend

README

Pretend is a Laravel package for user impersonation, built on top of Laravel Sanctum, designed to help admins step into the shoes of their users. With Pretend, you can securely impersonate a user, browse your app exactly as they see it, and debug issues or provide support without needing their credentials.

Why Pretend?

🔑 Sanctum-powered – integrates seamlessly with Laravel Sanctum’s personal access tokens.

🎭 True impersonation – experience the application from the user’s perspective.

🛡️ Secure by design – tokens, events, and middleware to keep impersonation safe and auditable.

⚡ Flexible storage – swap out the default database storage for your own implementation.

Requirements

• PHP 8.3+
• Laravel 11.x or higher

Docs

Find the complete documentation here

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Umar Oladipo
• All Contributors

License

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