liferay-client-extensions

What problem does it solve?

Provides a structured guide to move frontend features out of Liferay's OSGi runtime into modern, decoupled Client Extensions so teams can build, bundle, and deploy React custom elements, theme overrides, global scripts, and microservice-connected actions without Liferay-specific bundlers.

Core Features & Use Cases

• Manifest authoring: Clear YAML examples for customElement, themeCSS, globalJS, FDS renderers, and action types.
• Build & packaging patterns: Vite/Gradle assemble mappings and filename glob guidance to ensure assets match client-extension manifests.
• Deployment workflows: Local ZIP deployment, LXC SaaS flows, and CI/CD considerations for multi-tenant environments.
• Real-world example: Migrate a legacy theme widget into a React custom element named my-react-app that is instanceable, ESM-compatible, and packaged into a deployable CX ZIP.

Quick Start

Create a client-extension YAML, Vite build config, and assemble mapping for a React customElement named my-react-app that outputs ESM assets whose filenames match index.[hash].js and index.[hash].css.