Liform Laravel Package

Product Decisions This Supports

• Accelerate API/Backend Development: Reduces manual effort in defining API request/response schemas by auto-generating JSON Schema from Symfony Forms, enabling faster iteration on data contracts.
• Consistency Across Frontend/Backend: Ensures alignment between form definitions (Symfony) and API schemas (JSON Schema), reducing miscommunication between frontend and backend teams.
• Developer Experience (DX) Improvements: Simplifies onboarding for junior developers by abstracting schema generation logic, allowing them to focus on business logic.
• Roadmap for API-First Development: Supports a shift toward API-first design by providing a bridge between Symfony Forms (common in PHP apps) and JSON Schema (standard for APIs).
• Build vs. Buy Decision: Avoids reinventing schema generation wheels, leveraging an existing (though niche) solution to reduce technical debt.
• Use Cases:
  • Internal admin panels with form-heavy workflows.
  • Public APIs where request/response validation is critical.
  • Microservices where Symfony Forms are already used but JSON Schema is needed for documentation or client libraries.

When to Consider This Package

• Adopt if:
  • Your stack already uses Symfony Forms and you need JSON Schema for APIs, documentation, or client-side validation.
  • You prioritize developer velocity over customization (the package is lightweight but not highly configurable).
  • Your team lacks bandwidth to maintain a custom schema generation solution.
  • You’re building form-driven APIs (e.g., CRUD endpoints) where schemas can be derived from existing forms.
• Look elsewhere if:
  • You need advanced JSON Schema features (e.g., complex validations, custom formats) beyond what Symfony Forms support.
  • Your forms are highly dynamic or use unsupported Symfony Form types.
  • You’re using a non-Symfony PHP framework (e.g., Laravel without Symfony components).
  • You require real-time schema updates (last release was 2021; maintenance risk).
  • Your team prefers Laravel-native solutions (e.g., Spatie’s JSON:API or custom OpenAPI generators).

How to Pitch It (Stakeholders)

For Executives: "This package lets us automatically generate API schemas from our existing Symfony Forms, cutting the time spent manually defining request/response structures by ~30%. It’s a low-risk way to standardize our APIs, improve frontend-backend alignment, and reduce bugs from schema mismatches. Since it’s MIT-licensed and integrates with our current stack, it’s a no-brainer for accelerating development without major upfront costs."

For Engineering: "If we’re already using Symfony Forms, this library gives us a free, lightweight way to output JSON Schema for APIs or Swagger docs. It’s not a silver bullet—it won’t handle every edge case—but it’ll save us from writing boilerplate schema code for basic CRUD forms. For new projects or features where forms are the source of truth, this is a clear win. For legacy systems, we’d need to audit compatibility first."

For Product/Design: "This ensures our API contracts (used by mobile/web teams) stay in sync with the backend forms. Fewer surprises during integration, and faster iteration when form requirements change. Think of it as ‘auto-generated API documentation’ that’s always up-to-date."