gruya/laravel-mobile-api-starter-kit

Minimal type safe starter kit for mobile-first apps with OTP and action pattern.

v1.0.2 2026-04-27 21:42 UTC

Requires

• php: ^8.5.0
• laravel/framework: ^13.0
• laravel/sanctum: ^4.0
• laravel/tinker: ^3.0
• nunomaduro/essentials: ^1.2

Requires (Dev)

• driftingly/rector-laravel: ^2.3
• fakerphp/faker: ^1.23
• larastan/larastan: ^3.0
• laravel/boost: ^2.2
• laravel/pail: ^1.2.5
• laravel/pint: ^1.27
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• nunomaduro/pao: ^1.0
• pestphp/pest: ^4.5
• pestphp/pest-plugin-laravel: ^4.1
• phpstan/phpstan: ^2.1
• rector/rector: ^2.4

MIT

• api
• mobile
• laravel
• otp
• starter-kit
• sanctum

README

Minimal type safe starter kit for mobile-first apps with OTP and action pattern.

Why use it?

• OTP over magic link for better mobile UX
• Versioned API routes
• Action pattern
• Cruddy controllers
• Type safe with PHPStan level max
• Consistency and refactoring with Rector and Pint
• AI ready with Laravel Boost
• Better defaults, thanks to Essentials
• Feature, unit and architecture tests

Getting Started

You need:

• PHP 8.5+
• Composer
• A database driver supported by Laravel

Create the app:

composer create-project gruya/laravel-mobile-api-starter-kit --prefer-dist example-app

Move in and set it up:

cd example-app
composer setup

Start local dev:

composer dev

Check the project:

composer test

That runs Rector check, Pint check, PHPStan, and the Laravel test suite.

Available Tooling

Development

• composer dev - Runs the Laravel server, queue listener, and Pail logs

Code Quality

• composer refactor - Runs Rector and changes code
• composer test:refactor - Runs Rector without changing files
• composer lint - Runs Pint and fixes PHP style
• composer test:lint - Runs Pint without changing files

Testing

• composer test:types - Runs PHPStan/Larastan
• composer test:unit - Clears Laravel config and runs tests
• composer test - Runs all checks above

Similar recommended kits

All this kits have PHPStan level max with pint and rector

• Laravel API Kit: Spatie oriented with different pattern
• Laravel Inertia & React: Web only with similar patter
• Laravel Inertia & Vue: Web only with similar patter
• Laravel Blade: Web only with similar patter

License

This Starter Kit was created by Gruya under the MIT license.