Arc
ComponentsBlocksScreensDocsPricingTry the demo
Get Pro
Saved

Docs

IntroductionInstallationThemingMotionAI and MCPChangelog

Components136

ButtonAction buttonSplit buttonButton groupFloating button groupExpanding button groupCopy buttonAction swapIcon morphConfirm morphTheme switcher

Hold to confirmSwipe actionsReactions

Dropdown menuContext menuUser menu

InputTextareaPassword fieldPassword strengthSearch fieldExpanding searchInline edit

Number fieldMoney inputPhone inputScrub inputTag inputMention inputShortcut recorder

SelectComboboxMulti-selectMorph selectChip group

Radio cardsBilling toggleCheckboxRadio groupSwitchSegmented controlRatingToggle group

SliderElastic sliderRange histogram sliderRuler sliderWindow rangeNewProLens rangeNewPro

CalendarDate pickerDate range pickerTime pickerColor pickerEmoji pickerPro

Rich text editorSignature padFile dropzoneAvatar uploadPro

TabsBreadcrumbPaginationMega menu morphProTable of contents progressPro

Scroll areaAccordionExpandable cardResizable panelsExpandable text

DialogDrawerBottom sheetPopoverHover cardTooltipShare accessProConfirm popoverPro

AlertToastToast stackAnnouncement barCookie consentUndo toastPro

ProgressSkeletonStepperCountdownUsage meterOnboarding checklist

AvatarAvatar groupBadgePresence stackPro

CardMetric cardEmpty stateMetric tickerPro

Line chartBar chartDonut chartStreamgraphBrush chartWaffle chartSlope chartSparklineGaugeActivity heatmapAnimated counterRidgelineTreemapSplit barPro

SunburstProSankey flowProFunnel chartProRadar chartProRealtime streamProRace bar chartProData gridPro

Sortable data tableTree tableTree viewReorderable listFilter toolbarCode blockJSON viewer

TimelineComment threadChat thread

Image compareCarouselCard stack

Text revealIn-view titleText morphText shimmer

Blocks122

KPI drilldownProMetric explorerProRevenue explorerProMRR waterfallProCohort retentionProUsage forecastProJourney flowProUptime statusProPivot builderProChoropleth explorerProConnected scatterProHorizon chartProAccount healthPro

Budget variancePro

Small multiplesProLine replayPro

AI chatProAI composerProAI answerProModel pickerProModel arenaProPrompt studioProDocument extractionProAgent memoryProAI side panelProAI inline editProResearch runProAI insight cardProCatch upProAI feature launchProAI search barProAI setup wizardProCall insightsProLead scoringPro

Agent runProAgent tasksProAgent approvalsProAgent routinesProAgent orchestratorProMCP serversProKnowledge baseProEval suiteProAgent builderProAgent galleryPro

SidebarPro4Page headerCommand paletteNotification centerSelection toolbarProEmpty statesSearch resultsPro

Login and sign up5, free and Pro variantsOnboarding illustrationProOTP inputMulti-step formProTwo-factor setupProMagic linkPro

Settings pageProSettings commandProSecurity settingsProBilling overviewProUsage billingProCancel flowProOnboarding surveyProSpend alertPro

Team membersProInvite peopleProRoles and permissionsProProfile pagePro

API keysProWebhooksProIntegrationsProImport wizardNewProEnvironment variablesProDomain verifyProWebhook testerPro

Plan comparisonPricing calculatorProUsage pricingProCart drawerProCheckout summaryProLive checkoutProSeat managerProCredit top-upPro

Wallet cardProDelivery trackerProSeat mapPro

Activity feedProSupport widgetProFeature votingPro

File uploadMedia playerPro

Availability pickerProRelease readinessProFeedback boardProSmart schedulerProTask breakdownProGoal trackerPro

Hero sectionHero signupPro

Scroll storyProSpotlight gridProFeature bentoProComparison table

Logo marqueeStudio perspectivesProStats band

Changelog feedFAQ sectionContact sectionTeam showcaseProBlog grid

Site headerSite footerCTA sectionNewsletter signup

Activity terrainProRevenue globeProCustomer galaxyProSemantic zoomProLayout morphProExploded viewPro

Screens14

Metrics dashboardProMarket terminalPro

Kanban boardProProject boardProGantt timelinePro

Week calendarProMonth calendarNewPro

Team directoryPro

Inbox triageProSupport conversationProHelp centerPro

Product listingProProduct detailProInvoice studioPro

Special components106

Share sheetProAction morphProMorph navProDockProLiquid tab barProOrbit menuPro

Glass menuProGlass segmentedProGlass cardProGlass tab barPro

Sheet stackProWallet stackProControl centerProHolo cardProCard to articleProLink unfurlPro

Product galleryProLightbox galleryProPhoto gridProCover flowPro

Voice orbProNow playingProVoice recorderPro

Booking pillProActivity ringsProTime dialProDate reelPro

Keycap keyboardProSlot textSand textProTypewriter terminalPro

Stretch refreshProMorph loaderProSkeleton morphProBlack holeProCharge sessionPro

Sticker peelProTicket tearProPage curlProOrbit logosProPrize wheelPro

Dot gridProImage trailProGravity wellProInk fluidProCursor trail drawPro

Agent statusProTool callProAgent planProAgent timelineProContext windowProReasoning blockProSource cardsProModel cardProAI workflowProCode suggestionProGhost textProImage generationProDictation buttonProSpeech playerProMeeting summaryProReply draftProAgent handoffProPII redactionProResponse feedbackProLLM cost calculatorProProvider keysProGeneration statsProAI translateProTL;DR toggleProConnector setupProSmart form fillProEnrich columnProTicket routerProAsk your dataProAgent cursorProProvider statusProTraining runProAI commandProStarter promptsProAI mascotProImage revealProAI sparkProPixel mascotProGhost mascotProCube mascotProTone tunerProUpgrade promptProReferral cardProTrial bannerProTeam switcherProLive visitorsProSocial proof toastProInstall snippetPro

Data flowProPayment flowProDNS resolutionProModel trainingProMulti-region failoverProVector searchProBranch graphProAgent loopProMixture of expertsProSpeculative decodingProPrompt cacheProReasoning treePro
What’s new4 new
ScreensProduct listing

Product listing

Pro

A store admin products screen with collections and sales channels, status tabs, filters, a photo grid or a list you can drag to reorder, and live inventory totals. A details panel edits price, stock per size, status and channels in place, and selected products get bulk actions with undo.

Live screen · 1440 × 900

When to use

  • A store admin's products or inventory page with a few dozen to a few hundred products.
  • Back offices where people edit price, stock and channel availability quickly and in bulk.

When not to use

  • A shopper facing collection page; use a storefront layout without admin controls.
  • Huge catalogs with server search; keep this layout but page or virtualize the results from your search service.

Installation

Pro source and install commands unlock with a Pro plan.

Usage

Use this for a category or collection page. Pass products from your catalog, call your cart API in onAddToCart, and move filter state into the URL if you need shareable links.

example.tsx
1import { ProductListing } from "@/components/arc/blocks/product-listing/product-listing";2 3export function ProductsPage({ products }) {4  return (5    <div style={{ height: "100dvh" }}>6      <ProductListing7        storeName="Oakmere"8        products={products}9        onProductChange={product => api.products.update(product.id, product)}10      />11    </div>12  );13}
Built fromSliderSwitchDropdown menuButtonAnimated counter

API reference

2 parts. The first is the root.

ProductListing

A store admin products screen inside the Arc screen shell. The sidebar holds the store's sections and its sales channels, each with a real logo, a listed count and its sync state; pressing one scopes the catalog to it. The page has status filters with counts, search, collection, price, color and size filters, a sort menu, and a photo grid or a dense list you reorder by dragging. Selecting products opens a bulk bar with undo. A details panel edits price, name, status, stock per size and channels in place. Built from Arc's Button, SearchField, Popover, Checkbox, Slider, DropdownMenu, SegmentedControl, Switch, Badge, Avatar, Kbd and AnimatedCounter.

PropTypeDefaultDescription
productsListingProduct[]sample catalogProducts to manage. Optional fields (sku, category, status, stock, sold30, sales14, channels, activity) are filled with sensible defaults when missing. A new array replaces local edits.
colorsListingColor[]sample colors{ id, name, swatch } for the color filter and the colors in the details panel.
sizesstring[]["S", "M", "L"]Size filter options.
defaultSort"featured" | "best-selling" | "newest" | "stock-asc" | "price-asc" | "price-desc""featured"Initial sort. Featured is the manual order, which the list view lets you drag.
defaultView"grid" | "list""grid"Start in the photo grid or the dense list.
onProductChange(product: ListingProduct) => void–Called after any edit to a product: price, name, status, stock or channels. Persist it here.
storeNamestring"Oakmere"Store name in the sidebar and breadcrumbs.
titlestring"Products"Page title for the full catalog. A channel picked in the sidebar uses its own name.
currencystring"USD"ISO currency for prices.
localestring"en-US"Locale for prices and counts.
classNamestring–Extra class on the root.

ListingProduct

PropTypeDefaultDescription
id, name, detailRequiredstring–Identity and a short line, such as the material.
priceRequirednumber–Price in whole currency units. Editable in the details panel.
compareAtnumber–Previous price. Shows struck through beside the sale price.
image, altRequiredstring–Main photo and its description. An empty image shows a placeholder.
hoverImagestring–A second photo, offered as the other thumbnail in the details panel.
colors, sizesRequiredstring[]–Color ids and sizes. A product matches a filter when any of its values is selected; stock is kept per size.
inStockRequiredboolean–Used only when stock is missing: true gives each size 12 units, false gives 0.
stockRecord<string, number>–Units on hand per size. At 10 or fewer in total a product counts as low stock.
status"active" | "draft" | "archived""active"Drives the status tabs and the bulk actions.
sku, categorystring–Shown in the list and panel; category becomes an option in the collection filter.
sold30, sales14number, number[]–Units sold in 30 days and per day over 14 days, for the sold column and the daily sales bars.
channels("online" | "instagram" | "tiktok" | "amazon")[]["online"]Where the product is listed. Toggled in the panel; the sidebar counts active listings per channel and scopes the catalog to one.
badge, updated, activitystring, string, ListingActivity[]–A short tag such as New, the last change date, and a short activity log with people from lib/media.
added, rankRequirednumber–Sort keys for newest and the starting featured order.

Keyboard interactions

/
Focus search. Arrow down or Enter moves into the products.
Arrow keys
Move between cards in the grid or rows in the list; focus lands instantly. Left and right switch the status and layout controls.
EnterorSpace
Open the focused product in the details panel.
X
Select or deselect the focused product. Shift-click selects a range; Command-click toggles one.
JorK
Step to the next or previous product in the details panel.
Arrow upordown on a handle
Move a row in the featured order without dragging.
Escape
Close a filter or menu, clear search, or clear the selection.
⌘K
Focus the sidebar search, from the screen shell.

Accessibility

  • Status filters are Arc's SegmentedControl, a labelled group of pressed buttons whose counts are real text.
  • Each card and row is one button named with the product, price, status and stock; checkboxes and drag handles are separate controls with their own names.
  • The list is a table with column headers and aria-sort on the sortable ones.
  • Filters open in Arc's Popover as labelled dialogs that take focus, close on Escape or an outside press, and return focus to their trigger; the sort is Arc's DropdownMenu.
  • Stock and status pair a meaningful icon (package, circle check, dashed circle, archive) with words, so color never carries meaning alone. Sales channels in the sidebar name their count and sync state in their accessible names.
  • Bulk changes, reorders, new products and exports are announced in a live region, and every undoable change offers Undo.

Motion

  • Cards and rows move to their new places on the smooth spring when filters or sort change; removed items fade out at the same size.
  • Segmented highlights glide on the morph spring. A selected sales channel fills in place, and every hover fill is instant.
  • Switching grid and list, and switching products in the panel, is one short crossfade.
  • Counts roll digit by digit with Arc's AnimatedCounter; stock meters and sales bars grow on the smooth spring.
  • The bulk bar and notices rise 8px into place. Buttons press to 0.97; triggers that open a layer answer with color only.
  • Reduced motion removes travel and layout animation and keeps the final state, focus and feedback.

Responsive behavior

  • At 1440 by 900 the shell sidebar, a four column grid or a seven column list, and the details panel sit side by side.
  • Below 1080px the details panel becomes a sheet opened by clicking a product; below 900px the sidebar becomes a sheet from the menu button.
  • The list drops channels and sold below a 760px main area, then status and price below 640px, where price moves under the name.
  • Below 640px search shares its row with the sort and layout controls, the filters scroll in their own row with edge fades, the grid has two columns, header buttons keep only their icons, and the bulk bar shows icons.

Performance

  • Filtering and sorting are one pass over the products per change; totals are derived, not stored.
  • Only transform and opacity animate. Hover and selection fills are plain CSS with no transition.
  • Edge fades update through data attributes without React renders, and images use next/image with responsive sizes.

Notes for AI

Give your coding assistant the Markdown reference instead of screenshots.

  • Wrap it in an element with a definite height: the screen fills its container and scrolls inside, never the page.
  • Pass products already scoped to the store; the screen filters, sorts and totals on the client. Persist edits through onProductChange.
  • Brand marks for Instagram, TikTok and Amazon are Simple Icons paths (CC0) and are sample content, not endorsements. The store logo is a ScreenShellMark (seed, amber).
  • Built on the screen-shell component; change the sidebar there, not here.
/components/screens/product-listing/markdown

The full library index for assistants is at /llms.txt.

Related

Product detailProBlockA product page in a store admin. You edit photos, variants and stock per location, open any variant in a side panel to change price, cost and stock, follow sales by day, and preview the unsaved draft in the store.Cart drawerProBlockProducts fly into the cart, counts roll, and a drawer handles quantities, shipping progress, and checkout.
PreviousHelp centerNextProduct detail
Arc · 14 screensllms.txt

On this page

  • Preview
  • When to use
  • When not to use
  • Installation
  • Usage
  • API reference
  • Keyboard
  • Accessibility
  • Motion
  • Responsive behavior
  • Performance
  • Notes for AI
  • Related
View as Markdown