# Beamline documentation

The documentation that comes with Beamline's complete system (190 React components and screens), readable here before you buy.

- [Start here](https://beamline.io/docs/start-here.md): What comes with Beamline (package, editable source, reference app, catalog, agent instructions) and the two ways to use it in a React app.
- [Install](https://beamline.io/docs/install.md): Install Beamline into a React 19 app as compiled packages or editable source: the commands, the one stylesheet, UIRoot and Tailwind v4 setup.
- [Customise](https://beamline.io/docs/customize.md): Change how Beamline looks: one brand colour, light or dark, nine looks, custom styles by hand or by agent, tokens, fonts, motion, right-to-left.
- [Connect your data](https://beamline.io/docs/data-integration.md): How Beamline components take data and report actions: market data for trading, tables, streaming AI text and whole screens, your backend in charge.
- [Upgrade](https://beamline.io/docs/upgrade.md): Moving between Beamline releases: migration notes per version, managed source upgrades that keep your edits, recovery and compiled packages.
- [Known limitations](https://beamline.io/docs/limitations.md): What Beamline does not do or has not been checked to do: backends and services, environments, layouts and themes, particular parts, licences.
- [Conventions](https://beamline.io/docs/conventions.md): The one API every Beamline component follows: files and imports, one props vocabulary (variant, size, tone, value), the rendering contract, styling.
- [Design language](https://beamline.io/docs/design-language.md): The visual and motion rules behind every Beamline component: colour, type, density, radii, elevation, looks, focus, data states and motion.
- [Changelog](https://beamline.io/changelog.md): what changed in each release
- [Connect your agent](https://beamline.io/connect.md)