> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paywalls.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Front-end Widgets

🚧 **(in development)**

Front‑end widgets will provide drop‑in components and hooks to embed **authorization**, **top‑up**, **balance**, and **activity** in your UI without custom paywall plumbing.

**What they will enable**

* Render paywall assistant messages (auth/top‑up) as native UI and handle link flows automatically.
* Show **BalanceBadge**, **AuthorizeButton**, **TopupButton**, and an **ActivityFeed** with minimal wiring.
* Expose hooks like `usePaywall`, `useBalance`, `useAuthorization` plus a context provider.
* Handle post‑checkout reconciliation (auto refresh/poll), loading/error states, and accessibility.
* Support **theming** and **i18n**; work with CSR/SSR.
* Keep your **paywall key server‑side** (widgets never require exposing it).

**Status:** Not yet available; actively in development.