seo-lint-next 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+- Initial v1 package with the ESLint plugin, standalone CLI, and 10 App Router SEO rules.

package/CONTRIBUTING.md

@@ -0,0 +1,21 @@
+# Contributing
+
+## Local Setup
+
+```bash
+npm install
+npm run check
+```
+
+## Quality Bar
+
+Every change should keep these passing:
+
+- `npm run format:check`
+- `npm run lint`
+- `npm run typecheck`
+- `npm run build`
+- `npm test`
+- `npm run audit`
+
+Rule changes should include focused tests that show both the failing and accepted Next.js pattern.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+<p align="center">
+  <img src="./assets/seo-lint-next-icon-512.png" width="132" height="132" alt="seo-lint-next icon">
+</p>
+
+<h1 align="center">seo-lint-next</h1>
+
+<p align="center">
+  Build-time, App Router-aware SEO linting for Next.js metadata.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/seo-lint-next"><img alt="npm" src="https://img.shields.io/npm/v/seo-lint-next?color=0f766e"></a>
+  <img alt="node" src="https://img.shields.io/badge/node-%3E%3D18.18-0f766e">
+  <img alt="eslint" src="https://img.shields.io/badge/eslint-8.57%2B%20%7C%209-4b32c3">
+  <img alt="license" src="https://img.shields.io/badge/license-MIT-111827">
+</p>
+
+`seo-lint-next` catches the metadata bugs that usually escape to production: missing titles, broken canonicals, unsafe `metadataBase`, bad OG tags, accidental `noindex`, sitemap gaps, invalid JSON-LD, heading skips, and weak image alt text.
+
+## Install
+
+```bash
+npm install --save-dev seo-lint-next
+```
+
+## ESLint
+
+```js
+// eslint.config.mjs
+import seoLint from 'seo-lint-next/eslint'
+
+export default [...seoLint.configs.recommended]
+```
+
+## CLI
+
+```bash
+npx seo-lint-next
+npx seo-lint-next --dir src/app
+npx seo-lint-next --format json
+npx seo-lint-next --strict
+```
+
+## Rule Set
+
+| Rule                          | Default | Catches                                                             |
+| ----------------------------- | ------: | ------------------------------------------------------------------- |
+| `no-missing-title`            |   error | Missing, empty, duplicate, or weak dynamic titles                   |
+| `no-missing-metadata-base`    |   error | Missing, localhost, or non-HTTPS root `metadataBase`                |
+| `no-missing-description`      |    warn | Missing, duplicate, too short, or too long descriptions             |
+| `no-missing-canonical`        |   error | Missing canonicals and hardcoded dynamic-route canonicals           |
+| `no-missing-og-tags`          |    warn | Missing Open Graph/Twitter tags and weak image dimensions           |
+| `no-broken-heading-hierarchy` |    warn | Missing/multiple H1s and skipped heading levels                     |
+| `no-img-missing-alt`          |    warn | Raw `<img>`, missing/generic alt text, layout-shifting images       |
+| `no-accidental-noindex`       |   error | Public `noindex`, blanket robots blocks, risky X-Robots headers     |
+| `no-missing-sitemap`          |    warn | Missing sitemap, relative URLs, missing robots sitemap reference    |
+| `no-invalid-json-ld`          |   error | Invalid JSON-LD syntax, bad context, missing required schema fields |
+
+## Configuration
+
+```js
+import seoLint from 'seo-lint-next/eslint'
+
+export default [
+  ...seoLint.configs.recommended,
+  {
+    rules: {
+      'seo-lint-next/no-missing-description': ['warn', { descriptionLength: { min: 120, max: 160 } }],
+      'seo-lint-next/no-accidental-noindex': [
+        'error',
+        { privateRoutes: ['/admin', '/api', '/auth', '/private'] },
+      ],
+    },
+  },
+]
+```
+
+## CI
+
+```yaml
+- run: npm ci
+- run: npm run check
+```
+
+The package has no production bundle impact. It statically inspects App Router source files, JSX, `metadata` exports, `generateMetadata()` returns, `app/robots.ts`, `public/robots.txt`, and `app/sitemap.ts`.

package/SECURITY.md

@@ -0,0 +1,5 @@
+# Security
+
+Report security issues privately to the package maintainer. Do not open a public issue for exploitable behavior.
+
+`seo-lint-next` runs at development and CI time only. It should not execute user application code while linting.