---
name: "@lens-blocks"
slug: "lens-blocks"
description: "Lens Blocks is a beta shadcn/ui registry of social UI components built for the Lens Social Protocol, integrating the official Lens React SDK with wagmi and ConnectKit. Blocks include Account Chooser, Account Hover Card, Collect Post Dialog, Login, Post, Quote Post Dialog, Tip Dialog; components include Account List Item, Audio Player, Follow Button, Link Preview, Login Button, Markdown renderer, Paginated List, Text Editor, and Video Player. Hooks cover authenticated account, login with Viem, reaction toggle, tip actions, and post context. Handles wallet connection, signing, session lifecycle, and optimistic updates out of the box. Use for: building decentralized social features on Lens Protocol without hand-rolling wallet auth and SDK wiring."
category: "Crypto/web3"
tags: ["audio", "auth", "blocks", "buttons", "cards", "components", "crypto", "editor", "hooks", "media", "overlays"]
framework: "react"
license: "MIT"
author: "iPaulPro"
website: "https://lensblocks.com"
github: "https://github.com/iPaulPro/lens-blocks"
registry: "https://lensblocks.com/r/registry.json"
pro: false
pro_url: null
github_stars: 6
component_count: 24
generated_at: "2026-07-28T08:59:05.895Z"
---

# @lens-blocks

Lens Blocks is a beta shadcn/ui registry of social UI components built for the Lens Social Protocol, integrating the official Lens React SDK with wagmi and ConnectKit. Blocks include Account Chooser, Account Hover Card, Collect Post Dialog, Login, Post, Quote Post Dialog, Tip Dialog; components include Account List Item, Audio Player, Follow Button, Link Preview, Login Button, Markdown renderer, Paginated List, Text Editor, and Video Player. Hooks cover authenticated account, login with Viem, reaction toggle, tip actions, and post context. Handles wallet connection, signing, session lifecycle, and optimistic updates out of the box. Use for: building decentralized social features on Lens Protocol without hand-rolling wallet auth and SDK wiring.

## Links

- Website: https://lensblocks.com
- GitHub: https://github.com/iPaulPro/lens-blocks
- Registry JSON: https://lensblocks.com/r/registry.json
- Directory page: https://sh4dcn.vercel.app/registry/lens-blocks
- This file: https://sh4dcn.vercel.app/md/lens-blocks.md

## Install

```sh
# add the whole registry (shadcn CLI)
npx shadcn@latest add https://lensblocks.com/r/registry.json
pnpm dlx shadcn@latest add https://lensblocks.com/r/registry.json
bunx shadcn@latest add https://lensblocks.com/r/registry.json
# clone the source repo
git clone https://github.com/iPaulPro/lens-blocks.git
# fetch the raw registry index
curl -s https://lensblocks.com/r/registry.json
```

## Components (24)

| name | type | description | install |
| --- | --- | --- | --- |
| paginated-list | registry:component | A reusable paginated list component that fetches and displays items in pages, with support for loading states and end-of-list indicators, based on Paginated an… | `npx shadcn@latest add https://lensblocks.com/r/paginated-list.json` |
| login-button | registry:component | A button component to initiate the Lens login flow, displaying the lens icon and a call to action. | `npx shadcn@latest add https://lensblocks.com/r/login-button.json` |
| utils | registry:lib | Utility functions for interacting with Lens Social Protocol, including formatting and data manipulation. | `npx shadcn@latest add https://lensblocks.com/r/utils.json` |
| use-authenticated-account | registry:hook | A hook to get the currently authenticated Lens account using the Lens React SDK. | `npx shadcn@latest add https://lensblocks.com/r/use-authenticated-account.json` |
| use-login-with-viem | registry:hook | A hook to execute login with the Lens React SDK using the Viem library for wallet interaction. | `npx shadcn@latest add https://lensblocks.com/r/use-login-with-viem.json` |
| use-reaction-toggle | registry:hook | A hook to toggle reactions (like/unlike) on Lens posts using the Lens React SDK. | `npx shadcn@latest add https://lensblocks.com/r/use-reaction-toggle.json` |
| use-tip-post-action | registry:hook | A hook for tipping Lens Posts using the Lens React SDK. | `npx shadcn@latest add https://lensblocks.com/r/use-tip-post-action.json` |
| use-tip-account-action | registry:hook | A hook for tipping Lens Accounts using the Lens React SDK. | `npx shadcn@latest add https://lensblocks.com/r/use-tip-account-action.json` |
| use-post-context | registry:hook | A hook for state, queries, and operations in a shared Lens post context | `npx shadcn@latest add https://lensblocks.com/r/use-post-context.json` |
| post-provider | registry:lib | A provider of a shared Lens post context for state, queries, and operations. | `npx shadcn@latest add https://lensblocks.com/r/post-provider.json` |
| account-chooser | registry:block | A list of available Lens accounts for the user to choose from, with support for pagination. | `npx shadcn@latest add https://lensblocks.com/r/account-chooser.json` |
| account-list-item | registry:component | A list item for a Lens account displaying the avatar, name, and handle. | `npx shadcn@latest add https://lensblocks.com/r/account-list-item.json` |
| audio-player | registry:component | An audio player component for playing audio attachments in Lens posts. | `npx shadcn@latest add https://lensblocks.com/r/audio-player.json` |
| video-player | registry:component | An video player component for playing video attachments in Lens posts. | `npx shadcn@latest add https://lensblocks.com/r/video-player.json` |
| text-editor | registry:component | A rich text editor component for composing Lens posts using TipTap, with support for mentions. | `npx shadcn@latest add https://lensblocks.com/r/text-editor.json` |
| follow-button | registry:component | A button component to follow or unfollow a Lens Account, displaying the current follow state. | `npx shadcn@latest add https://lensblocks.com/r/follow-button.json` |
| account-hover-card | registry:block | A hover card that displays Lens account details when hovering over an account name or handle. | `npx shadcn@latest add https://lensblocks.com/r/account-hover-card.json` |
| login | registry:block | A full-featured login flow for Lens Social Protocol that hooks into the Lens React SDK, uses ConnectKit for wallet connections, supports account switching and … | `npx shadcn@latest add https://lensblocks.com/r/login.json` |
| lens-markdown | registry:component | A Markdown renderer for Lens posts and comments, supporting mentions, links, and rich text formatting. | `npx shadcn@latest add https://lensblocks.com/r/lens-markdown.json` |
| tip-dialog | registry:block | A dialog component for sending tips to Lens Posts and Accounts, with support for multiple tokens and payment sources. | `npx shadcn@latest add https://lensblocks.com/r/tip-dialog.json` |
| quote-dialog | registry:block | A dialog component for quoting Lens Posts, allowing users to add their own commentary while sharing the original post. | `npx shadcn@latest add https://lensblocks.com/r/quote-dialog.json` |
| collect-dialog | registry:block | A dialog component for collecting Lens Posts with support for paid collects. | `npx shadcn@latest add https://lensblocks.com/r/collect-dialog.json` |
| link-preview | registry:component | A component to display a link preview for URLs included in Lens posts, showing the title, description, and image. | `npx shadcn@latest add https://lensblocks.com/r/link-preview.json` |
| post | registry:block | Displays a post from Lens Social Protocol, including the content, author, attachments, and engagement actions. | `npx shadcn@latest add https://lensblocks.com/r/post.json` |

## For AI agents

```text
You are adding components from @lens-blocks to a shadcn-compatible project.
1. Read this file (https://sh4dcn.vercel.app/md/lens-blocks.md) for the component list.
2. Fetch the machine-readable index: https://lensblocks.com/r/registry.json
3. Install a single component with its install command from the table above.
4. Full structured record: https://sh4dcn.vercel.app/json (library slug: lens-blocks).
```