Lens Starter

A moderntemplate for building decentralized social applications on Lens Protocol.

Getting Started

Welcome to the Lens Starter template! Here's how to get started quickly:

1. Clone this repository
2. Install dependencies: bun install
3. Copy the environment file: cp .env.example .env
4. Create a Lens app at https://developer.lens.xyz/apps
5. Copy your App ID and paste it into the .env file as NEXT_PUBLIC_APP_ADDRESS
6. Start the development server: bun run dev
7. Open http://localhost:3000 in your browser

Development Tools

• TS Toolkit: Bun
• Linting & Formatting: Biome
• Scripts:
  • bun run dev - Start development server
  • bun run build - Build for production
  • bun run start - Start production server
  • bun run format - Format code with Biome
  • bun run lint - Lint code with Biome
  • bun run check - Format and lint code with Biome

Technologies used in this template

• Framework: Next.js 15
• Language: TypeScript 5
• Styling: Tailwind CSS 4
• UI Components: Shadcn UI (via Radix UI primitives)
• Lens Protocol:
  • @lens-protocol/client
  • @lens-protocol/react
  • @lens-chain/sdk
• Theme Handling: next-themes
• Web3 Integration:
  • ConnectKit
  • wagmi
  • viem
• Form Handling:
  • react-hook-form
  • zod (validation)
• Data Fetching: TanStack Query
• Date Handling: date-fns
• Visualization: Recharts
• Icons: Lucide React
• Notifications: Sonner