Laravel TypeBridge

Deterministic TypeScript generation from Laravel resources.

Why this package

This package helps you keep backend resources and frontend types aligned, with deterministic output and predictable imports.

Requirements

• PHP >=8.2
• Laravel 12.x or 13.x
• Note: Laravel 13.x requires PHP >= 8.3 (Laravel framework requirement)

Installation

Publish the config:

Generated file:

• config/typebridge.php

Basic usage

Generate files:

Use another output directory:

Preview only (no write):

Generate and remove stale .ts files:

Generate only selected resources:

Generate everything except selected resources:

Check generated files in CI:

Attribute example

Use TypeBridgeResource on Laravel resources (JsonResource or ResourceCollection):

Optional attribute fields:

• types: local TypeScript aliases/enums declared in the same generated file
• fileName: per-resource output filename override
• append: per-resource lines appended at the end of the generated file
• aliasBase and aliasPlural: alias placeholders used by generation.append_templates

@relation(name) is strict:

• the resource model must be resolvable
• the relation method must exist
• the relation method must return an Eloquent relation

If the relation exists but no generated TypeScript type is available for the related model, the field falls back to any or any[].

@enum(Fully\\Qualified\\EnumClass) generates a TypeScript literal union from PHP enum cases.

Configuration

Published default config

This is the default config generated by vendor:publish:

Advanced config example (API wrappers + aliases)

This is an example, not the default:

Additional outputs

output.additional_paths are generated on every typebridge:generate call when --output-path is not used.

If you use --output-path, additional paths are skipped unless you pass --with-additional-paths.

With RoleItem, this can generate:

Naming placeholders

For files.naming_pattern:

• {name}
• {pascal}
• {camel}
• {snake}
• {kebab}

Example:

Template placeholders

Inside append_templates.*.lines:

• {name}: resource name
• {base}: alias base (aliasBase or suffix stripping)
• {basePlural}: alias plural (aliasPlural or pluralized base)
• {pascal}
• {camel}
• {snake}
• {kebab}

Override rules

• fileName on the attribute overrides files.naming_pattern for one resource
• --output-path overrides output.base_path

Roadmap

• [x] Add typebridge:check for CI (no write, non-zero exit code when generated files are out of date)
• [x] Add --only and --except to generate a subset of resources
• [x] Add --clean to remove stale generated files
• [x] Improve @relation(...) diagnostics with more actionable error messages
• [x] Add enum helpers (for example @enum(...) support)
• [ ] Add configurable scalar mapping presets (datetime, uuid, decimal, etc.)
• [ ] Add configurable import/path strategy options
• [ ] Add a first-class paginator wrapper preset
• [ ] Add pre/post render hooks for advanced customization
• [ ] Add incremental generation mode for large codebases
• [ ] Add stubs/scaffolding helpers for #[TypeBridgeResource]
• [ ] Add optional targets beyond interfaces (for example Zod schema generation)

Other packages

If you want to explore more of my Laravel packages:

• evanschleret/lara-mjml
• evanschleret/laravel-user-presence
• evanschleret/formforge

Open source

• Contributing guide: CONTRIBUTING.md
• Security policy: SECURITY.md
• Code of conduct: CODE_OF_CONDUCT.md
• License: LICENSE