# Puzzle UI > TypeScript-first React design system and developer ecosystem for UI, themes, hooks, icons, SEO, authentication, storage, fullstack tools, and project scaffolding. ## Official resources - Website: https://puzzle-ui.com/ - Full documentation for AI systems: https://puzzle-ui.com/llms-full.txt - Source repository: https://github.com/senorprogramador/puzzle ## Start here - [Getting Started](https://puzzle-ui.com/docs/getting-started): Install Puzzle in your React app, build your first interface, and customize the theme. ## Package overviews - [React UI Component Library](https://puzzle-ui.com/docs/ui): Explore Puzzle UI's TypeScript React component library with live examples, props, and accessibility guidance for forms, layouts, navigation, and overlays. - [Theme](https://puzzle-ui.com/docs/theme): The @puzzle-ui/theme package owns Puzzle's design tokens, color themes, typography, fonts, and theme scoping. - [Hooks](https://puzzle-ui.com/docs/hooks): Reusable React hooks for keyboard shortcuts and accessible roving focus. - [Icons](https://puzzle-ui.com/docs/icons): Render Iconify icons as React SVG components and style them with CSS, currentColor, or Puzzle theme tokens. - [React Hero Components](https://puzzle-ui.com/docs/pieces/components/hero): Build responsive React hero sections with flexible layouts, media, video and reusable presets from Puzzle Pieces. - [SEO](https://puzzle-ui.com/docs/seo): Build metadata, structured data, and technical SEO endpoints with @puzzle-ui/seo. - [Authentication](https://puzzle-ui.com/docs/auth): The @puzzle-ui/auth package provides framework-independent account, session, MFA, and authentication lifecycle primitives for Puzzle applications. - [Fullstack](https://puzzle-ui.com/docs/fullstack): Browser clients, React authentication UI, server handlers, and framework adapters for Puzzle Auth. - [Storage](https://puzzle-ui.com/docs/storage): Vendor-neutral persistence contracts, migrations, adapter conformance testing, and database adapters for Puzzle. - [Create](https://puzzle-ui.com/docs/create): Generate a React application with Puzzle UI, framework-aware theme setup, and optional Tailwind CSS and Puzzle Auth with a working database. ## Tutorials - [Build a Searchable Publication with Puzzle SEO](https://puzzle-ui.com/docs/tutorials/seo): Implement complete server-rendered publication pages with canonical URLs, dynamic social cards, connected JSON-LD, and framework SEO endpoints. - [Build a Protected Dashboard with Puzzle Auth](https://puzzle-ui.com/docs/tutorials/auth): A beginner-friendly guide to accounts, passwords, sessions, authenticator-app MFA, recovery codes, and MongoDB persistence with Puzzle Auth and Bun. - [Add Puzzle Auth to TanStack Start](https://puzzle-ui.com/docs/tutorials/auth-tanstack-start): Step-by-step guide to registration, sessions, authenticator-app MFA, recovery codes, and MongoDB storage with Puzzle Auth in a TanStack Start app. - [Add Puzzle Auth to Next.js](https://puzzle-ui.com/docs/tutorials/auth-nextjs): Step-by-step guide to registration, sessions, authenticator-app MFA, recovery codes, and MongoDB storage with Puzzle Auth in a Next.js App Router app. - [Build a Persistent Notebook with Puzzle Storage](https://puzzle-ui.com/docs/tutorials/storage): Implement typed MongoDB-backed notebook CRUD, optimistic concurrency, a Cloudflare D1 alternative, and Auth persistence integration. ## Additional documentation - [About Puzzle](https://puzzle-ui.com/docs/about): Learn what Puzzle UI provides, how its packages fit together, and where to start with the documentation. - [Puzzle Architecture](https://puzzle-ui.com/docs/architecture): Understand Puzzle's package boundaries, theme and UI relationship, and application integration layers. - [Auth Configuration](https://puzzle-ui.com/docs/auth/configuration): Configure @puzzle-ui/auth managers, storage, password hashing, sessions, and shared rate limiting. - [Auth Account Lifecycle](https://puzzle-ui.com/docs/auth/lifecycle): Use @puzzle-ui/auth for email verification, password reset and change, profile updates, email changes, and account closure. - [Auth MFA and Step-Up](https://puzzle-ui.com/docs/auth/mfa): Configure TOTP, WebAuthn passkeys, recovery codes, mandatory MFA enrollment, and session-bound step-up authentication with @puzzle-ui/auth. - [Auth Security](https://puzzle-ui.com/docs/auth/security): Review storage, token, password, MFA, WebAuthn, and deployment requirements before exposing @puzzle-ui/auth endpoints. - [Deployment](https://puzzle-ui.com/docs/create/deployment): Deploy applications generated by @puzzle-ui/create to production with Next.js, TanStack Start, React Router, or Basic React, using MongoDB, Cloudflare D1, or a custom database. - [Developer Tools](https://puzzle-ui.com/docs/developer): Set up Puzzle applications with the project generator, theme CLI, and practical development guides. - [Authentication Setup](https://puzzle-ui.com/docs/developer/authentication): Configure the Puzzle Auth client and server integrations generated by @puzzle-ui/create. - [Contributing](https://puzzle-ui.com/docs/developer/contributing): Set up the Puzzle repository, understand its structure, and contribute changes consistently. - [Create a Project](https://puzzle-ui.com/docs/developer/create-project): Scaffold a React application with Puzzle UI, Theme, optional Tailwind CSS, and optional Puzzle Auth. - [Testing](https://puzzle-ui.com/docs/developer/testing): Run unit, component, browser, integration, and documentation checks in the Puzzle monorepo. - [Client and React](https://puzzle-ui.com/docs/fullstack/client): Use the browser authentication client, React provider and hooks, forms, MFA settings, and configurable auth experience. - [Next.js adapter](https://puzzle-ui.com/docs/fullstack/next): Mount Puzzle Fullstack authentication handlers in Next.js App Router route handlers. - [Server handlers](https://puzzle-ui.com/docs/fullstack/server): Configure Puzzle authentication handlers, route maps, session helpers, lifecycle endpoints, readiness checks, and step-up protection. - [Shared types](https://puzzle-ui.com/docs/fullstack/shared): Serializable authentication snapshots, inputs, user data, and results exposed by the shared entry point. - [TanStack Start adapter](https://puzzle-ui.com/docs/fullstack/tanstack): Connect Puzzle Fullstack auth routes to TanStack Start server handlers using Web Request and Response APIs. - [Keyboard Keys](https://puzzle-ui.com/docs/hooks/use-keyboard-keys): Listen for selected global keyboard events with configurable callbacks and event control. - [Roving Focus](https://puzzle-ui.com/docs/hooks/use-roving-focus): Manage a single tab stop and keyboard navigation for a composite group of focusable items. - [Puzzle Authentication Observability](https://puzzle-ui.com/docs/observability): Monitoring, metrics, health checks, and operational requirements for production authentication deployments. - [React Page Sections](https://puzzle-ui.com/docs/pieces): Compose responsive marketing sections and introductory page heroes with @puzzle-ui/pieces. - [AnnouncementSection](https://puzzle-ui.com/docs/pieces/components/announcement): Present announcements, promotions, countdowns, and multiple dismissible notices with accessible controls. - [BenefitsSection](https://puzzle-ui.com/docs/pieces/components/benefits): Communicate customer outcomes with responsive benefit lists, cards, icons, media, and featured content. - [ComparisonSection](https://puzzle-ui.com/docs/pieces/components/comparison): Compare plans, products, or options with responsive cards or an accessible, keyboard-scrollable feature table. - [CTASection](https://puzzle-ui.com/docs/pieces/components/cta): Invite visitors to a consumer-defined next step with responsive call-to-action layouts and optional media. - [Dashboard Components](https://puzzle-ui.com/docs/pieces/components/dashboard): Compose accessible dashboard headers, statistics, activity feeds, progress cards, and layouts with Puzzle Pieces. - [Data Display Components](https://puzzle-ui.com/docs/pieces/components/data-display): Reuse Puzzle Pieces stat, timeline, progress, comparison, and empty-state compositions. - [FAQSection](https://puzzle-ui.com/docs/pieces/components/faq): Answer common questions with accessible accordion layouts, optional categories, and local search. - [FeaturesSection](https://puzzle-ui.com/docs/pieces/components/features): Explain product capabilities using responsive feature layouts, optional media, and accessible tabs or accordions. - [Feedback Components](https://puzzle-ui.com/docs/pieces/components/feedback): Present notifications, confirmation dialogs, and recovery actions with Puzzle Pieces. - [HowItWorksSection](https://puzzle-ui.com/docs/pieces/components/how-it-works): Explain a product or process with semantic ordered steps, media, actions, and optional carousel navigation. - [LogoCloudSection](https://puzzle-ui.com/docs/pieces/components/logo-cloud): Display accessible customer, partner, and integration logos in responsive grids, groups, or carousels. - [Marketing & Conversion Sections](https://puzzle-ui.com/docs/pieces/components/marketing): Compose responsive marketing sections for product discovery, customer proof, conversion, FAQs, and comparisons with Puzzle Pieces. - [Dashboard Navigation](https://puzzle-ui.com/docs/pieces/components/navigation): Build responsive, router-independent dashboard navigation and account controls with Puzzle Pieces. - [Project Components](https://puzzle-ui.com/docs/pieces/components/project): Compose generic project cards, collections, progress, member lists, and headers with Puzzle Pieces. - [Settings Components](https://puzzle-ui.com/docs/pieces/components/settings): Build consistent, accessible settings forms and security/profile sections with Puzzle Pieces. - [StatsSection](https://puzzle-ui.com/docs/pieces/components/stats): Present numeric metrics, trends, descriptions, and progress with responsive layouts and reduced-motion support. - [TestimonialsSection](https://puzzle-ui.com/docs/pieces/components/testimonials): Present attributed customer quotes, ratings, logos, avatars, and media in responsive testimonial layouts. - [Puzzle Production Release](https://puzzle-ui.com/docs/production-release): Release prerequisites, validation, publishing, and rollback procedures for Puzzle packages. - [Framework Adapters](https://puzzle-ui.com/docs/seo/frameworks): Serve sitemap and robots routes with Fetch handlers and framework adapters. - [Metadata and URLs](https://puzzle-ui.com/docs/seo/metadata): Configure site defaults and resolve page metadata and SEO URLs. - [React Integration](https://puzzle-ui.com/docs/seo/react): Render page metadata and collect Schema.org nodes with React. - [Robots](https://puzzle-ui.com/docs/seo/robots): Validate and generate robots.txt crawler rules. - [Sitemaps](https://puzzle-ui.com/docs/seo/sitemaps): Generate sitemap XML, split files, and publish sitemap indexes. - [Structured Data](https://puzzle-ui.com/docs/seo/structured-data): Build deterministic Schema.org graphs and serialize safe JSON-LD. - [Testing SEO Metadata and Structured Data](https://puzzle-ui.com/docs/seo/testing): Test SEO fixtures and inspect graph validation diagnostics. - [Validation](https://puzzle-ui.com/docs/seo/validation): Validate graphs, metadata, Schema.org definitions, and rich-result profiles. - [Breakpoints](https://puzzle-ui.com/docs/theme/breakpoints): Shared responsive breakpoints for JavaScript and CSS. - [Theme CLI](https://puzzle-ui.com/docs/theme/cli): Download and self-host Google Fonts with the puzzle-theme CLI, JSON configuration, subset selection, and cached build workflows. - [Colors](https://puzzle-ui.com/docs/theme/colors): Semantic color roles, light and dark color schemes, and the built-in color themes. - [Component Overrides](https://puzzle-ui.com/docs/theme/components): Globally override how Puzzle renders links and images to integrate with routers and frameworks. - [Theme Provider](https://puzzle-ui.com/docs/theme/theme-provider): The Theme component injects design token CSS variables, loads fonts, and applies Puzzle's global styles. - [Design Tokens](https://puzzle-ui.com/docs/theme/tokens): The typed token groups that Theme resolves into --puzzle-* CSS custom properties. - [Typography & Fonts](https://puzzle-ui.com/docs/theme/typography): Typography scales, named typography roles, fluid font sizes, and Google Font loading. - [Practical Puzzle Tutorials](https://puzzle-ui.com/docs/tutorials): Set up a theme with local fonts, build a searchable publication, persist a notebook, and protect an MFA-enabled application using Puzzle APIs. - [Set Up a Theme with Local Fonts](https://puzzle-ui.com/docs/tutorials/theme): Configure a Puzzle theme, create puzzle-fonts.json, download Google Fonts with the CLI, and serve them locally in a React application. - [React Button Component](https://puzzle-ui.com/docs/ui/actions/button): Build React buttons with loading and disabled states, icons, sizes, and theme variants. Explore examples, TypeScript props, and link rendering. - [React Button Group Component](https://puzzle-ui.com/docs/ui/actions/button-group): Group related React buttons horizontally or vertically with consistent spacing. Learn ButtonGroup composition, orientation, and TypeScript props. - [React Toggle Group Component](https://puzzle-ui.com/docs/ui/actions/toggle-group): Build React toggle button groups with single or multiple selection. Explore controlled values, disabled options, keyboard behavior, and TypeScript props. - [React Alert Component](https://puzzle-ui.com/docs/ui/data-display/alert): Show inline React alerts for success, error, warning, and information messages. Explore severity variants, status announcements, examples, and props. - [React Avatar Component](https://puzzle-ui.com/docs/ui/data-display/avatar): Display React user avatars with profile images or initials fallbacks. Explore avatar sizes, status badges, alternative text, and TypeScript props. - [React Badge Component](https://puzzle-ui.com/docs/ui/data-display/badge): Add React notification badges, counts, and status labels to icons or avatars. Explore badge colors, sizes, corner placement, and standalone labels. - [React Card Component](https://puzzle-ui.com/docs/ui/data-display/card): Compose React cards with headers, content, media, and footer actions. Browse product and content card examples, compound components, and TypeScript props. - [React Data Table Component](https://puzzle-ui.com/docs/ui/data-display/data-table): Build React data tables with asynchronous range loading, sorting, and search. Learn column definitions, row rendering, loading states, and TypeScript props. - [React Empty State Component](https://puzzle-ui.com/docs/ui/data-display/empty-state): Design React empty states for no search results, empty lists, and new accounts. Compose explanatory messages, icons, and next-step actions with examples. - [React Image Component](https://puzzle-ui.com/docs/ui/data-display/image): Display responsive React images with loading placeholders, error fallbacks, and aspect ratios. Learn native img props and framework image integration. - [React Image Collage with ImageBox](https://puzzle-ui.com/docs/ui/data-display/image-box): Create responsive React photo collages with ImageBox. Explore image-count layouts for property listings, product photos, and portfolio previews. - [React Paper Surface Component](https://puzzle-ui.com/docs/ui/data-display/paper): Add elevated surfaces to React layouts with Paper. Explore theme-based elevation, padding, and neutral containers without a card's content structure. - [React Progress Bar and Loading Spinner](https://puzzle-ui.com/docs/ui/data-display/progress): Show React progress bars and loading spinners with LinearProgress and CircularProgress. Explore determinate values, indeterminate loading, sizes, and colors. - [React Star Rating Component](https://puzzle-ui.com/docs/ui/data-display/rating): Build React star ratings with half-star precision, controlled values, and read-only scores. Explore keyboard interaction, sizes, colors, and TypeScript props. - [React Skeleton Loading Component](https://puzzle-ui.com/docs/ui/data-display/skeleton): Build React skeleton loading placeholders for text, avatars, and cards. Learn sizing, composition, shimmer styling, and reduced-motion behavior. - [React Rich Text Editor](https://puzzle-ui.com/docs/ui/editors/text-editor): Add a React rich text editor with a formatting toolbar and structured documents. Learn TextEditor, TextEditorToolbar, TextRenderer, and TypeScript types. - [React Autocomplete Combobox](https://puzzle-ui.com/docs/ui/forms/autocomplete): Build React autocomplete inputs with searchable options, multiple selection, and custom text. Explore combobox examples, controlled values, and TypeScript props. - [React Checkbox Component](https://puzzle-ui.com/docs/ui/forms/checkbox): Add React checkboxes with labels, descriptions, and indeterminate states. Learn native form behavior, controlled selection, disabled states, and props. - [React Color Picker Component](https://puzzle-ui.com/docs/ui/forms/color-picker): Add a React color picker with saturation, hue, opacity, CSS color input, and preset swatches. Explore controlled values, labels, examples, and props. - [React Date Picker Component](https://puzzle-ui.com/docs/ui/forms/date-picker): Build React date pickers with a calendar popup and native form integration. Explore single-date selection, controlled values, validation, and TypeScript props. - [React File Upload and Dropzone](https://puzzle-ui.com/docs/ui/forms/file-upload): Build a React file upload dropzone with drag and drop, file validation, and upload progress. Learn file selection, upload handlers, examples, and props. - [React Form Field and Validation Messages](https://puzzle-ui.com/docs/ui/forms/form-field): Connect React form labels, help text, and validation errors to an input. Learn FormField composition, required states, ARIA relationships, and props. - [React Input Group Component](https://puzzle-ui.com/docs/ui/forms/input-group): Compose React input groups with prefixes, suffixes, units, and action buttons. Learn InputGroup add-ons, alignment, examples, and TypeScript props. - [React Form Label Component](https://puzzle-ui.com/docs/ui/forms/label): Associate React form labels with inputs using htmlFor and id. Explore required indicators, optional labels, native label behavior, and TypeScript props. - [React Number Input Component](https://puzzle-ui.com/docs/ui/forms/number-input): Build React number inputs with increment and decrement controls, min and max bounds, and precision. Explore controlled numeric values, examples, and props. - [React Radio Button Group](https://puzzle-ui.com/docs/ui/forms/radio-group): Build React radio button groups for single-choice fields. Explore horizontal and vertical layouts, native form validation, controlled values, and props. - [React Select Dropdown Component](https://puzzle-ui.com/docs/ui/forms/select): Build React select dropdowns with single or multiple selection, grouped options, and custom rendering. Learn controlled values and native form integration. - [React Range Slider Component](https://puzzle-ui.com/docs/ui/forms/slider): Add a React range slider with min, max, and step values. Explore native range input behavior, controlled state, form labels, and TypeScript props. - [React Stepper for Multi-Step Workflows](https://puzzle-ui.com/docs/ui/forms/stepper): Show React multi-step form and workflow progress with Stepper. Learn step selection, controlled state, stable IDs, keyboard behavior, and TypeScript props. - [React Toggle Switch Component](https://puzzle-ui.com/docs/ui/forms/switch): Add React toggle switches for on and off settings. Explore labels, sizes, disabled states, controlled values, form behavior, and TypeScript props. - [React Autosize Textarea Component](https://puzzle-ui.com/docs/ui/forms/text-area-input): Build React textarea fields with automatic height adjustment or manual resizing. Explore TextAreaInput rows, multiline input, examples, and TypeScript props. - [React Text Input Component](https://puzzle-ui.com/docs/ui/forms/text-input): Build React text fields for email, phone, and passwords with icons, prefixes, and suffixes. Explore password visibility, input types, and TypeScript props. - [React Time Picker Component](https://puzzle-ui.com/docs/ui/forms/time-picker): Add a React time picker using the browser's native time input. Learn controlled and uncontrolled values, form integration, validation, and TypeScript props. - [React OTP and Verification Code Input](https://puzzle-ui.com/docs/ui/forms/token-input): Build React OTP and verification code inputs with individual character slots. Explore paste support, auto-focus advancement, masking, and form submission. - [React App Bar and Responsive Header](https://puzzle-ui.com/docs/ui/layout/app-bar): Build a responsive React app bar with branding, desktop navigation, and a mobile drawer. Explore header composition, navigation examples, and props. - [React Aspect Ratio Component](https://puzzle-ui.com/docs/ui/layout/aspect-ratio): Keep React images, videos, and embeds at a consistent aspect ratio. Learn square and widescreen containers using native CSS aspect-ratio and theme styling. - [React Background Pattern Component](https://puzzle-ui.com/docs/ui/layout/background): Add theme-aware decorative background patterns to React pages and sections. Explore Background examples, container sizing, and foreground readability. - [React Bottom Navigation Component](https://puzzle-ui.com/docs/ui/layout/bottom-navigation): Build React bottom navigation bars with icons, labels, and active destinations. Learn BottomNavigation items, links, actions, and TypeScript props. - [React Breadcrumbs Navigation](https://puzzle-ui.com/docs/ui/layout/breadcrumbs): Add React breadcrumb navigation with ancestor links and a current-page indicator. Explore hierarchy examples, aria-current behavior, and TypeScript props. - [React Collapsible Sidebar Navigation](https://puzzle-ui.com/docs/ui/layout/collapsable-sidebar): Build React collapsible sidebar navigation with an icon rail and expandable labels. Explore inline and overlay expansion on desktop and mobile. - [React Responsive Container Component](https://puzzle-ui.com/docs/ui/layout/container): Constrain React page content with responsive container widths. Explore content, prose, and full-width presets, theme width tokens, examples, and props. - [React Responsive CSS Grid Component](https://puzzle-ui.com/docs/ui/layout/grid): Build responsive React CSS Grid layouts with auto-fit columns, theme spacing, and item placement. Explore Grid and GridItem examples and TypeScript props. - [React Page Layout Component](https://puzzle-ui.com/docs/ui/layout/page-layout): Compose responsive React page layouts with a header, main content, sidebars, and footer. Learn semantic layout regions, mobile behavior, and theme backgrounds. - [React Resizable Panels and Split Panes](https://puzzle-ui.com/docs/ui/layout/resizable-panels): Build React split-pane layouts with resizable panels and drag handles. Explore pointer and keyboard resizing, panel composition, examples, and props. - [React Scroll Area Component](https://puzzle-ui.com/docs/ui/layout/scroll-area): Create React scrollable containers with theme-styled scrollbars and native scrolling. Learn viewport sizing, overflow behavior, keyboard access, and props. - [React Page Section Component](https://puzzle-ui.com/docs/ui/layout/section): Build themed React page sections with consistent spacing, centered content, and full-width backgrounds. Explore section themes, width behavior, and props. - [React Section Header Component](https://puzzle-ui.com/docs/ui/layout/section-header): Compose a section eyebrow, heading, description, and action group with responsive alignment and theme-aware typography. - [React Section Stack Layout](https://puzzle-ui.com/docs/ui/layout/section-stack): Stack React page sections with coordinated spacing and optional dividers. Learn SectionStack composition, shared section themes, examples, and props. - [React Separator and Divider Component](https://puzzle-ui.com/docs/ui/layout/separator): Divide React content with horizontal or vertical separators. Explore decorative dividers, semantic boundaries, orientation examples, and TypeScript props. - [React Sidebar Layout Component](https://puzzle-ui.com/docs/ui/layout/sidebar): Add a semantic React sidebar for related resources, filters, or supporting content. Learn Sidebar composition with PageLayout, accessible names, and props. - [React Stack and Flexbox Layout](https://puzzle-ui.com/docs/ui/layout/stack): Arrange React components in horizontal or vertical stacks with theme spacing. Explore responsive direction, flex alignment, wrapping, and TypeScript props. - [React Accordion Component](https://puzzle-ui.com/docs/ui/navigation/accordion): Build React accordions for FAQs and expandable content sections. Explore controlled state, stable item IDs, keyboard navigation, examples, and TypeScript props. - [React Carousel Component](https://puzzle-ui.com/docs/ui/navigation/carousel): Build React image and content carousels with dragging, navigation, and pagination. Learn CarouselController, controlled selection, examples, and TypeScript props. - [React Link Component](https://puzzle-ui.com/docs/ui/navigation/link): Add theme-styled React links with optional router integration and safe new-tab behavior. Learn anchor props, current-page indicators, examples, and overrides. - [React Pagination Component](https://puzzle-ui.com/docs/ui/navigation/pagination): Build React pagination with page numbers, previous and next controls, or URL-based links. Explore controlled pages, accessible labels, examples, and props. - [React Tabs Component](https://puzzle-ui.com/docs/ui/navigation/tabs): Organize React content into tabbed panels with one active tab. Explore controlled selection, initial values, keyboard behavior, examples, and TypeScript props. - [React Tree View Component](https://puzzle-ui.com/docs/ui/navigation/tree-view): Build React tree views for file explorers and nested hierarchies. Learn expandable nodes, selection, typeahead, keyboard navigation, and TypeScript props. - [React Backdrop Overlay Component](https://puzzle-ui.com/docs/ui/overlays/backdrop): Add a dismissible React backdrop behind custom overlays. Learn controlled visibility, dismissal requests, and when to prefer a Dialog or Drawer. - [React Command Palette Component](https://puzzle-ui.com/docs/ui/overlays/command): Build a searchable React command palette or inline command menu. Explore Command, CommandDialog, keyboard navigation, action lists, and TypeScript props. - [React Context Menu Component](https://puzzle-ui.com/docs/ui/overlays/context-menu): Build React right-click context menus with keyboard activation and touch long-press. Explore contextual actions, trigger composition, examples, and props. - [React Modal Dialog Component](https://puzzle-ui.com/docs/ui/overlays/dialog): Build React modal dialogs with titles, descriptions, footer actions, and dismissal controls. Learn controlled open state, dialog composition, and props. - [React Drawer and Slide-Out Panel](https://puzzle-ui.com/docs/ui/overlays/drawer): Build React drawers with resizable modal panels attached to a viewport edge. Explore placement, controlled visibility, dismissal, and keyboard resizing. - [React Dropdown Menu Component](https://puzzle-ui.com/docs/ui/overlays/dropdown-menu): Build React dropdown action menus with grouped items, checkboxes, and radio choices. Explore trigger composition, keyboard navigation, examples, and props. - [React Toast Notifications](https://puzzle-ui.com/docs/ui/overlays/notification): Show React toast notifications with severity helpers, optional actions, and persistent errors. Learn NotificationProvider, useNotification, examples, and props. - [React Floating Positioning with Popout](https://puzzle-ui.com/docs/ui/overlays/popout): Position React floating content relative to a trigger with Popout. Explore anchored placement, opening and dismissal, custom overlays, and TypeScript props. - [React Popover Component](https://puzzle-ui.com/docs/ui/overlays/popover): Add React popovers for interactive content in a non-modal dialog anchored to a trigger. Explore titles, close buttons, controlled state, examples, and props. - [React Portal and Named Targets](https://puzzle-ui.com/docs/ui/overlays/portal): Render React content into a different document target with Portal and PortalTarget. Learn named targets, mount behavior, React ownership, and examples. - [React Tooltip Component](https://puzzle-ui.com/docs/ui/overlays/tooltip): Add React tooltips that show short hints on hover or keyboard focus. Explore trigger requirements, controlled visibility, dismissal, examples, and props. - [React Heading and Typography Component](https://puzzle-ui.com/docs/ui/typography/heading): Style React headings with theme typography while preserving semantic HTML levels. Learn visual hierarchy, heading elements, alignment, and TypeScript props. - [React Text and Body Typography](https://puzzle-ui.com/docs/ui/typography/text): Apply theme typography to React paragraphs, labels, and supporting text. Explore Text roles, semantic elements, body copy examples, and TypeScript props. - [React Component Preview and Code Examples](https://puzzle-ui.com/docs/ui/utilities/preview): Preview React components in isolated iframes with source code and device-size controls. Learn Preview sizing, live examples, code display, and props. - [React Scroll Lock Component](https://puzzle-ui.com/docs/ui/utilities/scroll-lock): Disable background scrolling in React with ScrollLock. Learn conditional document scroll locking for overlays while preserving existing body styles. - [React Enter and Exit Transitions](https://puzzle-ui.com/docs/ui/utilities/transition): Animate React mounting and unmounting with reusable CSS transition templates. Explore enter and exit animations, child composition, visibility, and props. ## API maturity and compatibility Button, ButtonGroup and ToggleGroup have Stable APIs. Storage adapters, Auth, Session, Fullstack and SEO surfaces described in the tutorials are Beta; other UI primitives have component-specific labels. Beta status does not guarantee production readiness. See https://puzzle-ui.com/docs/tutorials#api-maturity.