Store

A plugin store with featured picks, search, permission details, and install flows.

Since 0.6.0BETA

This component doc is in progress

This page is still being migrated. Demos and API details may change.

Usage

Plugin store

Installs, updates, and grants happen only after you click; Unit Converter fails its first download to show Retry.

Loading demo...

Overview

The plugin store in the Tuff client; manifests and permissions come from the repo, ratings, installs, and reviews are sample data, and nothing is for sale.

  • Installing, updating, granting, and uninstalling start only from your click; playback just turns the carousel once and reports updates, and reduced motion keeps the carousel still.
  • The carousel art is dark on both light and dark docs pages, so the whole carousel renders in the dark theme.
  • Install opens the permission dialog at once (the client downloads and verifies first): Always allow, Allow this session, or Reject install; community plugins add an unofficial-source warning.
  • A download can be cancelled; Unit Converter times out on its first download, and Retry doesn't ask for permissions again.
  • In the column, details replace the list, and Back or Esc restores the scroll position; expanded, they are a side panel. They avoid TxDrawer, which would drag focus back and close two layers on one Esc.
  • Hidden carousel slides are inert, and nothing is announced while it plays; with focus inside it, ← / → change slides.
  • Risk colors and icons always come with words; read-only stars are hidden from screen readers in favor of a sentence.

Customization

  • With a real store, read plugins, channels, permissions, and reasons from the manifests and the store API, and group by the store's own category.
  • The install table is keyed by plugin id: replace the timers with the phases the client reports, and every action slot follows.
  • Put ratings and reviews through moderation: show a submission as Pending and count it only once approved.
  • For suggestions with icons, replace TxSearchSelect with TxSearchInput and a hand-built list, and write the combobox keyboard and screen-reader behavior yourself.
RegionComponentsRole
HeaderTxFilterChips, TxSearchSelectView switch and search suggestions
Categories and sortingTxFilterChips, TxFlatRadio, TxSidebarNavCategory counts and sorting
Featured carouselHand-built region, TxButtonHand-built carousel with controls
Plugin cardsTxCard, TxIconChip, TxRating, TxTagIcon, summary, rating, channel
Action slotTxButton, TxProgressBarOne shared install state
Updates noticeTxStatusBadgeShown after an update check
Details headerTxCornerOverlay, TxTooltip, TxDropdownMenuOfficial badge and the ⋯ menu
Details tabsTxTabs, TxImageGallery, TxKbd, TxStatusBadge, TxTimelineOverview, permissions, versions, reviews
ReviewsTxRating, TxProgressBar, TxAvatar, TxTextareaAverage, distribution, write a review
InstalledTxCardItem, TxSwitch, TxEmptyStateInstalled rows and enable switches
ConfirmationsTxModalPermission, update, uninstall prompts
Empty results and feedbackTxSearchEmpty, TxToastPanelClear search and result notices