Next.js Supabase V3 (#463)

Version 3 of the kit:
- Radix UI replaced with Base UI (using the Shadcn UI patterns)
- next-intl replaces react-i18next
- enhanceAction deprecated; usage moved to next-safe-action
- main layout now wrapped with [locale] path segment
- Teams only mode
- Layout updates
- Zod v4
- Next.js 16.2
- Typescript 6
- All other dependencies updated
- Removed deprecated Edge CSRF
- Dynamic Github Action runner

packages/analytics/AGENTS.md

@@ -1,105 +1,12 @@
-# @kit/analytics Package
+# @kit/analytics
 
-Analytics package providing a unified interface for tracking events, page views, and user identification across multiple analytics providers.
+## Non-Negotiables
 
-## Architecture
+1. Client: `import { analytics } from '@kit/analytics'` / Server: `import { analytics } from '@kit/analytics/server'`
+2. NEVER track PII (emails, names, IPs) in event properties
+3. NEVER manually call `trackPageView` or `identify` — the analytics provider plugin handles these automatically
+4. NEVER create custom providers without implementing the full `AnalyticsService` interface
 
-- **AnalyticsManager**: Central manager orchestrating multiple analytics providers
-- **AnalyticsService**: Interface defining analytics operations (track, identify, pageView)
-- **Provider System**: Pluggable providers (currently includes NullAnalyticsService)
-- **Client/Server Split**: Separate entry points for client and server-side usage
+## Exemplar
 
-## Usage
-
-### Basic Import
-
-```typescript
-// Client-side
-import { analytics } from '@kit/analytics';
-
-// Server-side
-import { analytics } from '@kit/analytics/server';
-```
-
-### Core Methods
-
-```typescript
-// Track events
-await analytics.trackEvent('button_clicked', { 
-  button_id: 'signup',
-  page: 'homepage' 
-});
-
-// Track page views
-await analytics.trackPageView('/dashboard');
-
-// Identify users
-await analytics.identify('user123', { 
-  email: 'user@example.com',
-  plan: 'premium' 
-});
-```
-
-Page views and user identification are handled by the plugin by default.
-
-## Creating Custom Providers
-
-Implement the `AnalyticsService` interface:
-
-```typescript
-import { AnalyticsService } from '@kit/analytics';
-
-class CustomAnalyticsService implements AnalyticsService {
-  async initialize(): Promise<void> {
-    // Initialize your analytics service
-  }
-
-  async trackEvent(name: string, properties?: Record<string, string | string[]>): Promise<void> {
-    // Track event implementation
-  }
-
-  async trackPageView(path: string): Promise<void> {
-    // Track page view implementation
-  }
-
-  async identify(userId: string, traits?: Record<string, string>): Promise<void> {
-    // Identify user implementation
-  }
-}
-```
-
-## Default Behavior
-
-- Uses `NullAnalyticsService` when no providers are active
-- All methods return Promises that resolve to arrays of provider results
-- Console debug logging when no active services or using null service
-- Graceful error handling with console warnings for missing providers
-
-## Server-Side Analytics
-
-When using PostHog, you can track events server-side for better reliability and privacy:
-
-```typescript
-import { analytics } from '@kit/analytics/server';
-
-// Server-side event tracking (e.g., in API routes)
-export async function POST(request: Request) {
-  // ... handle request
-  
-  // Track server-side events
-  await analytics.trackEvent('api_call', {
-    endpoint: '/api/users',
-    method: 'POST',
-    user_id: userId,
-  });
-  
-  return Response.json({ success: true });
-}
-
-// Track user registration server-side
-await analytics.identify(user.id, {
-  email: user.email,
-  created_at: user.created_at,
-  plan: user.plan,
-});
-```
+- `apps/web/components/analytics-provider.tsx` — provider setup with plugin registration

packages/analytics/eslint.config.mjs

@@ -1,3 +0,0 @@
-import eslintConfigBase from '@kit/eslint-config/base.js';
-
-export default eslintConfigBase;

packages/analytics/package.json

@@ -1,29 +1,24 @@
 {
   "name": "@kit/analytics",
-  "private": true,
   "version": "0.1.0",
-  "scripts": {
-    "clean": "git clean -xdf .turbo node_modules",
-    "format": "prettier --check \"**/*.{ts,tsx}\"",
-    "lint": "eslint .",
-    "typecheck": "tsc --noEmit"
-  },
-  "prettier": "@kit/prettier-config",
-  "exports": {
-    ".": "./src/index.ts",
-    "./server": "./src/server.ts"
-  },
-  "devDependencies": {
-    "@kit/eslint-config": "workspace:*",
-    "@kit/prettier-config": "workspace:*",
-    "@kit/tsconfig": "workspace:*",
-    "@types/node": "catalog:"
-  },
+  "private": true,
   "typesVersions": {
     "*": {
       "*": [
         "src/*"
       ]
     }
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./server": "./src/server.ts"
+  },
+  "scripts": {
+    "clean": "git clean -xdf .turbo node_modules",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@kit/tsconfig": "workspace:*",
+    "@types/node": "catalog:"
   }
 }

packages/analytics/src/server.ts

@@ -1,5 +1,4 @@
 import 'server-only';
-
 import { createAnalyticsManager } from './analytics-manager';
 import { NullAnalyticsService } from './null-analytics-service';
 import type { AnalyticsManager } from './types';