Skip to main content

Component reference

The package exports 60 components. This page is the catalogue; for the live preview and the auto-generated prop table of any component, open it in Storybook — every component has a story, and the Storybook "Docs" tab renders its full *Props interface from the TypeScript source.

Why the prop tables live in Storybook

The components are Vue Single-File Components (.vue). The generated API reference is produced by TypeDoc, which cannot parse SFCs — so it documents the package's headless surface (composables, the provider, the SDK seam, utilities and types) and not the component props. Each component's props are documented in Storybook instead.

Components that need infrastructure (the SDK services, the current user) resolve it from the Propeller provider (providePropeller) — see Getting started. For how the composables behind these components reach the GraphQL backend, see the API integration guides.

Product

ComponentWhat it renders
ProductCardFull product card — image, badges, name, SKU, price, favourite, embedded AddToCart
ProductGridResponsive product/cluster grid with internal fetching, skeleton, empty state, pagination
ProductInfoProduct headline block — name, SKU, price, stock, short description
ProductPricePrice display — gross/net, discounts, tax-inclusive toggle
ProductBulkPricesQuantity-tiered price table
ProductGalleryImage gallery — main image, thumbnails, zoom, lightbox
ProductTabsTab bar wrapping description / specs / downloads / videos
ProductDescriptionLong description, with collapse/expand
ProductShortDescriptionOne-line summary
ProductSpecificationsAttribute/spec table
ProductDownloadsDownloadable documents
ProductVideosEmbedded videos
ProductSliderHorizontal product carousel (cross-sells, related)
ProductBundlesBundle offers for a product
AddToCartQuantity stepper + add button
AddToFavoriteFavourite toggle with a list-picker modal
ItemStockStock-availability badge

Cluster

ComponentWhat it renders
ClusterCardProduct-cluster card
ClusterInfoCluster headline info
ClusterOptionsSelectable option groups
ClusterConfiguratorConfiguration picker narrowing candidate products

Grid

ComponentWhat it renders
GridTitleCategory / search heading
GridToolbarSort, per-page, view-toggle, active-filter badges
GridFiltersAccordion filter sidebar — price slider + attribute facets
GridPaginationPagination bar (compact or full)

Cart & checkout

ComponentWhat it renders
CartOverviewFull editable cart
CartItemOne cart line — image, qty stepper, total, remove
CartSummaryCart totals panel + checkout/quote actions
CartIconAndSidebarHeader cart icon + slide-out sidebar
ItemsOverviewRead-only cart line list (review / confirmation)
ActionCodePromo/action-code apply + remove
CartPaymethodsPayment-method tiles
CartCarriersShipping-carrier tiles
DeliveryDateExpected delivery date, optional date picker

Address

ComponentWhat it renders
AddressCardA single address, with per-field show/hide
AddressSelectorModal address picker for logged-in users

Order & quote

ComponentWhat it renders
OrderListPaginated order table with search/filter
OrderSummaryOrder headline facts
OrderItemCardOne order line
OrderTotalsOrder totals block
OrderShipmentsShipment / tracking info
OrderActionsPer-order actions (PDF, re-order)
QuoteActionsAccept-quotation button + T&C checkbox

Account & auth

ComponentWhat it renders
AccountIconAndMenuHeader account control / account-page sidebar
CompanySwitcherActive-company switcher for multi-company contacts
UserDetailsUser profile block
LoginFormEmail/password sign-in
RegisterFormAccount registration
ForgotPasswordPassword-reset request

Favourites

ComponentWhat it renders
FavoriteListsThe user's favourite lists
FavoriteListItemOne row of a favourites list
FavoriteListDetailsThe contents of one favourite list
ComponentWhat it renders
MenuCategory navigation tree
SearchBarProduct search with type-ahead results
BreadcrumbsCategory trail

Purchase authorization (B2B)

ComponentWhat it renders
PurchaseAuthorizationConfiguratorManage a company's PA rules
PurchaseAuthorizationRequestsCarts awaiting authorization

Category

ComponentWhat it renders
CategoryDescriptionCategory long description, with collapse
CategoryShortDescriptionCategory short description

Display helper

ComponentWhat it renders
PriceToggleIncl./excl. VAT switch (uncontrolled — reports via callback)