# Rank Math for Next.js

> An independent Next.js App Router port derived from Rank Math SEO 1.0.275, adapting its admin experience and runtime contracts beyond WordPress.

Canonical page: https://foulfoxhacks.dev/tools/rank-math-nextjs/
Source: https://github.com/foulfoxhacks/Rank-Math-for-NextJS
Status: Source port · no published GitHub release
License: GPL-3.0-or-later
Languages: TypeScript, React, Next.js
Reviewed: September 7, 2026, at commit 7a3fdacdf3ca0875307218b9ad8882e03c39e6cf

## What problem does it solve?

Rank Math's WordPress interfaces rely on WordPress routes, options and hooks. This port replaces those primitives with Next.js routes, components and adapters while retaining the original administrative structure.

## Status

The reviewed README identifies Rank Math SEO 1.0.275 as the upstream baseline, not this port's release number. No GitHub release was published at the reviewed revision.

## Features

- Adapt the dashboard, setup wizard, general settings, titles/meta and sitemap settings to Next.js routes.
- Provide focus-keyword, readability, snippet, robots, schema and social-preview editing workflows.
- Expose modules for analytics, SEO analysis, redirects, 404 monitoring, schema templates and link graphs.
- Use Next-native adapters for metadata, sitemaps, robots, feeds and scheduled work.
- Separate runtime storage, permissions, authorization and provider integrations behind contracts.

## Before you install

- A Node.js/npm development environment compatible with the repository's Next.js dependencies; review package.json and the lockfile before installation.
- Local .env.local configuration copied from .env.example. Provider-backed features need their own credentials and, where applicable, entitlements.
- Production use requires durable storage and a real session/authentication integration instead of relying on local-development defaults.

## Install

Clone the independent port and follow its source-development workflow. Copy .env.example to .env.local before starting the local server:

```sh
git clone https://github.com/foulfoxhacks/Rank-Math-for-NextJS.git
cd Rank-Math-for-NextJS
npm install
# Copy .env.example to .env.local and configure it.
npm run dev
# Repository verification commands:
# npm run typecheck
# npm run build
```

The README uses http://localhost:3000 for development. Its default data/runtime.json store is for local development; replace it with an appropriate persistent adapter before a production deployment.

## Known limits

- This is an independent derivative port, not an official Rank Math integration. It is not affiliated with, endorsed by or supported by Rank Math.
- The upstream baseline number does not certify feature parity, production readiness or paid-provider access. Review the adaptation notes and configure external integrations separately.
- The local dashboard was launched for the screenshot with account services disconnected. This does not validate provider integrations, SEO outcomes or production readiness.

## Documentation

- [Port architecture and local setup](https://github.com/foulfoxhacks/Rank-Math-for-NextJS/blob/7a3fdacdf3ca0875307218b9ad8882e03c39e6cf/README.md)
- [Upstream attribution and trademark notice](https://github.com/foulfoxhacks/Rank-Math-for-NextJS/blob/7a3fdacdf3ca0875307218b9ad8882e03c39e6cf/NOTICE.md)

## Releases

No GitHub release or separate source CHANGELOG was found at the reviewed revision. The pinned source and repository commit history identify the implementation being described.

https://github.com/foulfoxhacks/Rank-Math-for-NextJS/commits/7a3fdacdf3ca0875307218b9ad8882e03c39e6cf