Component Documentation¶
The Freeze Design frontend uses a library of reusable React components under
frontend/components/, organised by feature.
Storybook¶
Browse and interact with components in Storybook (Storybook 10, framework
@storybook/nextjs-vite; addons: links, a11y, docs; stories are picked up from
components/**/*.stories.tsx and components/**/*.mdx):
Storybook provides:
- Visual component catalog
- Interactive prop controls (react-docgen-typescript)
- Accessibility testing (@storybook/addon-a11y)
- Component states and variants
Run it locally
Coverage
Seven components have stories today: Logo, TopBar (components/header/),
ProductCard (components/products/) and ColorSwatches, PriceDisplay,
QuantitySelector, SizeSelector (components/product-detail/). The rest of
the library is documented here and in the code.
TypeScript API¶
For TypeScript type definitions and utilities (npm run docs:typedoc):
Component Categories¶
Layout and shell¶
Navigation,Footer(Facebook, Instagram and a WhatsAppwa.melink fromfooter_whatsapp_number),StagingBanner,CookieConsent/CookieSettings,ThemeToggle,Toast(Toaster),StaticPage,FAQAccordion,JsonLd,WhatsAppVraagKnop("Vraag het via WhatsApp", behindwhatsapp_buttons_enabled) (components/)components/header/:Header,TopBar(teal accent bar),Logo,IconBar,SearchBar,CategoryNav,CategoryDropdown,MobileHeadercomponents/homepage/:HeroSection,USPBar,CategoryBlocks,ShopCollectieSection,TeamkledingBlock("Voor je team"),ContentBlocks;components/seo/: structured datacomponents/teamkleding/: the/teamkledinglanding page (TeamkledingHero,HoeHetWerkt,GeschiktVoor,KledingstukKiezer,VeelgesteldeVragen,HulpBlok)
Catalog¶
components/products/:ProductCard(usesnext/imagewithfill+ responsivesizes),CardColorSwatches(colour dots under the photo, behindcatalog_color_swatches_enabled),CategoryHeader,SubcategoryPillscomponents/product-detail/:ProductInfo,ProductImage,ColorSwatches,SizeSelector,SizeChartModal,QuantitySelector,PriceDisplay,PersonalizationPicker,WishlistButton; team ordering withOrderModeSwitch("Voor jezelf | Voor een team"),SizeQuantityGridandTeamPriceSummarycomponents/collection/: collection article cards and detailcomponents/reviews/: Google reviews block;components/newsletter/: sign-up form
Designer¶
components/ProductDesigner/:Designer(Fabric.js canvas) withcomponents/(CanvasSection,DesignToolbar,ToolNav,SidebarTabs,ViewSwitcher,ContextPanel,TextPropertiesPanel,ClipartColorPanel,NameNumberStylePanel,FontDropdown,ColorDropdown,ProductInfoCard,OrderPanelDrawer,DesignReviewPanel,GuestWarningModal,TeamOrderPanel,TabLoading,MobileBottomBar,MobileToolDrawer,MobileContextDrawer,MobileProductInfoBar),components/tabs/(TextTab,ImageTab,ShapesTab,NamesTab,NamesNumbersTab,OrderTab,RosterPasteDialog) andcomponents/team/for the team mode (TeamAddBar,TeamSideTabs,TeamNamesSection,TeamRosterRows,TeamRosterDialog,useRowPreview); hooksuseCanvasHistory,useFontLoader,useKeyboardShortcuts(ImagePropertiesPanelandKeyboardShortcutsHelpwere removed in v1.54)components/Designer/:Designerwrapper withProductSelector,SaveDesignModaland theuseDesignerhook (URL paramsproduct,color,size,design,voor=team,sizes).ColorSizeSelectoris gone (#1192): colour and size are changed in the order tab (OrderTab,ProductDesigner/colorChange.ts) after designingcomponents/designs/:DesignApprovalControls;components/personalization/(the oldcomponents/NamesNumbers/andcomponents/TeamOrder/are gone, v1.53)
Commerce¶
components/Cart/:CartButton,TeamOrderCard(one card perOrderGroupwith size breakdown and "Aanpassen");components/checkout/:CheckoutLoginModal,OneClickSignup,PaymentRetrycomponents/orders/,components/quotes/,components/Account/,components/auth/,components/journey/(guided journey UI)
Admin (components/admin/)¶
- Shell:
AdminHeader,AdminNav(fixedw-64sidebar on desktop, drawer on mobile/tablet),AdminBreadcrumb,AdminLoginForm - Primitives:
AdminDataTable,AdminFormField,AdminToast,AdminConfirmDialog,AdminEmptyState,AdminSkeleton,AdminStatusBadge,AdminTooltip,AdminSectionIntro,BulkActionsBar,PrintZonesBreakdown,SetupReadinessPanel - Feature folders:
dashboard/,vandaag/,orders/,products/,pricing/,designs/,design-assets/,quotes/,cms/,cijfers/(analytics, Recharts)
Providers (components/providers/)¶
QueryProvider(TanStack Query),SentryProviderPostHogProvider- mounted only on shop routes (admin sessions are excluded)MotionProvider- Motion animation context, shop routes only
Shared primitives (components/ui/)¶
Skeleton,PasswordInput,motion/helpers
Sections¶
- Component Library - Design tokens, patterns and story guidelines