Wizard Marketplace

The Wizard Marketplace page at /fw/wizards/marketplace displays wizard templates shared through the cross-organization marketplace. Users can browse, preview, and clone templates into their own organization.

​

Overview

The Wizard Marketplace fetches listings from useMarketplaceListings and featured listings from useFeaturedListings. Featured templates are shown in a horizontally scrollable carousel when no search or module filter is active. All listings are shown in a responsive grid below. A MarketplacePreviewDialog allows users to inspect a template before cloning. Cloning uses useMarketplaceMutation.cloneListing and redirects to /fw/wizards/:id/edit on success.

​

Who it’s for

Access follows your organization’s role and module configuration. All authenticated users with access to the FW module can browse the wizard marketplace. Cloning requires an active organization context.

​

Browsing and cloning

Browsing:

1. Navigate to /fw/wizards/marketplace.
2. Review featured templates in the horizontal carousel (when no filters are active).
3. Browse all templates in the main grid.

Filtering and sorting:

1. Use the MarketplaceFilters component to filter by search term and/or module.
2. Adjust the sort order (e.g., popular).

Previewing a template:

1. Select a listing card to open the MarketplacePreviewDialog.
2. Review the template details.
3. Select Clone to proceed with cloning.

Cloning a template:

1. From a card or preview, select Clone.
2. The CloneFromMarketplaceDialog opens for confirmation.
3. Confirm the clone. On success the wizard template is added to the organization and the browser navigates to /fw/wizards/:id/edit.

• Marketplace listing — A wizard template made available by another organization for cloning.
• Featured listing — A curated marketplace listing shown prominently at the top of the page.
• Clone — Creates a copy of the marketplace listing’s wizard template in the current organization.
• Module filter — Filters listings by the platform core they are associated with (e.g., rh, hr, cl).

​

Viewing a listing

The Listing Details screen (/fw/wizards/marketplace/:listingId) displays the full detail of a wizard template marketplace listing. This screen loads a marketplace listing via useMarketplaceListing identified by listingId. The breadcrumb label is set to listing.title via useEntityBreadcrumb. The listing detail shows metadata and step structure (via WizardStep type). User reviews and ratings are loaded via useListingRatings. Cloning is initiated by CloneFromMarketplaceDialog; on success the user is navigated to /fw/wizards/:id/edit for the cloned template. A rating submission form (stars + text review) is present inline, submitted via useMarketplaceMutation. Wizard steps are shown in a collapsible list. Before you start: reach this screen from the Marketplace (/fw/wizards/marketplace) by clicking a listing. You must be logged in; the current organization is used for cloning.

1. Navigate to /fw/wizards/marketplace/:listingId or click a listing in the marketplace.
2. Read the description, steps, and metadata for the wizard template.
3. Scroll to the reviews section to see community ratings via MarketplaceReviewsList.
4. Click Clone to open CloneFromMarketplaceDialog and add this template to your organization.
5. Select a star rating and optionally enter a review, then submit.

• Clone — copies the marketplace template into the current organization as a new wizard template, then navigates to the wizard builder.
• WizardStep — the structured steps that define the wizard template flow.

​

Related

Documentation sources

• src/routes/fw.tsx
• src/platform/wizards/pages/MarketplacePage.tsx
• src/platform/wizards/pages/MarketplaceListingDetailPage.tsx
• src/platform/wizards/hooks/useMarketplace.ts
• src/platform/wizards/hooks/useMarketplaceMutation.ts