Lightweight Charts best practices

Use when working with TradingView Lightweight Charts for financial or time-series charting.

Mental model

• Lightweight Charts is a client-side imperative chart library. It is not designed to run on the server out of the box.
• Treat the chart instance and series APIs as imperative resources that need lifecycle management.
• Keep the integration layer thin: React or framework code should own mounting and cleanup, while the chart library owns drawing and interaction.

Client-only lifecycle

• Create charts only in a real browser environment after the container element exists.
• Dispose or clean up chart resources when the component or page unmounts.
• Keep server-rendered output and client chart initialization separate so SSR does not accidentally execute chart code.

Chart and series setup