feat: add Auth HI! documentation site with Nextra

- Set up Nextra 4 docs site with GitHub Pages deployment
- Add comprehensive guides (getting started, patterns, examples, troubleshooting)
- Include privacy policy and support pages for Chrome Web Store

Author: prosdev

.github/workflows/deploy-docs.yml

@@ -0,0 +1,64 @@
+name: Deploy Docs to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - '.github/workflows/deploy-docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: 'pages'
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          cache: 'pnpm'
+          cache-dependency-path: 'docs/pnpm-lock.yaml'
+
+      - name: Install dependencies
+        working-directory: docs
+        run: pnpm install
+
+      - name: Build
+        working-directory: docs
+        run: pnpm build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/out
+
+  deploy:
+    runs-on: ubuntu-latest
+    needs: build
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: deploy-pages@v4
+

.github/workflows/release.yml

@@ -0,0 +1,64 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Build and Release
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+      
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          cache: 'pnpm'
+      
+      - name: Install dependencies
+        run: pnpm install
+      
+      - name: Lint
+        run: pnpm lint
+      
+      - name: Type check
+        run: pnpm type-check
+      
+      - name: Test
+        run: pnpm test
+      
+      - name: Build
+        run: pnpm build
+      
+      - name: Get version from package.json
+        id: package_version
+        run: echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
+      
+      - name: Create extension zip
+        run: |
+          cd dist
+          zip -r ../auth-header-injector-${{ steps.package_version.outputs.version }}.zip .
+          cd ..
+      
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: auth-header-injector-${{ steps.package_version.outputs.version }}.zip
+          generate_release_notes: true
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+

.husky/pre-commit

@@ -1,11 +1,5 @@
-# Get staged files
-files=$(git diff --cached --name-only --diff-filter=ACMR "*.ts" "*.tsx" "*.js" "*.jsx" | xargs)
-
-if [ -n "$files" ]; then
-  echo "Running Biome on staged files: $files"
-  pnpm lint-staged $files
-  git add $files
-fi
+# Run linting (same as CI)
+pnpm lint
 
 # Run TypeScript type check
 pnpm type-check

biome.json

@@ -7,7 +7,7 @@
   },
   "files": {
     "ignoreUnknown": false,
-    "ignore": ["node_modules", "dist", "coverage"]
+    "ignore": ["node_modules", "dist", "coverage", "docs/.next", "docs/out"]
   },
   "formatter": {
     "enabled": true,

docs/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+node_modules/
+
+# Next.js
+.next/
+out/
+
+# Build output
+*.tsbuildinfo
+
+# TypeScript
+next-env.d.ts
+
+# Logs
+*.log
+npm-debug.log*
+
+# OS
+.DS_Store
+

docs/app/[[...mdxPath]]/page.tsx

@@ -0,0 +1,23 @@
+import { useMDXComponents } from 'nextra-theme-docs';
+import { generateStaticParamsFor, importPage } from 'nextra/pages';
+
+export const generateStaticParams = generateStaticParamsFor('mdxPath');
+
+export async function generateMetadata(props: { params: Promise<{ mdxPath?: string[] }> }) {
+  const params = await props.params;
+  const { metadata } = await importPage(params.mdxPath);
+  return metadata;
+}
+
+export default async function Page(props: { params: Promise<{ mdxPath?: string[] }> }) {
+  const params = await props.params;
+  const result = await importPage(params.mdxPath);
+  const { default: MDXContent, ...rest } = result;
+  const { wrapper: Wrapper } = useMDXComponents();
+
+  return (
+    <Wrapper {...rest}>
+      <MDXContent />
+    </Wrapper>
+  );
+}

docs/app/globals.css

@@ -0,0 +1,4 @@
+:root {
+  --nextra-primary-hue: 263deg;
+  --nextra-primary-saturation: 70%;
+}

docs/app/layout.tsx

@@ -0,0 +1,44 @@
+import { Footer, Layout, Navbar } from 'nextra-theme-docs';
+import { Head } from 'nextra/components';
+import { getPageMap } from 'nextra/page-map';
+import 'nextra-theme-docs/style.css';
+import './globals.css';
+
+export const metadata = {
+  title: {
+    default: 'Auth HI!',
+    template: '%s | Auth HI!',
+  },
+  description:
+    'Chrome extension for injecting authentication headers into requests. Say hi to hassle-free auth headers.',
+};
+
+const logo = (
+  <span style={{ fontWeight: 'bold' }}>
+    <span style={{ color: '#7c3aed' }}>Auth</span> <span style={{ color: '#10b981' }}>HI!</span>
+  </span>
+);
+
+export default async function RootLayout({ children }: { children: React.ReactNode }) {
+  const pageMap = await getPageMap();
+
+  return (
+    <html lang="en" dir="ltr" suppressHydrationWarning>
+      <Head faviconGlyph="🔐" />
+      <body>
+        <Layout
+          pageMap={pageMap}
+          docsRepositoryBase="https://github.com/prosdevlab/auth-header-injector/tree/main/docs/content"
+          editLink="Edit this page on GitHub"
+          sidebar={{ defaultMenuCollapseLevel: 1 }}
+          navbar={
+            <Navbar logo={logo} projectLink="https://github.com/prosdevlab/auth-header-injector" />
+          }
+          footer={<Footer>MIT {new Date().getFullYear()} © prosdevlab</Footer>}
+        >
+          {children}
+        </Layout>
+      </body>
+    </html>
+  );
+}

docs/content/_meta.js

@@ -0,0 +1,7 @@
+export default {
+  index: 'Home',
+  'getting-started': 'Getting Started',
+  guide: 'Guide',
+  privacy: 'Privacy Policy',
+  support: 'Support',
+};

docs/content/getting-started.mdx

@@ -0,0 +1,82 @@
+# Getting Started
+
+Get up and running with Auth HI! in minutes.
+
+## Installation
+
+### From Chrome Web Store
+
+> 🚀 **Coming Soon** - Extension is currently in review
+
+Once published, click "Add to Chrome" from the Chrome Web Store listing.
+
+### From Source
+
+If you want to build from source or contribute:
+
+```bash
+# Clone the repository
+git clone https://github.com/prosdevlab/auth-header-injector.git
+cd auth-header-injector
+
+# Install dependencies
+pnpm install
+
+# Build the extension
+pnpm build
+
+# Load in Chrome
+# 1. Open chrome://extensions/
+# 2. Enable "Developer mode"
+# 3. Click "Load unpacked"
+# 4. Select the `dist` folder
+```
+
+## First Steps
+
+### 1. Open the Side Panel
+
+Click the extension icon in your Chrome toolbar. The side panel will open on the right side of your browser.
+
+### 2. Enable the Extension
+
+Toggle the "Enable extension" switch at the top of the panel.
+
+### 3. Add Your First Rule
+
+Click "Add Rule" and fill in:
+
+- **Pattern**: URL pattern to match (e.g., `*.api.example.com`)
+- **Token**: Your Bearer token (just the token, not "Bearer ...")
+- **Label**: Optional friendly name (e.g., "Staging API")
+
+Click "Save" and you're done!
+
+### 4. Verify It's Working
+
+1. Navigate to a page that makes API calls matching your pattern
+2. Check the "Context Bar" at the top - it shows matched rules
+3. See request counts increase as API calls are intercepted
+4. Open DevTools → Network tab → Check request headers
+
+## Example: GitHub API
+
+Let's set up auth for GitHub's API:
+
+**Pattern**: `*github.com`  
+**Token**: `ghp_yourPersonalAccessToken`  
+**Label**: `GitHub API`
+
+Now any requests to `github.com` or `api.github.com` will include your auth token automatically!
+
+## Next Steps
+
+- Learn about [URL Pattern Matching](/guide/patterns)
+- Explore [Common Use Cases](/guide/examples)
+- Check out [Troubleshooting](/guide/troubleshooting) if something's not working
+
+## Need Help?
+
+- [GitHub Issues](https://github.com/prosdevlab/auth-header-injector/issues) - Report bugs
+- [GitHub Discussions](https://github.com/prosdevlab/auth-header-injector/discussions) - Ask questions
+