feat(website): add next.js marketing site and split library entry points

Author: ATHARVA262005

package.json

@@ -10,6 +10,11 @@
             "types": "./dist/index.d.ts",
             "require": "./dist/index.js",
             "import": "./dist/index.mjs"
+        },
+        "./preview": {
+            "types": "./dist/preview.d.ts",
+            "require": "./dist/preview.js",
+            "import": "./dist/preview.mjs"
         }
     },
     "files": [
@@ -77,4 +82,4 @@
         "typescript": "^5.3.3",
         "vitest": "^1.2.1"
     }
-}
+}

src/preview.ts

@@ -0,0 +1 @@
+export { SocialPreview } from './components/SocialPreview';

tsup.config.ts

@@ -3,10 +3,10 @@ import { defineConfig } from 'tsup';
 export default defineConfig([
     {
         // Library bundle - optimized for browser
-        entry: ['src/index.ts'],
+        entry: ['src/index.ts', 'src/preview.ts'],
         format: ['cjs', 'esm'],
         dts: true,
-        splitting: false,
+        splitting: true,
         sourcemap: true,
         clean: true,
         minify: true,

website/.gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

website/README.md

@@ -0,0 +1,34 @@
+# react-meta-seo Website
+
+The official marketing and documentation website for `react-meta-seo`.
+Built with [Next.js 16](https://nextjs.org), [Tailwind CSS v4](https://tailwindcss.com), and running via "dogfooding" (direct link to parent library).
+
+## Getting Started
+
+1. **Install Dependencies**:
+```bash
+npm install
+```
+
+2. **Run Development Server**:
+```bash
+npm run dev
+```
+
+3. **Build for Production**:
+```bash
+npm run build
+```
+
+## Architecture
+
+- `src/app/page.tsx`: Landing page with feature showcase and interactive demo.
+- `src/app/docs/page.tsx`: Documentation viewer that renders the root `DOCUMENTATION.md`.
+- `src/lib/docs.ts`: Utility to read markdown from the parent directory.
+
+## Dogfooding
+
+This website installs the library via `npm install file:..`. It serves as a comprehensive integration test for:
+- React Server Components (RSC) compatibility
+- TypeScript types
+- Build artifacts (`preview` vs `main` entry points)

website/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

website/lib/docs.ts

@@ -0,0 +1,15 @@
+import fs from 'fs';
+import path from 'path';
+
+// Path to the root DOCUMENTATION.md
+const DOCS_PATH = path.join(process.cwd(), '../DOCUMENTATION.md');
+
+export function getDocumentationContent() {
+    try {
+        const fileContent = fs.readFileSync(DOCS_PATH, 'utf8');
+        return fileContent;
+    } catch (e) {
+        console.error('Failed to read DOCUMENTATION.md', e);
+        return '# Error\n\nCould not load documentation. Please ensure DOCUMENTATION.md exists in the project root.';
+    }
+}

website/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;