beehiiv-react

Integrate the beehiiv API into Next.js applications for newsletter and subscriber management.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/ejwhite7/beehiiv-react --skill beehiiv-react
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beehiiv-react
Source: https://github.com/ejwhite7/beehiiv-react/tree/main
Command: npx skills add https://github.com/ejwhite7/beehiiv-react --skill beehiiv-react

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @tanstack/react-query, next, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill facilitates seamless integration of beehiiv newsletters into Next.js applications, simplifying the process of managing subscriptions, content visibility, and engagement metrics.

Core Features & Use Cases

  • Subscription Management: Offers React hooks and components for managing newsletter subscriptions.
  • Content Visibility: Provides tools for managing content visibility based on subscriber profiles and tiers.
  • Engagement Tracking: Tracks engagement metrics like opens, clicks, and referrals.
  • Use Case: With this Skill, you can create a dynamic newsletter sign-up form, manage subscriber access to content, and gain insights into engagement with your newsletters.

Quick Start

Initialize beehiiv-react in your Next.js project:

npx beehiiv-react init

This will guide you through setting up the API key, selecting a publication, and generating necessary configuration files.

Frequently Asked Questions about beehiiv-react

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate beehiiv newsletter subscriptions into a Next.js app?

You can integrate beehiiv newsletters into Next.js apps using a server-side API client, React hooks, and UI components. Running npx beehiiv-react init scaffolds the necessary configuration and sets up subscription management features.

Can I use TanStack Query with beehiiv for data fetching and caching?

Yes, beehiiv integration is compatible with TanStack Query for data fetching and caching. This allows you to manage newsletter subscriber data and engagement metrics efficiently within your React components.

How do I track beehiiv newsletter engagement metrics like opens and clicks?

You can track newsletter engagement metrics like opens, clicks, and referrals by using the provided React hooks. These hooks interface with the beehiiv API to surface subscriber interaction data directly in your application.

Do I need TypeScript to manage beehiiv subscribers in Next.js?

Yes, TypeScript is required to use this beehiiv integration. The Skill requires Next.js 13+ and TypeScript to properly support the server-side API client, React hooks, and CLI scaffolding.

What is the best way to manage content visibility for beehiiv subscriber tiers?

The best way to manage content visibility is by using the provided tools that check subscriber profiles and tiers. This allows your Next.js application to dynamically gate content based on the subscriber's level.

How does the beehiiv-react CLI initialize a newsletter setup?

The CLI initializes your setup by guiding you through entering your API key, selecting a publication, and generating configuration files. This scaffolding process prepares your Next.js project for subscription management.