rankfirst

Run this inside an existing Next.js App Router project:

npx rankfirst

What it does:

• verifies you are inside a Next.js app
• walks you through setup with an animated, polished terminal UI
• asks which blog route to use
• can open a browser link flow against your logged-in rankfirst.co account
• pulls the API key + webhook secret directly into .env.local
• creates a server-only RankFirst client helper
• adds blog index/detail routes
• adds the signed revalidation route
• adds sitemap support
• patches next.config.* so RankFirst images load through next/image
• appends the needed env vars to .env.example
• ignores .rankfirst-snapshot.json

Notes:

• the generated files are marked with // Generated by rankfirst, so reruns can update them safely
• existing custom files are left alone unless you explicitly approve replacement
• the CLI currently targets App Router (app/ or src/app/)
• --yes keeps the flow automation-friendly and skips interactive prompts

Useful flags:

npx rankfirst --yes
npx rankfirst --yes --link --site-url https://example.com
npx rankfirst --blog-path /resources
npx rankfirst --skip-install