Skip to content

Piral Feed Service

Discovery service responses following the Piral Feed Service specification are directly supported.

TIP

You can get access to a free (for personal and non-production payloads) discovery service at feed.piral.cloud. If you like to use this on-premise you can even get a licensed version with support. For more information, see www.piral.cloud.

This document describes the default response from the Piral Cloud Feed Service - following the specification. Note, that the Piral Cloud Feed Service also supports providing responses in other formats, such as the discovery schema.

Schema Description

The returned response has either to be an array consisting of objects following the schema (i.e., they need to have a name, version, spec and link property), or must be an object with an items property that is an array with the previously mentioned array items.

While pilets are directly supported, other micro frontends such as Module Federation or Native Federation powered micro frontends are covered with a special property called custom.

Mapping of Properties

Module Federation

PropertyDescription
nameName of the micro frontend
specNeeds to be set to mf
linkLink to the remote entry (manifest or JS)
custom.idThe global name of the remote
custom.metaDataThe metaData section of the remote entry manifest
custom.exposesThe exposes section of the remote entry manifest
custom.remotesThe remotes section of the remote entry manifest
custom.sharedThe shared section of the remote entry manifest
custom.runtimeThe MF runtime version (e.g., 1.0 or 2.0)
custom.typeThe type (esm / module or var / global)

WARNING

It is crucial that the right runtime version of Module Federation is transported. While a missing runtime value could still be inferred correctly, an incorrect one will almost certainly lead to a wrong interpretation of the micro frontend.

Native Federation

PropertyDescription
nameName of the micro frontend
specNeeds to be set to nf
linkLink to the JSON definition
custom.exposesThe exposes section of JSON definition
custom.dependenciesThe dependencies section of the JSON definition

Pilets

PropertyDescription
nameName of the micro frontend
versionThe version of the micro frontend
linkThe URL of the entry module
dependenciesThe dependencies section of pilet
configThe config section of pilet
specThe spec section of the pilet
integrityThe integrity section of the pilet

Anything Else

This is not supported (right now).

All values in the discovery schema are interepreted as one of the previously three mentioned formats. If you know another format that can be / is transported commonly then let us know!

Released under the MIT License.