Product Decisions This Supports
- Templating standard decision: whether the product permits a non-Blade view engine at all. Adopting this package is a policy choice about view-layer consistency, not just a library install.
- Developer experience / velocity investment: HAML’s indentation-based, terse syntax can reduce markup boilerplate for teams already fluent in it. This supports a build-vs-buy call on whether to invest in view-layer ergonomics.
- Migration and porting scope: relevant if you are moving a Rails/HAML or existing MtHaml codebase onto Laravel and want to preserve templates rather than rewrite them into Blade.
- Buy vs build for the view layer: the alternative is writing a small in-house HAML integration or standardizing on Blade components. This package is the “buy/borrow” option and should be compared on total cost of ownership, not license cost (MIT is free either way).
- Roadmap for internal tools and admin panels: the highest-fit use case is low-exposure, high-template-churn internal surfaces, not customer-facing core product.
- Vendor and dependency risk policy: a 44-star package last released in December 2020 is a useful forcing function to define your threshold for niche, low-maintenance dependencies.
When to Consider This Package
Consider it when:
- Your team is already fluent in HAML/MtHaml and the productivity gain is real and measurable.
- You have an existing MtHaml/HAML view layer you are porting to Laravel and rewriting to Blade is costly or risky.
- The surface is internal, low-exposure, or short-lived, where a stalled dependency is tolerable.
- You are willing to fork, pin, and own maintenance, and you have verified compatibility with your target PHP and Laravel versions.
- You have run a time-boxed spike proving it works in your stack before committing.
Look elsewhere when:
- You are starting a greenfield Laravel product; Blade plus components covers the need without adding a non-standard engine.
- The product is customer-facing, long-lived, or security/compliance-sensitive. Low stars and a 2020 last release are weak maintenance signals.
- You depend on the broader ecosystem: IDE/plugin support, Livewire, Inertia, Blade component conventions, and hiring pool familiarity all favor Blade.
- PHP 8.x and Laravel 9+/10+ compatibility are unconfirmed. Treat this as a gating risk, not a footnote.
- Your team is not HAML-fluent. Onboarding cost will likely exceed any verbosity savings.
How to Pitch It (Stakeholders)
Summary: bkwld/laravel-haml is a thin wrapper that lets Laravel render HAML templates via MtHaml. It is small, MIT-licensed, and low-profile: roughly 44 stars with a last release in December 2020.
Recommendation: Do not adopt it for core product. It is a reasonable candidate only for a scoped internal tool or a HAML-to-Laravel migration where the team already knows HAML.
Value: The benefit is developer ergonomics — terser templates and less markup boilerplate — not user-facing capability or feature velocity. Frame the business case in engineering hours saved, not product outcomes.
Risks: An effectively unmaintained dependency, mismatch with the Blade-centric Laravel ecosystem, limited hiring and tooling support, and uncertain compatibility with current PHP/Laravel versions.
Mitigation and next step: Run a one-to-two day engineering spike to confirm version compatibility. If it passes, isolate the view layer, pin and fork the package, and gate adoption on a single low-risk surface. If the spike fails, standardize on Blade components and close the question.