@smidgen/next

Next.js

Easy: middleware 402 for bots + snippet blur for humans. Hard lock: resolvePaywallAccess() in a Server Component (or an API route) so unpaid HTML never includes the premium body.

Before you start

Replace placeholder values like smid_YOUR_PROJECT_ID and https://yoursite.com with your project ID and site origin from the dashboard.

  • A smidgen.io project — copy your project ID from the dashboard
  • Add https://yoursite.com under Allowed websites in project settings
  • Create at least one paywall rule whose path and selector match your premium content
  • Set a payout wallet (Base or Solana) to receive USDC
  • API base URL: https://smidgen.io

Browser snippet

Easy: wallet checkout via snippet.js with data-x402-paywall. Hard lock: see the Hard lock tab.

Middleware

HTTP 402 + x402 payment instructions for agents

Quick setup

Create a project in the smidgen dashboard, then follow these steps on your site.

  1. npm install @smidgen/next (monorepo: already in packages/next).
  2. Add middleware.ts and env vars (see below) — bots get HTTP 402.
  3. Easy paywall: paste the script tag and wrap content in data-x402-paywall.
  4. Hard lock: use resolvePaywallAccess() in a Server Component so unpaid HTML has no secrets.
  5. Add https://yoursite.com to Allowed websites.

Personalized snippets

Open a project in the dashboard for copy-paste configs with your real project ID, API URL, and allowed origin.