docs: simplify readme

Author: rmarsigli

README.md

@@ -98,312 +98,6 @@ NEXT_PUBLIC_GA_ID=G-XXXXXXXXXX
 NEXT_PUBLIC_PLAUSIBLE_DOMAIN=your-site.com
 ```
 
-### 3. Run Development Server
-
-```bash
-pnpm dev
-```
-
-Visit [http://localhost:3000](http://localhost:3000)
-
-### 4. Build for Production
-
-```bash
-pnpm build
-pnpm start
-```
-
-## On-Demand Revalidation Setup
-
-Rush CMS can automatically invalidate Next.js cache when content is updated.
-
-### Step 1: Generate Revalidation Secret
-
-```bash
-# Generate a secure random key
-openssl rand -hex 32
-```
-
-Add to your `.env`:
-
-```env
-REVALIDATE_SECRET=your-generated-secret-here
-```
-
-### Step 2: Configure Webhook in Rush CMS
-
-In your Rush CMS installation, configure the webhook:
-
-**URL Format:**
-```
-https://your-nextjs-site.com/api/revalidate
-```
-
-**Method:** `POST`
-
-**Headers:**
-```
-Content-Type: application/json
-```
-
-**Payload Example (Path Revalidation):**
-```json
-{
-  "secret": "your-revalidation-secret",
-  "path": "/blog/my-post-slug"
-}
-```
-
-**Payload Example (Tag Revalidation):**
-```json
-{
-  "secret": "your-revalidation-secret",
-  "tag": "blog-posts"
-}
-```
-
-### Step 3: Test Revalidation
-
-Test manually with curl:
-
-```bash
-curl -X POST https://your-site.com/api/revalidate \
-  -H "Content-Type: application/json" \
-  -d '{
-    "secret": "your-secret",
-    "path": "/"
-  }'
-```
-
-**Expected Response:**
-```json
-{
-  "success": true,
-  "message": "Revalidation triggered successfully",
-  "revalidated": {
-    "path": "/",
-    "tag": null
-  },
-  "timestamp": "2025-11-12T10:30:00.000Z"
-}
-```
-
-### Rush CMS Observer Implementation
-
-Add this observer to your Rush CMS Laravel application:
-
-```php
-<?php
-
-namespace App\Observers;
-
-use App\Models\Entry;
-use Illuminate\Support\Facades\Http;
-
-class EntryObserver
-{
-    public function updated(Entry $entry): void
-    {
-        $this->revalidateNextjs($entry);
-    }
-
-    public function deleted(Entry $entry): void
-    {
-        $this->revalidateNextjs($entry);
-    }
-
-    protected function revalidateNextjs(Entry $entry): void
-    {
-        $nextjsUrl = config('services.nextjs.url');
-        $secret = config('services.nextjs.revalidate_secret');
-
-        if (!$nextjsUrl || !$secret) {
-            return;
-        }
-
-        // Determine path based on collection
-        $path = match($entry->collection->slug) {
-            'blog' => "/blog/{$entry->slug}",
-            'pages' => "/{$entry->slug}",
-            default => null,
-        };
-
-        if ($path) {
-            Http::post("{$nextjsUrl}/api/revalidate", [
-                'secret' => $secret,
-                'path' => $path,
-            ]);
-
-            // Also revalidate listing pages
-            if ($entry->collection->slug === 'blog') {
-                Http::post("{$nextjsUrl}/api/revalidate", [
-                    'secret' => $secret,
-                    'path' => '/blog',
-                ]);
-            }
-        }
-    }
-}
-```
-
-Register the observer in `AppServiceProvider`:
-
-```php
-use App\Models\Entry;
-use App\Observers\EntryObserver;
-
-public function boot(): void
-{
-    Entry::observe(EntryObserver::class);
-}
-```
-
-Add to `config/services.php`:
-
-```php
-'nextjs' => [
-    'url' => env('NEXTJS_URL', 'https://your-nextjs-site.com'),
-    'revalidate_secret' => env('NEXTJS_REVALIDATE_SECRET'),
-],
-```
-
-## Analytics Setup
-
-### Google Analytics 4
-
-1. Create a GA4 property in Google Analytics
-2. Get your Measurement ID (format: `G-XXXXXXXXXX`)
-3. Add to `.env`:
-
-```env
-NEXT_PUBLIC_GA_ID=G-XXXXXXXXXX
-```
-
-### Plausible Analytics
-
-1. Sign up at [plausible.io](https://plausible.io)
-2. Add your domain
-3. Add to `.env`:
-
-```env
-NEXT_PUBLIC_PLAUSIBLE_DOMAIN=your-site.com
-```
-
-### Custom Event Tracking
-
-Use the analytics helpers in your code:
-
-```typescript
-import { trackEvent, trackFormSubmit, trackSearch } from '@/lib/analytics'
-
-// Track custom events
-trackEvent('button_click', { button_name: 'subscribe' })
-
-// Track form submissions
-trackFormSubmit('contact_form', true)
-
-// Track search queries
-trackSearch('next.js tutorial', 42)
-```
-
-## Project Structure
-
-```
-src/
-├── app/
-│   ├── api/
-│   │   └── revalidate/
-│   │       └── route.ts          # Revalidation webhook endpoint
-│   ├── blog/
-│   │   ├── [slug]/
-│   │   │   ├── page.tsx          # Blog post detail
-│   │   │   └── error.tsx         # Blog post error boundary
-│   │   ├── page.tsx              # Blog listing with search
-│   │   └── error.tsx             # Blog error boundary
-│   ├── [slug]/
-│   │   └── page.tsx              # Dynamic pages
-│   ├── contact/
-│   │   └── page.tsx              # Contact form
-│   ├── error.tsx                 # Global error boundary
-│   ├── loading.tsx               # Global loading state
-│   ├── not-found.tsx             # 404 page
-│   ├── page.tsx                  # Homepage
-│   ├── layout.tsx                # Root layout
-│   ├── globals.css               # Global styles
-│   ├── sitemap.ts                # Dynamic sitemap
-│   └── robots.ts                 # Robots.txt
-├── components/
-│   ├── analytics/
-│   │   └── analytics-script.tsx  # Analytics integration
-│   ├── blog/
-│   │   └── blog-listing.tsx      # Blog listing with search & pagination
-│   ├── breadcrumbs/
-│   │   └── breadcrumbs.tsx       # Breadcrumb navigation
-│   ├── loading/
-│   │   ├── skeleton.tsx          # Base skeleton loader
-│   │   ├── blog-post-skeleton.tsx # Blog post skeleton
-│   │   ├── card-skeleton.tsx     # Card skeleton
-│   │   └── form-skeleton.tsx     # Form skeleton
-│   ├── pagination/
-│   │   └── pagination.tsx        # Pagination component
-│   ├── rush/
-│   │   ├── article.tsx           # Blog post renderer
-│   │   ├── article-content.tsx   # Article content with TOC
-│   │   ├── block-editor-renderer.tsx  # Block editor
-│   │   ├── entry-renderer.tsx    # Generic entry renderer
-│   │   └── form-builder.tsx      # Dynamic forms
-│   ├── search/
-│   │   ├── blog-search.tsx       # Generic search wrapper
-│   │   ├── search-input.tsx      # Search input with debounce
-│   │   └── search-results.tsx    # Search results display
-│   ├── share/
-│   │   └── share-buttons.tsx     # Social media share buttons
-│   ├── structured-data/
-│   │   └── entry-schema.tsx      # JSON-LD structured data
-│   ├── toc/
-│   │   └── table-of-contents.tsx # Table of contents
-│   ├── ui/
-│   │   ├── alert.tsx             # Alert component
-│   │   ├── badge.tsx             # Badge component
-│   │   ├── button.tsx            # Button component
-│   │   ├── card.tsx              # Card component
-│   │   ├── input.tsx             # Input component
-│   │   ├── label.tsx             # Label component
-│   │   ├── optimized-image.tsx   # Optimized image wrapper
-│   │   ├── select.tsx            # Select component
-│   │   └── textarea.tsx          # Textarea component
-│   ├── blog-card.tsx             # Blog card component
-│   └── navigation.tsx            # Main navigation
-├── lib/
-│   ├── analytics.ts              # Analytics helpers
-│   ├── config.ts                 # Centralized config
-│   ├── date.ts                   # Date formatting
-│   ├── logger.ts                 # Structured logging
-│   ├── metadata.ts               # SEO metadata helpers
-│   ├── rush-cms.ts               # API client
-│   ├── sanitize.ts               # HTML sanitization
-│   └── utils.ts                  # Utility functions
-└── types/
-    ├── analytics.d.ts            # Analytics types
-    └── rush-cms.ts               # TypeScript types
-```
-
-## Available Scripts
-
-```bash
-# Development
-pnpm dev          # Start dev server (localhost:3000)
-pnpm type-check   # Run TypeScript compiler check
-pnpm lint         # Run ESLint
-
-# Production
-pnpm build        # Build for production
-pnpm start        # Start production server
-
-# Deployment
-pnpm deploy       # Deploy to configured platform
-```
-
 ## Type Safety
 
 This starter uses strict TypeScript with no `any` types:
@@ -428,8 +122,6 @@ See [DEPLOYMENT.md](./DEPLOYMENT.md) for comprehensive deployment guides for:
 - **Webhooks** - On-demand revalidation setup
 - **Troubleshooting** - Common deployment issues
 
-### Quick Deploy
-
 #### Vercel (Recommended)
 
 [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone)
@@ -452,71 +144,4 @@ pnpm i -g netlify-cli
 
 # Deploy
 netlify deploy --prod
-```
-
-## Troubleshooting
-
-### Issue: API requests failing
-
-**Check:**
-- `NEXT_PUBLIC_API_URL` is correct (no trailing slash)
-- `API_TOKEN` is valid (regenerate in Rush CMS if needed)
-- Rush CMS CORS settings allow your Next.js domain
-
-### Issue: Images not loading
-
-**Check:**
-- `NEXT_PUBLIC_S3_URL` matches your media storage URL
-- Add S3 domain to `next.config.js`:
-
-```js
-images: {
-  domains: ['your-bucket.s3.amazonaws.com']
-}
-```
-
-### Issue: Revalidation not working
-
-**Check:**
-- `REVALIDATE_SECRET` matches in both `.env` and Rush CMS webhook
-- Webhook URL is correct (https://your-site.com/api/revalidate)
-- Check Next.js logs for revalidation messages
-
-### Issue: Analytics not tracking
-
-**Check:**
-- Analytics only loads in production (`NODE_ENV=production`)
-- Environment variables use `NEXT_PUBLIC_` prefix
-- Check browser console for errors (ad blockers may interfere)
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit using conventional commits (`feat:`, `fix:`, `docs:`, etc.)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
-
-## Code Style
-
-This project follows strict code guidelines (see `CLAUDE.md`):
-
-- Single quotes (`'`) not double quotes
-- Tabs (size 4) for indentation
-- No semicolons
-- Kebab-case file names (`blog-card.tsx`)
-- Mobile-first approach
-
-## License
-
-MIT
-
-## Support
-
-- **Rush CMS Documentation**: [https://docs.rushcms.com](https://docs.rushcms.com)
-- **Issues**: [GitHub Issues](https://github.com/your-org/rush-cms-nextjs-starter/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/your-org/rush-cms-nextjs-starter/discussions)
-
----
-
-Built with ❤️ using [Rush CMS](https://rushcms.com) and [Next.js](https://nextjs.org)
+```