Known limitations

What this release does not do, or has not been checked to do. Each item says what to expect and what to do about it. Per-entry limitations also appear in the catalog under the entry.

Backends and services

• No backend is included. Beamline is the interface. Your app supplies data, persistence, authentication and the actions behind every button. Screens show the state your data and handlers report.
• Demonstrations are labelled. @beamline/ui/demo/* (simulated market feed and paper trading account, sample CRM and analytics data, simulated text stream, agent runs, voice sessions, CSV import assessment and renewal task service) exists to show the screens working. It calls nothing external and never reports a real operation as done.
• No trading execution. The trading components display market data and collect order details. Placing, filling and cancelling orders is your exchange integration; the reference app's paper-trading adapter is a local simulation.

Environments

• Exercised locally: Node 24.19.0, React/ReactDOM 19.3.0, Vite 8.3.2 and TypeScript 5.9.3 with npm 11.17.0 and pnpm 11.22.0 in Chromium. The reference app and selected compiled/source consumers use real production builds; the complete 332-export declaration surface was checked with skipLibCheck: false.
• Next.js 16.3.8 App Router was exercised with TypeScript 6.0.3 for server-side pure helpers, Button hydration, Dialog portals/focus and Table context with explicit CSS. This is a named subset, not a claim that every component or application works in every Next configuration. The older TypeScript 5.9.3 setup did not supply Next's required URLPattern globals.
• A pnpm workspace app and separate consumer UI package were exercised with one shared runtime. Yarn/Bun installer parity, Firefox and Safari remain unverified.
• In an npm workspace member, npm applies overrides only at the workspace root and resolves a relative archive path from each dependent's folder, so compiled installs there list every Beamline unit the selection uses in the member's dependencies (Beamline archives only; registry packages and React stay out). A standalone npm app and pnpm list only the chosen packages.
• The bundled CLI supports Node 20 or newer; the tested Vite version declares ^20.19.0 || >=22.12.0, and the tested Next version declares >=20.9.0. Follow the installed application toolchain's requirement. Node 24.19.0 is the version actually exercised here.
• React 18 and older are not supported (components use React 19 APIs such as ref as a prop).

Layout and themes

• Dark theme at desktop width (1512×982) is the primary design target and the most thoroughly reviewed.
• Light theme and narrow (390 px) layouts are checked for every entry. Where an entry has a known limit, the catalog lists it under that entry ("Limitations"; find.mjs --id <id> prints it too).

Limits of particular entries

• Area, line, bar and composed charts draw their plot in the browser once its width is known: a server-rendered page shows the chart's frame and title, and the plot appears on hydration. Every chart is plain SVG; the only chart dependency is d3-shape's curve maths.

• Sankey chart: flows must not loop, and the layout is clearest up to about 30 nodes.

• Video player: plays what the browser plays natively (MP4/H.264, WebM); there is no adaptive streaming (HLS, DASH). Picture-in-picture appears only where the browser offers it.

• Phone input: number formats and length checks cover common shapes for 48 countries, not every numbering plan. Validate numbers on your server.

• Voice: components take provider adapters (@beamline/ui/lib/voice). The one adapter that ships is browserSpeechToText(), the browser's own recognition: free and keyless, but its quality and privacy are the browser vendor's (some send the audio to their servers), and it is missing in some browsers. Connecting a hosted speech or voice-agent service is your adapter; the integration notes in the speech-input and conversation-bar entries show the shape. Switching microphones mid-call reaches the service only if your adapter implements replaceStream. The gallery's voice audio is placeholder tones with synthetic timings.

• Import mapping: assessment, import and retry are your handlers; the gallery's assessment is a labelled demo.

• Liquid Gooey advanced physics: plain mirrored Items support scope speed, reduced/no motion and offscreen settling. The optional upstream observe, shape, move, bend and melt modes do not expose managed motion or visibility controls; choose plain Items or ordinary controls when those policies are required. Their appearance is not a guarantee of paused work.

Licences and content

• LICENSE.md is a draft for legal review in this pre-release bundle; the final terms replace it before sale.
• Third-party runtime packages keep their own licences; THIRD-PARTY-LICENSES.md lists every one with its text, and docs/DEPENDENCIES.md names the obligations that reach your product (keep TradingView's attribution on the price chart).
• Demonstration figures, people's and companies' names are invented, and demo images are the product's own renders. People in demos show initials avatars rather than photographs.