# Build and Publish a Simple Widget
This tutorial describes how to build and publish a single-component Entando Bundle consisting of a simple widget. Following the steps below will:
- Define the bundle component
- Push the bundle artifact to a Docker registry
- Apply the bundle custom resource to Kubernetes
- Install the bundle into an Entando Application
- Verify dependencies with the Entando CLI:
ent check-env develop
- Authenticated Docker credentials
- A running Entando instance
Bundles are generated using the
ent bundle command and its convenience methods.
# Create and Deploy a Simple Widget
Initialize a bundle project:
ent bundle init YOUR-BUNDLE-NAME
This generates the required bundle structure by scaffolding default files and folders.
Create a widget folder inside the
platformfolder of your bundle's root folder:
mkdir -p platform/widgets
Descriptor files are organized by component type, with all micro frontends, microservices and platform-specific components located under their respective parent folders. The parent folder
platformand child folder
widgetscomplete the path to widget descriptor files.
Create a widget descriptor file inside the widget directory:
A descriptor file name is a user-defined string of alphanumeric and special characters. The file must reside in its corresponding component folder, e.g.
Add the following definition to the widget descriptor file:
Note: Retain correct YAML indentation of 2 or 4 spaces. To avoid potential processing conflicts, the
codefield value must not contain the hyphen character.
code: example_widget titles: en: Example Widget it: Widget d'esempio group: free customUi: <h2>Hi from Example Widget</h2>