romegasoftware/laravel-schema-generator

Generate TypeScript Zod validation schemas from Laravel validation rules

v0.1.0 2025-09-16 20:15 UTC

Requires

• php: ^8.1
• illuminate/console: ^9.0|^10.0|^11.0|^12.0
• illuminate/support: ^9.0|^10.0|^11.0|^12.0

Requires (Dev)

• larastan/larastan: ^3.6
• laravel/pint: ^1.18
• orchestra/testbench: ^7.0|^8.0|^9.0
• phpunit/phpunit: ^9.5|^10.0|^11.0
• spatie/laravel-data: ^3.0|^4.0

Suggests

• spatie/laravel-data: Required for Data class schema generation (^3.0|^4.0)
• spatie/laravel-typescript-transformer: Required for TypeScript type generation and for automatic hook integration with typescript:transform command (^2.0)

MIT

• Braden Keith

• generator
• schema
• validation
• laravel
• typescript
• zod

README

Generate TypeScript Schema validation schemas from your Laravel validation rules. This package supports Laravel FormRequest classes, Spatie Data classes, and custom validation classes through an extensible architecture.

It will generate Zod schema out of the box, but can be extended for different schema generators.

Features

• 🚀 Zero Dependencies - Works with vanilla Laravel
• 📦 Smart Package Detection - Automatically detects and uses installed packages
• 🎯 Multiple Validation Sources - FormRequests, Spatie Data classes, custom extractors
• 🔧 Flexible Configuration - Customize output paths, formats, and integration settings
• 🧩 Highly Extensible - Custom extractors and type handlers with priority system

Installation

composer require romegasoftware/laravel-schema-generator

Optional Packages

For additional features, install these optional packages:

# For Spatie Data class support
composer require spatie/laravel-data

# For TypeScript transformer integration
composer require spatie/laravel-typescript-transformer

Configuration

To publish the configuration file, run:

php artisan vendor:publish --provider="RomegaSoftware\LaravelSchemaGenerator\LaravelSchemaGeneratorServiceProvider"

This will create a config/laravel-schema-generator.php file where you can customize output paths, formats, and integration settings.

Quick Start

1. Add the attribute to your Laravel validation classes:

use RomegaSoftware\LaravelSchemaGenerator\Attributes\ValidationSchema;

#[ValidationSchema]
class CreateUserRequest extends FormRequest
{
    public function rules(): array
    {
        return [
            'name' => 'required|string|max:255',
            'email' => 'required|email',
            'age' => 'nullable|integer|min:18',
        ];
    }
}

1. Generate the schemas:

php artisan schema:generate

1. Use in TypeScript:

import { CreateUserRequestSchema } from "@/types/schemas";

const result = CreateUserRequestSchema.safeParse(formData);
if (result.success) {
  // Data is valid
  await api.createUser(result.data);
}

Documentation

For complete documentation, configuration options, advanced features, and examples, visit:

📚 Official Documentation Coming Soon

Contributing

Please see CONTRIBUTING for development setup and contribution guidelines.

License

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

Credits

• Romega Software
• All Contributors