Skip to main content
Version: v11.7.5

Artifacts Repository

Artifact Repository is a collection of artifacts or resources used across application development lifecycle in WaveMaker platform. It allows for easy exploration and discovery of Artifacts available to the developer network. These artifacts include:

  • Prefabs: Prefabs are a collection of one or more widgets that are bound to APIs or services.
  • Project Shell: Project Shell is an app with functionality that is common to multiple apps across the teams. This can be used as a starting point in app development.
  • Template Bundles: A template bundle is a collection of templates - a re-usable arrangement of one or more widgets in the page content that together capture the purpose of the page.
  • Themes: Themes are style elements which work at the widget or UI component level. Themes help provide a consistent look and feel to your application.

Each of the above artifacts has a workspace to develop the artifact and then publish it for other developers across the team to import/use them.

Artifact Publishing Mechanism​

There are three ways in which an Artifact can be published:

  1. Publish to Project: This will allow the artifact developer to send it to a specific project for testing purposes.
  2. Publish to Team (only for teams version): To make the artifact available for the entire team for all applications to use, it needs to be published to Team. After publishing, Team Admin or Product Owner approves the artifact for use within the team.
  3. Publish to Workspace (only for non-team version): Once tested and verified, it can be used for any project under development. This is done by publishing the artifact to artifact developer's workspace and made available for any project he/she is currently working on.

Each of the Artifact has a slightly different publishing flow as described in the sections for Prefab, Project Shell, Template Bundle and Themes.

In the teams version of WaveMaker Publishing mechanism helps collaboration among team users.  Find more from here.

Once published the artifacts can be viewed from the Artifacts dialog.

Prefab Publishing​

Prefab is developed from the Project Workspace, similar to any other app development, and then made available to other developers. Publishing states for a Prefab include:

  • Publish to Team (only for team version) – Approval by Team Admin. Once approved, Prefab has to be explicitly be imported for use within an application.
  • Publish to Workspace (only for non-team version) - Once published to workspace the Prefab will implicitly be available for use across all projects within the developer's workspace.
  • Publish to Project (both team and non-team versions)– This will result in the Prefab appearing in the specified project with a MOD tag. This can be used for testing purposes before publishing the Prefab.

For more information, see Creating and Publishing Prefabs.

Project Shell Publishing​

Project shell is created by the App Owner from the Studio workspace, by exporting the project being developed as a shell.

Export Project As Shell​

Export Project As Shell behaves differently for the team and non-team versions:

  • Team version: Once the developer exports a project as Shell to Team, they will be prompted to enter the publishing information, see artifact features for more information. The Team Admin has to approve or reject the Shell as with any other Artifact. Once approved, developers can select the Shell when creating new projects.

  • Non-Team version: Export Project as Shell to Workspace will allow the developer to select the Shell when creating new projects within their workspace.

For more information, see Creating and Publishing Project Shell.

Template Bundle Publishing​

Template Bundle can be created from the Project Workspace using from the Template Bundles tab. Publishing Template Bundles process is different for the team and non-team versions:

  • Team version: Once developed Template Bundles can be Published to Team.

The developer will be prompted to enter the publishing information, , see artifact features for more information. The EDN Admin has to approve or reject the Shell as with any other Artifact. Once approved, the Template Bundle will appear in the Page Creation dialog for selection by the developers.

  • Non-team version: The developer needs to Export the Template Bundle as ZIP and then IMPORT it to any app within their Dashboard.

To know more about creating and publishing Template Bundles, click here

Theme Publishing​

Themes can be built by setting up WaveMaker Theme Repository and using Grunt commands.

  • Team Version: Themes can be published using the Export -> Theme to Team option:

  • Non-team Version: There is no Theme publish option for non-team version, the theme zip file generated needs to be imported from the Themes dialog.

To know more about creating and publishing Themes, click here

Artifact flow in Team version

(ONLY for Team version)

The following sections are for Team version of WaveMaker.

Artifact States​

When publishing to Team Artifact goes through several stages:

  • In Development: Developer is working on it. No one else has access. Could be a new artifact or a new version of the existing artifact.
  • UnPublished: Developer applied for approval and it is awaiting action from EDN admin.
  • Rejected: Rejected by the EDN Admin, the developer can rectify/modify the artifact and re-publish it.
  • Approved: Once approved by the EDN Admin, the artifact is available in the artifact repository.

Artifact Features​

Each artifact needs the following information for proper tracking and identification from within the repository:

  • Tag: this will be useful for searching. Each artifact can have multiple tags.
  • Category: this will be used for grouping purpose. Categories are typically defined by EDN Admin and developers associate the artifact with a given category at the time of publishing. The category can be selected from the available list or a new category can be entered. New category needs to be approved by the EDN admin.
  • Version Number: Each artifact is associated with a version (automatic versioning) at the time of the publishing process.
  • Change Log: These include the comments that the developer needs to add before publishing the artifact.

Artifact Publish Process​

Artifact Publishing involves the following steps:

  1. Publish Info: This requires the Developer to enter the Category, Version, and Change Log. In case this Artifact uses or has a dependency on other Artifacts (for example, Project Shell using a Prefab), the dependencies are listed here.

  1. Config: Here the developer can add Tags to aid in the discovery process of the Artifact. It also lists the Metadata like the Platform version it was developed on etc., this information is generated by the platform by default.

  1. Documentation (only for Prefabs): This is populated automatically by the platform, from the Configuration Settings entered at the time of the Prefab development. Any changes to this need to be done at the Prefab development time.

  1. Summary: Verify the details before proceeding with publishing.

Published Artifacts and Updates​

Once published the artifacts can be viewed from the Artifacts dialog.

Artifacts Dialog​

Artifacts dialog will list all the Artifacts available with details like

  • Basic with the category, publisher, changelog, tags, dependency information and metadata information
  • Version History, and
  • Documentation.

Prefabs can be imported from this dialog. Other Artifacts are available for use as soon as EDN Admin approves the Artifact.

Artifact Updates​

Every time there is a change or modification in an Artifact, it needs to be Published again with a changed Version number. When a developer opens a project using that updated Artifact, Artifact updates are prompted. The developer can choose to update, revert (in case artifact is being downgraded) or ignore. Alternatively, notifications will be pushed for the developer within Studio to take an action on artifact upgrades.

Artifact Management​

Artifact Management involves two aspects:

  • Pre-development: this involves defining the Categories, Custom Metadata and Import of Artifacts. These activities are accessed from Launchpad by Super Admin.
  • Post-development: this involves reviewing, approving/rejecting and export of Artifacts. These activities are accessed from Team portal by Team Admin.

Team portal allows a team admin with the following functionality and permissions.

Export Artifact To Another WME​

  1. From the approved artifacts list we can select the artifact and perform Export To Another WME.
  2. You can select the version that you wish to export.
  3. You will be prompted for a WME Host and the Access token.
  4. Upon export the seleted version will be exported to the provided WME.
  • In case of dependent prefabs export of the prefab is not allowed until and unless all its dependencies were exported to that target WME

Imported Artifact​

Artifacts exported from other WME will be available in the Marketplace and can be accessed by all the teams in the Environment

  • Prefabs: Prefabs will be listed in the studio artifacts section under marketplace.
  • Cores: Cores will be listed along with others in core selection section during the application creation.

The flow of taking updates was the same. Once a new version is imported the respective update flow will trigger.