Next.js quickstart

@ghostwritr/next is a keyless, server-only data client for the App Router. It pulls your published articles from the public feed — you render the Markdown. Requires Next 14+.

Install the SDK (and the renderer used below):
- npm
- pnpm
- yarn
- bun
```
npm install @ghostwritr/next @ghostwritr/react
```
```
pnpm add @ghostwritr/next @ghostwritr/react
```
```
yarn add @ghostwritr/next @ghostwritr/react
```
```
bun add @ghostwritr/next @ghostwritr/react
```
Add your site ID to .env.local. It’s the only key you need — see Your site ID.
.env.local
```
GHOSTWRITR_SITE_ID=your-site-id
```

Create a server-only client as a module singleton. createGhostwritr lives at the /server subpath:

import "server-only";
import { createGhostwritr } from "@ghostwritr/next/server";

export const gw = createGhostwritr({
  siteId: process.env.GHOSTWRITR_SITE_ID!, // public read key — no API key
  revalidate: 3600, // ISR window in seconds (default 3600)
});

Render the article page. gw.generateStaticParams is ready to export as-is:

import { notFound } from "next/navigation";
import { ArticleContent } from "@ghostwritr/react";
import { gw } from "@/lib/ghostwritr";

export const generateStaticParams = gw.generateStaticParams;

export default async function Page({
  params,
}: {
  params: Promise<{ slug: string }>;
}) {
  const { slug } = await params;
  const article = await gw.getArticle(slug);
  if (!article) notFound();

  return (
    <article>
      <h1>{article.title}</h1>
      <ArticleContent markdown={article.markdown} className="prose" />
    </article>
  );
}

Render the index, newest first:

import Link from "next/link";
import { gw } from "@/lib/ghostwritr";

export default async function Blog() {
  const articles = await gw.getArticles();
  return (
    <ul>
      {articles.map((a) => (
        <li key={a.id}>
          <Link href={`/blog/${a.slug}`}>{a.title}</Link>
        </li>
      ))}
    </ul>
  );
}

That’s a complete, statically-generated blog reading from the keyless feed. Run next dev and open /blog.

Paste this into Claude Code, Cursor, or any coding agent — it has everything it needs to wire up the SDK (swap in your real site ID):

Read https://developer.ghostwritr.io/llms-full.txt.
My Ghost Writr site ID is <YOUR_SITE_ID>.
Add a /blog index and /blog/[slug] article pages for my published articles, with SEO metadata in generateMetadata and ISR using the @ghostwritr/next SDK in this Next.js App Router app.
It's keyless — the site ID is the only key, there is no API key.

What to reach for next

Pick a rendering mode — ISR, pure SSG, or dynamic SSR is one config flag. See Rendering modes.
Publish instantly — wire the signed feed.updated webhook so new articles appear in seconds, not on the revalidate clock. See Instant revalidation.
SEO — drive generateMetadata and app/sitemap.ts from the article fields. See SEO metadata & sitemap.