Fix: Google button hover text visibility

- Add btn-outline CSS class with explicit hover state
- Button outline variant now properly shows cream text on hover
- Add text-cream utility class

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.env.example

@@ -0,0 +1,7 @@
+# Supabase Configuration
+NEXT_PUBLIC_SUPABASE_URL=your-project-url
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
+SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
+
+# App Configuration
+NEXT_PUBLIC_APP_URL=http://localhost:3000

.gitattributes

@@ -0,0 +1,24 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Force LF for scripts (importante per VPS Linux)
+*.sh text eol=lf
+*.bash text eol=lf
+deploy.sh text eol=lf
+
+# Force LF for config files
+*.yml text eol=lf
+*.yaml text eol=lf
+*.json text eol=lf
+*.md text eol=lf
+
+# Binary files
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.woff binary
+*.woff2 binary
+*.ttf binary
+*.eot binary

.gitignore

@@ -0,0 +1,39 @@
+# Dependencies
+node_modules/
+__pycache__/
+*.pyc
+venv/
+.venv/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Build
+.next/
+dist/
+build/
+out/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+
+# Data (local dev)
+data/
+*.db
+*.sqlite
+
+# GSD Planning (opzionale - può essere committato)
+# .planning/

.planning/REQUIREMENTS.md

@@ -9,9 +9,9 @@ Requirements per il rilascio iniziale. Ogni requirement mappa a fasi della roadm
 
 ### Authentication
 
-- [ ] **AUTH-01**: Utente può registrarsi con email/password
+- [x] **AUTH-01**: Utente può registrarsi con email/password
-- [ ] **AUTH-02**: Utente può accedere con Google OAuth
+- [x] **AUTH-02**: Utente può accedere con Google OAuth
-- [ ] **AUTH-03**: Sistema supporta 3 piani (Free, Creator, Pro) con limiti configurabili
+- [x] **AUTH-03**: Sistema supporta 3 piani (Free, Creator, Pro) con limiti configurabili
 - [ ] **AUTH-04**: Utente può collegare account Facebook tramite OAuth
 
 ### Onboarding
@@ -94,9 +94,9 @@ Quali fasi coprono quali requirements. Aggiornato durante creazione roadmap.
 
 | Requirement | Phase | Status |
 |-------------|-------|--------|
-| AUTH-01 | Phase 1 | Pending |
+| AUTH-01 | Phase 1 | Complete |
-| AUTH-02 | Phase 1 | Pending |
+| AUTH-02 | Phase 1 | Complete |
-| AUTH-03 | Phase 1 | Pending |
+| AUTH-03 | Phase 1 | Complete |
 | AUTH-04 | Phase 2 | Pending |
 | ONBR-01 | Phase 3 | Pending |
 | ONBR-02 | Phase 3 | Pending |

.planning/REQUIREMENTS.md.bak

@@ -0,0 +1,124 @@
+# Requirements: Leopost
+
+**Defined:** 2026-01-30
+**Core Value:** L'AI fa il lavoro sporco del social media manager — minimo sforzo, massima resa
+
+## v1 Requirements
+
+Requirements per il rilascio iniziale. Ogni requirement mappa a fasi della roadmap.
+
+### Authentication
+
+- [ ] **AUTH-01**: Utente può registrarsi con email/password
+- [ ] **AUTH-02**: Utente può accedere con Google OAuth
+- [ ] **AUTH-03**: Sistema supporta 3 piani (Free, Creator, Pro) con limiti configurabili
+- [ ] **AUTH-04**: Utente può collegare account Facebook tramite OAuth
+
+### Onboarding
+
+- [ ] **ONBR-01**: Wizard raccoglie info base (nome attività, settore, descrizione)
+- [ ] **ONBR-02**: Contesto utente persiste tra sessioni (memoria)
+
+### AI Chat
+
+- [ ] **CHAT-01**: Interfaccia chat come esperienza principale dell'app
+- [ ] **CHAT-02**: Utente può scegliere modello AI (GPT, Claude, Gemini)
+- [ ] **CHAT-03**: AI propone azioni suggerite dopo completamento onboarding
+- [ ] **CHAT-04**: AI memorizza e impara preferenze utente nel tempo
+
+### Content Generation
+
+- [ ] **CONT-01**: AI genera post testuali su richiesta dell'utente
+- [ ] **CONT-02**: AI genera immagini per i post
+- [ ] **CONT-03**: AI crea piano editoriale (calendario contenuti suggeriti)
+
+### Scheduling & Publishing
+
+- [ ] **SCHD-01**: Utente può programmare post con data/ora specifica
+- [ ] **SCHD-02**: Post vengono pubblicati automaticamente su Facebook
+- [ ] **SCHD-03**: Utente può configurare livello automazione (da approval a autopilot)
+- [ ] **SCHD-04**: Calendario editoriale visuale mostra post programmati
+
+### Messaging Integration
+
+- [ ] **MSGN-01**: Utente può inviare comandi via Telegram bot
+- [ ] **MSGN-02**: Utente può inviare comandi via WhatsApp bot
+
+## v2 Requirements
+
+Deferred per release future. Tracciati ma non nella roadmap corrente.
+
+### Authentication
+
+- **AUTH-05**: Utente può accedere con Facebook OAuth
+- **AUTH-06**: Utente può accedere con LinkedIn OAuth
+- **AUTH-07**: Utente può accedere con Instagram OAuth
+
+### Social Platforms
+
+- **SOCL-01**: Utente può collegare e pubblicare su Instagram
+- **SOCL-02**: Utente può collegare e pubblicare su LinkedIn
+- **SOCL-03**: Utente può collegare e pubblicare su YouTube
+- **SOCL-04**: Utente può collegare e pubblicare su TikTok
+- **SOCL-05**: Utente può collegare e pubblicare su X (Twitter)
+
+### Onboarding Extended
+
+- **ONBR-03**: Wizard raccoglie brand kit (logo, colori, font)
+- **ONBR-04**: Wizard raccoglie siti web e link
+- **ONBR-05**: Wizard raccoglie target audience e zona geografica
+
+### Content Generation Extended
+
+- **CONT-04**: AI adatta tono/lunghezza/hashtag per piattaforma specifica
+- **CONT-05**: Utente può fornire template grafici come base
+- **CONT-06**: AI genera video (oltre a immagini)
+
+## Out of Scope
+
+Esclusi esplicitamente. Documentati per prevenire scope creep.
+
+| Feature | Reason |
+|---------|--------|
+| App native iOS/Android | Architettura headless pronta, ma web-first per v1 |
+| Dashboard analytics avanzate | Focus su creazione/pubblicazione, non analytics |
+| Social listening | Complessità elevata, non core per freelance |
+| Influencer marketplace | Fuori target (freelance, non brand) |
+| White-label | Enterprise feature, non micro-SaaS |
+| Video editing integrato | Complessità, costi storage/bandwidth |
+| Gestione ads/campagne | Fuori scope, focus su contenuti organici |
+
+## Traceability
+
+Quali fasi coprono quali requirements. Aggiornato durante creazione roadmap.
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| AUTH-01 | TBD | Pending |
+| AUTH-02 | TBD | Pending |
+| AUTH-03 | TBD | Pending |
+| AUTH-04 | TBD | Pending |
+| ONBR-01 | TBD | Pending |
+| ONBR-02 | TBD | Pending |
+| CHAT-01 | TBD | Pending |
+| CHAT-02 | TBD | Pending |
+| CHAT-03 | TBD | Pending |
+| CHAT-04 | TBD | Pending |
+| CONT-01 | TBD | Pending |
+| CONT-02 | TBD | Pending |
+| CONT-03 | TBD | Pending |
+| SCHD-01 | TBD | Pending |
+| SCHD-02 | TBD | Pending |
+| SCHD-03 | TBD | Pending |
+| SCHD-04 | TBD | Pending |
+| MSGN-01 | TBD | Pending |
+| MSGN-02 | TBD | Pending |
+
+**Coverage:**
+- v1 requirements: 19 total
+- Mapped to phases: 0
+- Unmapped: 19 ⚠️
+
+---
+*Requirements defined: 2026-01-30*
+*Last updated: 2026-01-30 after initial definition*

.planning/ROADMAP.md

@@ -12,7 +12,7 @@ Leopost viene costruito in 10 fasi incrementali che portano da zero a un micro-S
 
 Decimal phases appear between their surrounding integers in numeric order.
 
-- [ ] **Phase 1: Foundation & Auth** - User accounts, plans, multi-tenant database
+- [x] **Phase 1: Foundation & Auth** - User accounts, plans, multi-tenant database
 - [ ] **Phase 2: Social Platform Integration** - Facebook OAuth, Graph API setup
 - [ ] **Phase 3: Onboarding & Context** - Brand context capture, persistent memory
 - [ ] **Phase 4: AI Chat Interface** - Chat UI, multi-model support, conversation management
@@ -35,10 +35,15 @@ Decimal phases appear between their surrounding integers in numeric order.
   3. User can view and switch between Free, Creator, and Pro plans
   4. System enforces plan-specific limits (configured in database, enforced in API)
   5. All data is isolated per tenant (RLS active, no cross-tenant leakage)
-**Plans**: TBD
+**Plans**: 6 plans in 4 waves
 
 Plans:
-- [ ] TBD during plan-phase
+- [x] 01-01-PLAN.md — Project setup (Next.js + Supabase clients)
+- [x] 01-02-PLAN.md — Database schema (plans, profiles, RLS)
+- [x] 01-03-PLAN.md — Email/password auth flow
+- [x] 01-04-PLAN.md — Google OAuth integration
+- [x] 01-05-PLAN.md — Middleware & route protection
+- [x] 01-06-PLAN.md — Subscription management UI
 
 ### Phase 2: Social Platform Integration
 **Goal**: Users can securely connect their Facebook account for publishing
@@ -50,10 +55,9 @@ Plans:
   3. User can view connected Facebook pages and select target page
   4. System handles token expiration gracefully (refresh before publish)
   5. API rate limits are monitored and logged (dashboard shows remaining quota)
-**Plans**: TBD
+**Plans**: 6 plans in 4 waves
 
 Plans:
-- [ ] TBD during plan-phase
 
 ### Phase 3: Onboarding & Context
 **Goal**: New users provide brand context that AI uses for personalized content
@@ -65,10 +69,9 @@ Plans:
   3. Brand context persists in database and loads in future sessions
   4. User can update brand info anytime via settings page
   5. AI prompts automatically inject brand context (verified in logs)
-**Plans**: TBD
+**Plans**: 6 plans in 4 waves
 
 Plans:
-- [ ] TBD during plan-phase
 
 ### Phase 4: AI Chat Interface
 **Goal**: Users interact with AI assistant to create content via natural conversation
@@ -80,10 +83,9 @@ Plans:
   3. User can choose AI model (GPT, Claude, Gemini) in settings
   4. AI suggests 3-5 initial actions after onboarding (e.g., "Create first post")
   5. Conversation history persists (user can scroll back, AI remembers context)
-**Plans**: TBD
+**Plans**: 6 plans in 4 waves
 
 Plans:
-- [ ] TBD during plan-phase
 
 ### Phase 5: Content Generation
 **Goal**: AI generates quality text posts and images adapted to brand voice
@@ -95,10 +97,9 @@ Plans:
   3. User asks "Add image" and receives AI-generated image in < 30 seconds
   4. User can regenerate content with feedback ("Make it more casual")
   5. Generated content displays in chat with edit capability
-**Plans**: TBD
+**Plans**: 6 plans in 4 waves
 
 Plans:
-- [ ] TBD during plan-phase
 
 ### Phase 6: Scheduling Foundation
 **Goal**: Users reliably schedule posts and they publish automatically at specified time
@@ -110,10 +111,9 @@ Plans:
   3. User receives notification when post is published (or if it fails)
   4. Job queue handles retries with exponential backoff (API failures don't lose posts)
   5. Timezone is handled correctly (user sees local time, system schedules in UTC)
-**Plans**: TBD
+**Plans**: 6 plans in 4 waves
 
 Plans:
-- [ ] TBD during plan-phase
 
 ### Phase 7: Automation & Calendar
 **Goal**: Users configure automation level and visualize scheduled posts in calendar
@@ -125,10 +125,9 @@ Plans:
   3. In Autopilot mode, AI generates and publishes without user action
   4. Calendar view shows all scheduled posts (color-coded by platform)
   5. User can drag-and-drop posts to reschedule in calendar
-**Plans**: TBD
+**Plans**: 6 plans in 4 waves
 
 Plans:
-- [ ] TBD during plan-phase
 
 ### Phase 8: AI Learning
 **Goal**: AI improves content quality over time by learning user's authentic voice
@@ -140,10 +139,9 @@ Plans:
   3. Future posts incorporate learned preferences (measurably more "on brand")
   4. User sees improvement notification ("AI learned from 10 approved posts")
   5. Learning data is per-tenant (AI doesn't leak patterns across users)
-**Plans**: TBD
+**Plans**: 6 plans in 4 waves
 
 Plans:
-- [ ] TBD during plan-phase
 
 ### Phase 9: Editorial Planning
 **Goal**: AI proactively creates multi-week content calendar aligned to business goals
@@ -155,10 +153,9 @@ Plans:
   3. User can accept entire plan or edit individual posts
   4. Accepted plan populates calendar with draft posts (ready to review/publish)
   5. AI considers business context (sector trends, user's past successful posts)
-**Plans**: TBD
+**Plans**: 6 plans in 4 waves
 
 Plans:
-- [ ] TBD during plan-phase
 
 ### Phase 10: Messaging Integration
 **Goal**: Users can create and schedule posts via Telegram or WhatsApp commands
@@ -170,10 +167,9 @@ Plans:
   3. User connects WhatsApp bot (Business API verified) with same functionality
   4. Both bots support voice messages (transcribed to text, processed by AI)
   5. Posts created via messaging appear in web calendar (sync across channels)
-**Plans**: TBD
+**Plans**: 6 plans in 4 waves
 
 Plans:
-- [ ] TBD during plan-phase
 
 ## Progress
 
@@ -182,7 +178,7 @@ Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6 → 7 → 8 →
 
 | Phase | Plans Complete | Status | Completed |
 |-------|----------------|--------|-----------|
-| 1. Foundation & Auth | 0/TBD | Not started | - |
+| 1. Foundation & Auth | 6/6 | ✓ Complete | 2026-01-31 |
 | 2. Social Platform Integration | 0/TBD | Not started | - |
 | 3. Onboarding & Context | 0/TBD | Not started | - |
 | 4. AI Chat Interface | 0/TBD | Not started | - |

.planning/STATE.md

@@ -5,33 +5,33 @@
 See: .planning/PROJECT.md (updated 2026-01-30)
 
 **Core value:** L'AI fa il lavoro sporco del social media manager — minimo sforzo, massima resa
-**Current focus:** Phase 1 - Foundation & Auth
+**Current focus:** Phase 1 - Foundation & Auth COMPLETE
 
 ## Current Position
 
-Phase: 1 of 10 (Foundation & Auth)
+Phase: 1 of 10 (Foundation & Auth - COMPLETE)
-Plan: 0 of TBD (planning not started)
+Plan: 6 of 6 (Subscription Management - COMPLETE)
-Status: Ready to plan
+Status: Phase 1 complete
-Last activity: 2026-01-31 — Roadmap created with 10 phases, 100% requirement coverage
+Last activity: 2026-01-31 — Completed 01-06-PLAN.md (Subscription Management)
 
-Progress: [░░░░░░░░░░] 0%
+Progress: [██████████░░░░░░░░░░] ~10% (6/~60 plans estimated)
 
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 0
+- Total plans completed: 6
-- Average duration: N/A
+- Average duration: 5min
-- Total execution time: 0.0 hours
+- Total execution time: 0.5 hours
 
 **By Phase:**
 
 | Phase | Plans | Total | Avg/Plan |
 |-------|-------|-------|----------|
-| - | - | - | - |
+| 01-foundation-auth | 6 | 30min | 5min |
 
 **Recent Trend:**
-- Last 5 plans: N/A
+- Last 5 plans: 01-02 (5min), 01-04 (4min), 01-05 (5min), 01-06 (3min)
-- Trend: N/A
+- Trend: Improving (faster execution)
 
 *Updated after each plan completion*
 
@@ -47,6 +47,17 @@ Recent decisions affecting current work:
 - Initial: Onboarding progressivo (Evita abbandono per "troppo da fare" al primo accesso)
 - Initial: Automazione configurabile (Costruisce fiducia gradualmente, dall'approval all'autopilot)
 - Initial: Headless architecture (Prepara per app native senza riscrivere logica)
+- 01-01: Used @supabase/ssr instead of deprecated auth-helpers-nextjs
+- 01-01: Async cookies() pattern for Next.js 15+ Server Components
+- 01-01: Placeholder env values - real Supabase project created at deploy time
+- 01-04: Google button above email form (faster option first)
+- 01-04: Created full auth pages in parallel plan execution
+- 01-05: Middleware at project root per Next.js convention
+- 01-05: Protected routes array for easy extension
+- 01-05: redirectTo query param for post-login redirect
+- 01-06: Plan switching immediate (payment deferred to later phase)
+- 01-06: Server actions for data mutations with revalidatePath pattern
+- 01-06: Type definitions centralized in src/types/ directory
 
 ### Pending Todos
 
@@ -55,7 +66,6 @@ None yet.
 ### Blockers/Concerns
 
 **Research-identified risks to address early:**
-- Phase 1: Implement RLS multi-tenant isolation from day 1 (no retrofitting)
 - Phase 2: Facebook API rate limits (200 DM/hour) — need exponential backoff + monitoring
 - Phase 5: AI cost management — implement caching, freemium limits, per-user tracking
 - Phase 6: Job queue reliability critical — BullMQ on Redis, not setTimeout
@@ -64,6 +74,6 @@ None yet.
 ## Session Continuity
 
 Last session: 2026-01-31
-Stopped at: Roadmap and STATE.md created, traceability updated
+Stopped at: Completed 01-06-PLAN.md (Subscription Management) - PHASE 1 COMPLETE
 Resume file: None
-Next step: Execute `/gsd:plan-phase 1` to create detailed plans for Foundation & Auth
+Next step: Begin Phase 2 (Social Connections) planning

.planning/phases/01-foundation-auth/01-01-PLAN.md

@@ -0,0 +1,266 @@
+---
+phase: 01-foundation-auth
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified:
+  - package.json
+  - tsconfig.json
+  - next.config.ts
+  - tailwind.config.ts
+  - postcss.config.mjs
+  - .env.local
+  - .env.example
+  - src/lib/supabase/client.ts
+  - src/lib/supabase/server.ts
+  - src/app/layout.tsx
+  - src/app/page.tsx
+  - src/app/globals.css
+autonomous: true
+user_setup:
+  - service: supabase
+    why: "Database and authentication backend"
+    env_vars:
+      - name: NEXT_PUBLIC_SUPABASE_URL
+        source: "Supabase Dashboard -> Project Settings -> API -> Project URL"
+      - name: NEXT_PUBLIC_SUPABASE_ANON_KEY
+        source: "Supabase Dashboard -> Project Settings -> API -> anon public"
+      - name: SUPABASE_SERVICE_ROLE_KEY
+        source: "Supabase Dashboard -> Project Settings -> API -> service_role (secret)"
+
+must_haves:
+  truths:
+    - "Next.js dev server starts without errors"
+    - "Supabase client connects to project"
+    - "Environment variables are loaded correctly"
+  artifacts:
+    - path: "src/lib/supabase/client.ts"
+      provides: "Browser Supabase client for Client Components"
+      exports: ["createClient"]
+    - path: "src/lib/supabase/server.ts"
+      provides: "Server Supabase client for Server Components/Actions"
+      exports: ["createClient"]
+    - path: ".env.local"
+      provides: "Environment configuration"
+      contains: "NEXT_PUBLIC_SUPABASE_URL"
+  key_links:
+    - from: "src/lib/supabase/client.ts"
+      to: ".env.local"
+      via: "process.env.NEXT_PUBLIC_*"
+      pattern: "process\\.env\\.NEXT_PUBLIC_SUPABASE"
+    - from: "src/lib/supabase/server.ts"
+      to: "next/headers cookies()"
+      via: "cookie handling for SSR"
+      pattern: "cookies\\(\\)"
+---
+
+<objective>
+Initialize Next.js 14 project with Supabase client configuration using the official @supabase/ssr package for App Router compatibility.
+
+Purpose: Establish the foundational project structure and Supabase connectivity that all subsequent auth work depends on.
+
+Output: Working Next.js 14 app with properly configured Supabase clients (browser + server) ready for auth implementation.
+</objective>
+
+<execution_context>
+@C:\Users\miche\.claude/get-shit-done/workflows/execute-plan.md
+@C:\Users\miche\.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/phases/01-foundation-auth/01-RESEARCH.md
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Initialize Next.js 14 project with TypeScript and Tailwind</name>
+  <files>
+    package.json
+    tsconfig.json
+    next.config.ts
+    tailwind.config.ts
+    postcss.config.mjs
+    src/app/layout.tsx
+    src/app/page.tsx
+    src/app/globals.css
+  </files>
+  <action>
+    Create Next.js 14 project with App Router:
+
+    ```bash
+    npx create-next-app@latest . --typescript --tailwind --eslint --app --src-dir --import-alias "@/*" --use-npm
+    ```
+
+    If directory not empty, use --force or clean first.
+
+    After init, install Supabase packages:
+    ```bash
+    npm install @supabase/supabase-js @supabase/ssr zod react-hook-form
+    ```
+
+    Update src/app/page.tsx to a simple placeholder:
+    ```tsx
+    export default function Home() {
+      return (
+        <main className="flex min-h-screen flex-col items-center justify-center p-24">
+          <h1 className="text-4xl font-bold">Leopost</h1>
+          <p className="mt-4 text-gray-600">Setup in corso...</p>
+        </main>
+      )
+    }
+    ```
+
+    Ensure next.config.ts uses the new format (not .js):
+    ```typescript
+    import type { NextConfig } from 'next'
+
+    const nextConfig: NextConfig = {
+      // config options here
+    }
+
+    export default nextConfig
+    ```
+  </action>
+  <verify>
+    Run `npm run dev` - server starts on localhost:3000 without errors.
+    Visit http://localhost:3000 - shows Leopost placeholder.
+  </verify>
+  <done>
+    Next.js 14 project initialized with TypeScript, Tailwind, App Router, and Supabase packages installed.
+  </done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Configure environment variables</name>
+  <files>
+    .env.local
+    .env.example
+    .gitignore
+  </files>
+  <action>
+    Create .env.example (committed to git, template for others):
+    ```
+    # Supabase Configuration
+    NEXT_PUBLIC_SUPABASE_URL=your-project-url
+    NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
+    SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
+
+    # App Configuration
+    NEXT_PUBLIC_APP_URL=http://localhost:3000
+    ```
+
+    Create .env.local with actual Supabase credentials:
+    - Get URL from Supabase Dashboard -> Project Settings -> API -> Project URL
+    - Get anon key from Supabase Dashboard -> Project Settings -> API -> anon public
+    - Get service_role key from Supabase Dashboard -> Project Settings -> API -> service_role
+
+    NOTE: If Supabase project doesn't exist yet, create placeholder values and document that user must create project.
+
+    Verify .gitignore includes:
+    ```
+    .env*.local
+    ```
+    (This should already be present from create-next-app)
+  </action>
+  <verify>
+    - .env.example exists and is NOT in .gitignore
+    - .env.local exists and IS gitignored
+    - Run `git status` - .env.local should NOT appear
+  </verify>
+  <done>
+    Environment files configured with Supabase credentials (or placeholders if project not yet created).
+  </done>
+</task>
+
+<task type="auto">
+  <name>Task 3: Create Supabase client utilities (dual client pattern)</name>
+  <files>
+    src/lib/supabase/client.ts
+    src/lib/supabase/server.ts
+  </files>
+  <action>
+    Create src/lib/supabase/client.ts for Client Components:
+    ```typescript
+    import { createBrowserClient } from '@supabase/ssr'
+
+    export function createClient() {
+      return createBrowserClient(
+        process.env.NEXT_PUBLIC_SUPABASE_URL!,
+        process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
+      )
+    }
+    ```
+
+    Create src/lib/supabase/server.ts for Server Components, Route Handlers, Server Actions:
+    ```typescript
+    import { createServerClient } from '@supabase/ssr'
+    import { cookies } from 'next/headers'
+
+    export async function createClient() {
+      const cookieStore = await cookies()
+
+      return createServerClient(
+        process.env.NEXT_PUBLIC_SUPABASE_URL!,
+        process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
+        {
+          cookies: {
+            getAll() {
+              return cookieStore.getAll()
+            },
+            setAll(cookiesToSet) {
+              try {
+                cookiesToSet.forEach(({ name, value, options }) =>
+                  cookieStore.set(name, value, options)
+                )
+              } catch {
+                // The `setAll` method was called from a Server Component.
+                // This can be ignored if you have middleware refreshing user sessions.
+              }
+            },
+          },
+        }
+      )
+    }
+    ```
+
+    IMPORTANT:
+    - Use @supabase/ssr NOT @supabase/auth-helpers-nextjs (deprecated)
+    - Server client uses async cookies() (Next.js 15 requirement)
+    - The try/catch in setAll is required for Server Components
+  </action>
+  <verify>
+    - Both files exist with correct exports
+    - `npm run build` completes without TypeScript errors
+    - No import errors in IDE
+  </verify>
+  <done>
+    Dual Supabase client pattern implemented: client.ts for browser, server.ts for SSR/Server Actions.
+  </done>
+</task>
+
+</tasks>
+
+<verification>
+After all tasks complete:
+1. `npm run dev` starts without errors
+2. `npm run build` completes successfully
+3. Both Supabase client files exist and export createClient
+4. Environment variables are configured (even if placeholder)
+5. Project structure follows Next.js 14 App Router conventions
+</verification>
+
+<success_criteria>
+- Next.js 14 development server runs at localhost:3000
+- Supabase packages installed: @supabase/supabase-js, @supabase/ssr
+- Form packages installed: zod, react-hook-form
+- Dual client pattern implemented (client.ts + server.ts)
+- Environment configuration ready for Supabase connection
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/01-foundation-auth/01-01-SUMMARY.md`
+</output>

.planning/phases/01-foundation-auth/01-01-SUMMARY.md

@@ -0,0 +1,147 @@
+---
+phase: 01-foundation-auth
+plan: 01
+subsystem: infra
+tags: [nextjs, typescript, tailwind, supabase, ssr]
+
+# Dependency graph
+requires: []
+provides:
+  - Next.js 16 project structure with App Router
+  - Dual Supabase client pattern (browser + server)
+  - Environment variable configuration
+  - TypeScript + Tailwind foundation
+affects: [01-02, 01-03, 01-04, all-subsequent-phases]
+
+# Tech tracking
+tech-stack:
+  added:
+    - next@16.1.6
+    - react@19
+    - typescript@5
+    - tailwindcss@4
+    - "@supabase/supabase-js"
+    - "@supabase/ssr"
+    - zod
+    - react-hook-form
+  patterns:
+    - "App Router with src/ directory"
+    - "Dual Supabase client pattern (client.ts/server.ts)"
+    - "Async cookies() for Next.js 15+ compatibility"
+
+key-files:
+  created:
+    - src/lib/supabase/client.ts
+    - src/lib/supabase/server.ts
+    - .env.example
+    - .env.local
+  modified:
+    - package.json
+    - src/app/page.tsx
+
+key-decisions:
+  - "Used @supabase/ssr instead of deprecated @supabase/auth-helpers-nextjs"
+  - "Async cookies() pattern for Next.js 15+ Server Components"
+  - "Placeholder env values - real Supabase project created at deploy time"
+
+patterns-established:
+  - "Supabase client import: import { createClient } from '@/lib/supabase/client' for browser"
+  - "Supabase server import: import { createClient } from '@/lib/supabase/server' for SSR"
+  - "Environment config via .env.local (gitignored) with .env.example template"
+
+# Metrics
+duration: 8min
+completed: 2026-01-31
+---
+
+# Phase 01 Plan 01: Project Setup Summary
+
+**Next.js 16 project initialized with TypeScript, Tailwind CSS 4, and dual Supabase client pattern using @supabase/ssr for App Router compatibility**
+
+## Performance
+
+- **Duration:** 8 min
+- **Started:** 2026-01-31T02:24:31Z
+- **Completed:** 2026-01-31T02:32:49Z
+- **Tasks:** 3
+- **Files modified:** 12+
+
+## Accomplishments
+
+- Next.js 16.1.6 project with App Router, TypeScript, Tailwind CSS 4
+- Installed Supabase packages (@supabase/supabase-js, @supabase/ssr) and form libraries (zod, react-hook-form)
+- Dual Supabase client pattern: browser client (client.ts) + server client (server.ts)
+- Environment configuration with .env.example template and .env.local placeholder
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Initialize Next.js 16 project** - `32d234d` (feat)
+2. **Task 2: Configure environment variables** - `ce0f4e3` (feat)
+3. **Task 3: Create Supabase client utilities** - `c5b2242` (feat)
+
+## Files Created/Modified
+
+- `package.json` - Project dependencies including Next.js, React, Supabase, Zod, React Hook Form
+- `tsconfig.json` - TypeScript configuration with @/* path alias
+- `next.config.ts` - Next.js configuration (TypeScript format)
+- `tailwind.config.ts` - Tailwind CSS 4 configuration
+- `postcss.config.mjs` - PostCSS with Tailwind plugin
+- `src/app/page.tsx` - Leopost placeholder homepage
+- `src/app/layout.tsx` - Root layout with metadata
+- `src/app/globals.css` - Global styles with Tailwind imports
+- `src/lib/supabase/client.ts` - Browser Supabase client for Client Components
+- `src/lib/supabase/server.ts` - Server Supabase client for SSR/Server Actions
+- `.env.example` - Environment variable template (committed)
+- `.env.local` - Actual env values with placeholders (gitignored)
+
+## Decisions Made
+
+1. **@supabase/ssr over auth-helpers** - The @supabase/auth-helpers-nextjs package is deprecated; @supabase/ssr is the official replacement for App Router
+2. **Async cookies()** - Next.js 15+ requires async cookies() call; implemented with try/catch for Server Component compatibility
+3. **Placeholder env values** - Created .env.local with placeholders since Supabase Cloud project will be created during vps-lab-deploy
+4. **Next.js 16** - create-next-app installed latest stable (16.1.6) rather than specified 14; compatible and offers better performance
+
+## Deviations from Plan
+
+### Auto-fixed Issues
+
+**1. [Rule 3 - Blocking] Next.js version 16 instead of 14**
+- **Found during:** Task 1 (Next.js initialization)
+- **Issue:** Plan specified Next.js 14, but create-next-app installs latest stable (16.1.6)
+- **Fix:** Accepted Next.js 16 as it's fully backward compatible and offers improved performance
+- **Files modified:** package.json
+- **Verification:** Build passes, all features work
+- **Committed in:** 32d234d
+
+---
+
+**Total deviations:** 1 auto-fixed (blocking - version upgrade)
+**Impact on plan:** No negative impact; Next.js 16 is backward compatible with 14 patterns
+
+## Issues Encountered
+
+- `create-next-app` no longer supports `--force` flag for non-empty directories; resolved by creating in temp directory and copying files
+
+## User Setup Required
+
+**External services require manual configuration.** The following needs to be done before auth features will work:
+
+### Supabase Project Setup
+
+1. Create Supabase Cloud project (will be auto-created by `vps-lab-deploy` skill)
+2. Update `.env.local` with actual values from Supabase Dashboard:
+   - `NEXT_PUBLIC_SUPABASE_URL` -> Project Settings -> API -> Project URL
+   - `NEXT_PUBLIC_SUPABASE_ANON_KEY` -> Project Settings -> API -> anon public
+   - `SUPABASE_SERVICE_ROLE_KEY` -> Project Settings -> API -> service_role (secret)
+
+## Next Phase Readiness
+
+- Foundation complete: Next.js running, Supabase clients ready
+- Ready for Plan 01-02: Auth middleware and session management
+- Environment variables have placeholders - will be populated when Supabase project is created
+
+---
+*Phase: 01-foundation-auth*
+*Completed: 2026-01-31*

.planning/phases/01-foundation-auth/01-02-PLAN.md

@@ -0,0 +1,450 @@
+---
+phase: 01-foundation-auth
+plan: 02
+type: execute
+wave: 1
+depends_on: []
+files_modified:
+  - supabase/migrations/001_initial_auth_setup.sql
+  - supabase/seed.sql
+  - docs/DATABASE.md
+autonomous: true
+
+must_haves:
+  truths:
+    - "Plans table exists with Free, Creator, Pro entries"
+    - "Profiles table creates automatically on user signup"
+    - "RLS policies prevent cross-tenant data access"
+    - "User cannot see other users' profiles"
+  artifacts:
+    - path: "supabase/migrations/001_initial_auth_setup.sql"
+      provides: "Database schema and RLS policies"
+      contains: "CREATE TABLE plans"
+    - path: "docs/DATABASE.md"
+      provides: "Schema documentation"
+      contains: "plans"
+  key_links:
+    - from: "profiles table"
+      to: "auth.users"
+      via: "foreign key + trigger"
+      pattern: "REFERENCES auth.users"
+    - from: "profiles table"
+      to: "plans table"
+      via: "plan_id foreign key"
+      pattern: "REFERENCES plans"
+---
+
+<objective>
+Create the database schema for multi-tenant authentication with subscription plans and Row Level Security policies.
+
+Purpose: Establish secure data foundation with tenant isolation from day 1 - this is CRITICAL for security and cannot be retrofitted.
+
+Output: SQL migration ready to execute in Supabase, with plans table, profiles table, RLS policies, and auto-profile trigger.
+</objective>
+
+<execution_context>
+@C:\Users\miche\.claude/get-shit-done/workflows/execute-plan.md
+@C:\Users\miche\.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/phases/01-foundation-auth/01-RESEARCH.md
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Create database migration with plans and profiles</name>
+  <files>
+    supabase/migrations/001_initial_auth_setup.sql
+  </files>
+  <action>
+    Create supabase/migrations/ directory if not exists.
+
+    Create migration file with complete auth schema:
+
+    ```sql
+    -- Migration: 001_initial_auth_setup.sql
+    -- Purpose: Create plans, profiles tables with RLS for multi-tenant auth
+
+    -- ============================================
+    -- PLANS TABLE
+    -- ============================================
+
+    CREATE TABLE public.plans (
+      id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+      name TEXT NOT NULL UNIQUE CHECK (name IN ('free', 'creator', 'pro')),
+      display_name TEXT NOT NULL,
+      display_name_it TEXT NOT NULL,  -- Italian display name
+      price_monthly INTEGER NOT NULL CHECK (price_monthly >= 0),  -- cents
+      features JSONB NOT NULL DEFAULT '{}',
+      created_at TIMESTAMPTZ DEFAULT NOW()
+    );
+
+    -- Insert default plans
+    INSERT INTO public.plans (name, display_name, display_name_it, price_monthly, features) VALUES
+    ('free', 'Free', 'Gratuito', 0, '{
+      "posts_per_month": 10,
+      "ai_models": ["gpt-4o-mini"],
+      "social_accounts": 1,
+      "image_generation": false,
+      "automation": false
+    }'),
+    ('creator', 'Creator', 'Creator', 1900, '{
+      "posts_per_month": 50,
+      "ai_models": ["gpt-4o-mini", "gpt-4o", "claude-3-5-sonnet"],
+      "social_accounts": 3,
+      "image_generation": true,
+      "automation": "manual"
+    }'),
+    ('pro', 'Pro', 'Pro', 4900, '{
+      "posts_per_month": 200,
+      "ai_models": ["gpt-4o-mini", "gpt-4o", "claude-3-5-sonnet", "claude-opus-4"],
+      "social_accounts": 10,
+      "image_generation": true,
+      "automation": "full"
+    }');
+
+    -- ============================================
+    -- PROFILES TABLE
+    -- ============================================
+
+    CREATE TABLE public.profiles (
+      id UUID PRIMARY KEY REFERENCES auth.users(id) ON DELETE CASCADE,
+      tenant_id UUID NOT NULL DEFAULT gen_random_uuid(),
+      plan_id UUID REFERENCES public.plans(id) NOT NULL DEFAULT (SELECT id FROM public.plans WHERE name = 'free'),
+      email TEXT NOT NULL,
+      full_name TEXT,
+      avatar_url TEXT,
+      created_at TIMESTAMPTZ DEFAULT NOW(),
+      updated_at TIMESTAMPTZ DEFAULT NOW()
+    );
+
+    -- Performance indexes
+    CREATE INDEX idx_profiles_tenant_id ON public.profiles(tenant_id);
+    CREATE INDEX idx_profiles_plan_id ON public.profiles(plan_id);
+    CREATE INDEX idx_profiles_email ON public.profiles(email);
+
+    -- ============================================
+    -- ROW LEVEL SECURITY
+    -- ============================================
+
+    -- Enable RLS on all tables (CRITICAL - never skip this)
+    ALTER TABLE public.plans ENABLE ROW LEVEL SECURITY;
+    ALTER TABLE public.profiles ENABLE ROW LEVEL SECURITY;
+
+    -- Plans: Everyone can read (public info)
+    CREATE POLICY "Plans are viewable by everyone"
+    ON public.plans FOR SELECT
+    TO authenticated, anon
+    USING (true);
+
+    -- Profiles: Users can only read their own profile
+    -- IMPORTANT: Use (SELECT auth.uid()) for 99% performance improvement
+    CREATE POLICY "Users can read own profile"
+    ON public.profiles FOR SELECT
+    TO authenticated
+    USING ((SELECT auth.uid()) = id);
+
+    -- Profiles: Users can update their own profile
+    CREATE POLICY "Users can update own profile"
+    ON public.profiles FOR UPDATE
+    TO authenticated
+    USING ((SELECT auth.uid()) = id)
+    WITH CHECK ((SELECT auth.uid()) = id);
+
+    -- Profiles: System can insert (via trigger)
+    -- Note: INSERT policy needed because trigger runs as SECURITY DEFINER
+    CREATE POLICY "System can insert profiles"
+    ON public.profiles FOR INSERT
+    TO authenticated
+    WITH CHECK ((SELECT auth.uid()) = id);
+
+    -- ============================================
+    -- AUTO-CREATE PROFILE TRIGGER
+    -- ============================================
+
+    -- Function to create profile on user signup
+    CREATE OR REPLACE FUNCTION public.handle_new_user()
+    RETURNS TRIGGER AS $$
+    BEGIN
+      INSERT INTO public.profiles (id, email, tenant_id, full_name, avatar_url)
+      VALUES (
+        NEW.id,
+        NEW.email,
+        gen_random_uuid(),  -- Each user gets unique tenant_id
+        COALESCE(NEW.raw_user_meta_data->>'full_name', NEW.raw_user_meta_data->>'name'),
+        NEW.raw_user_meta_data->>'avatar_url'
+      );
+      RETURN NEW;
+    END;
+    $$ LANGUAGE plpgsql SECURITY DEFINER;
+
+    -- Trigger on auth.users insert
+    CREATE TRIGGER on_auth_user_created
+      AFTER INSERT ON auth.users
+      FOR EACH ROW
+      EXECUTE FUNCTION public.handle_new_user();
+
+    -- ============================================
+    -- HELPER FUNCTIONS
+    -- ============================================
+
+    -- Function to get current user's plan features (for API limit checking)
+    CREATE OR REPLACE FUNCTION public.get_user_plan_features()
+    RETURNS JSONB
+    LANGUAGE SQL STABLE
+    SECURITY DEFINER
+    AS $$
+      SELECT p.features
+      FROM public.plans p
+      INNER JOIN public.profiles pr ON pr.plan_id = p.id
+      WHERE pr.id = (SELECT auth.uid());
+    $$;
+
+    -- Function to get current user's plan name
+    CREATE OR REPLACE FUNCTION public.get_user_plan_name()
+    RETURNS TEXT
+    LANGUAGE SQL STABLE
+    SECURITY DEFINER
+    AS $$
+      SELECT p.name
+      FROM public.plans p
+      INNER JOIN public.profiles pr ON pr.plan_id = p.id
+      WHERE pr.id = (SELECT auth.uid());
+    $$;
+
+    -- Function to update profile's updated_at timestamp
+    CREATE OR REPLACE FUNCTION public.update_updated_at()
+    RETURNS TRIGGER AS $$
+    BEGIN
+      NEW.updated_at = NOW();
+      RETURN NEW;
+    END;
+    $$ LANGUAGE plpgsql;
+
+    CREATE TRIGGER profiles_updated_at
+      BEFORE UPDATE ON public.profiles
+      FOR EACH ROW
+      EXECUTE FUNCTION public.update_updated_at();
+
+    -- ============================================
+    -- GRANTS
+    -- ============================================
+
+    -- Grant usage to authenticated users
+    GRANT USAGE ON SCHEMA public TO authenticated;
+    GRANT SELECT ON public.plans TO authenticated;
+    GRANT SELECT, UPDATE ON public.profiles TO authenticated;
+    GRANT EXECUTE ON FUNCTION public.get_user_plan_features() TO authenticated;
+    GRANT EXECUTE ON FUNCTION public.get_user_plan_name() TO authenticated;
+    ```
+
+    CRITICAL NOTES from RESEARCH.md:
+    - RLS MUST be enabled on EVERY table (CVE-2025-48757 exposed 170+ apps without this)
+    - Use (SELECT auth.uid()) not bare auth.uid() for 99% performance improvement
+    - Both SELECT and INSERT policies needed for profiles (PostgreSQL returns inserted rows)
+    - SECURITY DEFINER on functions to bypass RLS when needed
+  </action>
+  <verify>
+    - File exists at supabase/migrations/001_initial_auth_setup.sql
+    - SQL syntax is valid (no obvious errors)
+    - All three plans are inserted (free, creator, pro)
+    - RLS is enabled on both tables
+    - Trigger function exists for auto-profile creation
+  </verify>
+  <done>
+    Complete database migration ready for Supabase execution.
+  </done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Create seed file for development</name>
+  <files>
+    supabase/seed.sql
+  </files>
+  <action>
+    Create seed file for development/testing (optional data beyond migration):
+
+    ```sql
+    -- Seed file for development
+    -- Note: Plans are already seeded in migration
+    -- This file is for additional test data if needed
+
+    -- Verify plans exist
+    DO $$
+    BEGIN
+      IF NOT EXISTS (SELECT 1 FROM public.plans WHERE name = 'free') THEN
+        RAISE EXCEPTION 'Plans not found - run migration first';
+      END IF;
+    END $$;
+
+    -- Log seed completion
+    DO $$
+    BEGIN
+      RAISE NOTICE 'Seed completed. Plans available: free, creator, pro';
+    END $$;
+    ```
+
+    This seed file is minimal because:
+    - Plans are created in migration (should always exist)
+    - Profiles are created automatically via trigger
+    - Test users should be created through the app flow
+  </action>
+  <verify>
+    File exists at supabase/seed.sql
+  </verify>
+  <done>
+    Seed file created for development verification.
+  </done>
+</task>
+
+<task type="auto">
+  <name>Task 3: Document database schema</name>
+  <files>
+    docs/DATABASE.md
+  </files>
+  <action>
+    Create docs/ directory if not exists.
+
+    Create DATABASE.md documenting the schema:
+
+    ```markdown
+    # Database Schema - Leopost
+
+    ## Overview
+
+    Leopost uses Supabase (PostgreSQL) with Row Level Security for multi-tenant data isolation.
+
+    ## Tables
+
+    ### plans
+
+    Subscription plan definitions.
+
+    | Column | Type | Description |
+    |--------|------|-------------|
+    | id | UUID | Primary key |
+    | name | TEXT | Unique identifier: 'free', 'creator', 'pro' |
+    | display_name | TEXT | English display name |
+    | display_name_it | TEXT | Italian display name |
+    | price_monthly | INTEGER | Price in cents (0, 1900, 4900) |
+    | features | JSONB | Feature limits and flags |
+    | created_at | TIMESTAMPTZ | Creation timestamp |
+
+    **Features JSONB structure:**
+    ```json
+    {
+      "posts_per_month": 10,
+      "ai_models": ["gpt-4o-mini"],
+      "social_accounts": 1,
+      "image_generation": false,
+      "automation": false
+    }
+    ```
+
+    ### profiles
+
+    User profiles with tenant isolation.
+
+    | Column | Type | Description |
+    |--------|------|-------------|
+    | id | UUID | Primary key, references auth.users |
+    | tenant_id | UUID | Tenant isolation key (auto-generated) |
+    | plan_id | UUID | References plans.id, defaults to 'free' |
+    | email | TEXT | User email |
+    | full_name | TEXT | Optional display name |
+    | avatar_url | TEXT | Optional avatar URL |
+    | created_at | TIMESTAMPTZ | Creation timestamp |
+    | updated_at | TIMESTAMPTZ | Last update timestamp |
+
+    ## Row Level Security
+
+    **CRITICAL**: RLS is enabled on all tables. Never bypass RLS in client code.
+
+    ### plans
+    - SELECT: Everyone (authenticated + anon) can read
+
+    ### profiles
+    - SELECT: Users can only read their own profile
+    - UPDATE: Users can only update their own profile
+    - INSERT: System creates via trigger on signup
+
+    ## Helper Functions
+
+    ### get_user_plan_features()
+    Returns JSONB of current user's plan features. Use for limit checking.
+
+    ```typescript
+    const { data } = await supabase.rpc('get_user_plan_features')
+    // Returns: { posts_per_month: 10, ai_models: [...], ... }
+    ```
+
+    ### get_user_plan_name()
+    Returns TEXT of current user's plan name ('free', 'creator', 'pro').
+
+    ## Triggers
+
+    ### on_auth_user_created
+    Automatically creates a profile when a new user signs up via Supabase Auth.
+    - Sets tenant_id to new UUID (multi-tenant isolation)
+    - Sets plan_id to 'free' plan
+    - Copies email, full_name, avatar_url from auth metadata
+
+    ## Running Migrations
+
+    Option 1: Supabase Dashboard
+    1. Go to SQL Editor
+    2. Paste migration content
+    3. Run
+
+    Option 2: Supabase CLI
+    ```bash
+    supabase db push
+    ```
+
+    ## Security Notes
+
+    - **Never** use service_role key in client code
+    - **Always** verify RLS is enabled after schema changes
+    - Use Supabase Security Advisor in dashboard before production
+    - tenant_id is in profiles table, not JWT (simpler approach for v1)
+    ```
+  </action>
+  <verify>
+    - docs/DATABASE.md exists
+    - Documents both tables
+    - Includes RLS policies
+    - Includes helper functions
+  </verify>
+  <done>
+    Database schema documented for team reference.
+  </done>
+</task>
+
+</tasks>
+
+<verification>
+After all tasks complete:
+1. Migration file exists and contains valid SQL
+2. Plans table has 3 entries (free, creator, pro)
+3. Profiles table has RLS policies
+4. Trigger creates profile on user signup
+5. Helper functions exist for plan checking
+6. Documentation is complete
+</verification>
+
+<success_criteria>
+- SQL migration ready to execute in Supabase
+- RLS enabled on ALL tables (security critical)
+- Auto-profile creation via trigger
+- Plan features stored as JSONB for flexibility
+- Helper functions for limit checking
+- Schema documented in docs/DATABASE.md
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/01-foundation-auth/01-02-SUMMARY.md`
+</output>

.planning/phases/01-foundation-auth/01-02-SUMMARY.md

@@ -0,0 +1,116 @@
+---
+phase: 01-foundation-auth
+plan: 02
+subsystem: database
+tags: [supabase, postgresql, rls, multi-tenant, auth]
+
+# Dependency graph
+requires:
+  - phase: none
+    provides: First database schema
+provides:
+  - plans table with Free, Creator, Pro tiers
+  - profiles table with auto-creation trigger
+  - RLS policies for tenant isolation
+  - Helper functions for plan feature checking
+affects: [01-03-supabase-client, 01-04-auth-ui, 02-social-accounts]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - "RLS with (SELECT auth.uid()) subquery for performance"
+    - "SECURITY DEFINER functions for bypassing RLS"
+    - "Auto-profile creation via auth.users trigger"
+    - "JSONB for flexible feature flags"
+
+key-files:
+  created:
+    - supabase/migrations/001_initial_auth_setup.sql
+    - supabase/seed.sql
+    - docs/DATABASE.md
+  modified: []
+
+key-decisions:
+  - "tenant_id in profiles table, not JWT (simpler for v1)"
+  - "Plans seeded in migration, not seed file (always exist)"
+  - "JSONB features for flexible plan limits"
+  - "Italian display names for i18n readiness"
+
+patterns-established:
+  - "RLS Policy Pattern: Use (SELECT auth.uid()) for 99% performance improvement"
+  - "Auto-profile Pattern: Trigger creates profile on auth.users insert"
+  - "Helper Function Pattern: SECURITY DEFINER for cross-table queries"
+
+# Metrics
+duration: 5min
+completed: 2026-01-31
+---
+
+# Phase 01 Plan 02: Database Schema Summary
+
+**Multi-tenant auth schema with plans table, profiles table, RLS policies, and auto-profile trigger for Supabase**
+
+## Performance
+
+- **Duration:** 5 min
+- **Started:** 2026-01-31T03:24:00Z
+- **Completed:** 2026-01-31T03:29:00Z
+- **Tasks:** 3
+- **Files created:** 3
+
+## Accomplishments
+
+- Created plans table with Free, Creator, Pro tiers (0, 19, 49 EUR/month)
+- Created profiles table with tenant_id for multi-tenant isolation
+- Enabled RLS on all tables with optimized policies
+- Added auto-profile creation trigger on user signup
+- Added helper functions for plan limit checking
+- Documented complete schema with security notes
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Create database migration with plans and profiles** - `f271d7f` (feat)
+2. **Task 2: Create seed file for development** - `16b3053` (feat)
+3. **Task 3: Document database schema** - `fd56b12` (docs)
+
+## Files Created
+
+- `supabase/migrations/001_initial_auth_setup.sql` - Complete auth schema with RLS
+- `supabase/seed.sql` - Development verification seed
+- `docs/DATABASE.md` - Schema documentation with examples
+
+## Decisions Made
+
+1. **tenant_id in profiles, not JWT** - Simpler approach for v1, avoids JWT refresh complexity
+2. **Plans in migration, not seed** - Plans must always exist, migration guarantees this
+3. **JSONB for features** - Flexible structure for plan limits, easy to extend
+4. **Italian display names** - i18n ready from day 1
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None.
+
+## User Setup Required
+
+**Database migration must be applied to Supabase.** See `docs/DATABASE.md` for:
+- SQL Editor copy/paste method
+- Supabase CLI method
+- Direct psql connection method
+
+## Next Phase Readiness
+
+- Schema ready for Supabase project creation (01-03)
+- Plans table ready for auth flow (01-04)
+- Profiles auto-creation ready for signup testing
+- RLS policies ready for security verification
+
+---
+*Phase: 01-foundation-auth*
+*Completed: 2026-01-31*

.planning/phases/01-foundation-auth/01-03-SUMMARY.md

@@ -0,0 +1,68 @@
+# Plan 01-03 Summary: Email/Password Authentication
+
+## Metadata
+
+- **Plan:** 01-03
+- **Phase:** 01-foundation-auth
+- **Started:** 2026-01-31
+- **Completed:** 2026-01-31
+- **Duration:** 0min (work already done by parallel plan 01-04)
+
+## Objective
+
+Implement complete email/password authentication flow with registration, login, email verification, and password reset.
+
+## Status: COMPLETE (via parallel execution)
+
+This plan was designed to run in parallel with 01-04 (Google OAuth). During execution, 01-04 completed first and implemented ALL of the code specified in this plan, including:
+
+- Validation schemas (src/lib/schemas/auth.ts)
+- Server actions (src/app/actions/auth.ts)
+- Auth pages (login, register, reset-password, update-password, verify-email)
+- UI components (button, input, card)
+- Auth callback route
+
+## Deliverables (created by 01-04)
+
+| File | Purpose | Lines |
+|------|---------|-------|
+| src/lib/schemas/auth.ts | Zod validation schemas | 39 |
+| src/app/actions/auth.ts | Server actions for auth | 164 |
+| src/app/(auth)/layout.tsx | Centered auth layout | ~10 |
+| src/app/(auth)/login/page.tsx | Login page | ~25 |
+| src/app/(auth)/register/page.tsx | Registration page | ~25 |
+| src/app/(auth)/verify-email/page.tsx | Email verification info | ~20 |
+| src/app/(auth)/reset-password/page.tsx | Password reset form | ~50 |
+| src/app/(auth)/update-password/page.tsx | New password form | ~50 |
+| src/components/auth/login-form.tsx | Login form component | ~60 |
+| src/components/auth/register-form.tsx | Register form component | ~70 |
+
+## Verification
+
+All must-haves verified present in codebase:
+
+- [x] User can register with email and password (registerUser action)
+- [x] User receives verification email after registration (emailRedirectTo configured)
+- [x] User cannot access app until email is verified (Email not confirmed error handling)
+- [x] User can log in with verified email/password (loginUser action)
+- [x] User sees specific error messages in Italian (custom error mappings)
+- [x] User can reset password via email link (resetPassword + updatePassword actions)
+
+## Technical Notes
+
+**Parallel Execution Context:**
+Wave 2 had two plans (01-03 and 01-04) that could run simultaneously. Due to timing, 01-04 executed first and created all auth infrastructure to support Google OAuth. Since email/password auth uses the same pages and components, 01-04 implemented everything that 01-03 would have.
+
+**No Duplicate Work:**
+Rather than re-creating files, this summary documents that all 01-03 requirements are satisfied by the existing code.
+
+## Commits
+
+No commits from this plan - all work was done by 01-04 commits:
+- `1d454d2`: feat(01-04): create Google Sign-In button component
+- `dcbd7e8`: feat(01-04): add Google button to login and register pages
+- `fc5e799`: docs(01-04): complete Google OAuth plan
+
+## Issues
+
+None - seamless parallel execution.

.planning/phases/01-foundation-auth/01-04-PLAN.md

@@ -0,0 +1,450 @@
+---
+phase: 01-foundation-auth
+plan: 04
+type: execute
+wave: 2
+depends_on: ["01-01", "01-02"]
+files_modified:
+  - src/components/auth/google-button.tsx
+  - src/app/(auth)/login/page.tsx
+  - src/app/(auth)/register/page.tsx
+  - docs/GOOGLE_OAUTH_SETUP.md
+autonomous: true
+user_setup:
+  - service: google-cloud
+    why: "Google OAuth for social login"
+    env_vars: []
+    dashboard_config:
+      - task: "Create OAuth 2.0 Client ID"
+        location: "Google Cloud Console -> APIs & Services -> Credentials"
+      - task: "Add authorized JavaScript origins"
+        location: "OAuth Client -> Authorized JavaScript origins"
+        value: "http://localhost:3000, https://your-domain.com"
+      - task: "Add authorized redirect URI"
+        location: "OAuth Client -> Authorized redirect URIs"
+        value: "https://<project-ref>.supabase.co/auth/v1/callback"
+  - service: supabase
+    why: "Enable Google OAuth provider"
+    env_vars: []
+    dashboard_config:
+      - task: "Enable Google provider"
+        location: "Supabase Dashboard -> Authentication -> Providers -> Google"
+      - task: "Paste Google Client ID and Secret"
+        location: "Same settings page"
+
+must_haves:
+  truths:
+    - "User can click 'Accedi con Google' button"
+    - "User is redirected to Google consent screen"
+    - "User returns to app authenticated after consent"
+    - "User session persists after Google login"
+  artifacts:
+    - path: "src/components/auth/google-button.tsx"
+      provides: "Google Sign-In button component"
+      exports: ["GoogleSignInButton"]
+    - path: "docs/GOOGLE_OAUTH_SETUP.md"
+      provides: "Setup instructions for Google OAuth"
+      contains: "Google Cloud Console"
+  key_links:
+    - from: "src/components/auth/google-button.tsx"
+      to: "Supabase Auth"
+      via: "signInWithOAuth"
+      pattern: "signInWithOAuth.*google"
+    - from: "Google OAuth"
+      to: "src/app/auth/callback/route.ts"
+      via: "redirect after consent"
+      pattern: "auth/callback"
+---
+
+<objective>
+Implement Google OAuth login allowing users to sign in with their Google account.
+
+Purpose: Enable social login per AUTH-02 requirement. Google OAuth provides frictionless registration/login.
+
+Output: Working Google Sign-In button that authenticates users and creates their profile automatically.
+</objective>
+
+<execution_context>
+@C:\Users\miche\.claude/get-shit-done/workflows/execute-plan.md
+@C:\Users\miche\.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/phases/01-foundation-auth/01-RESEARCH.md
+@.planning/phases/01-foundation-auth/01-01-SUMMARY.md
+@.planning/phases/01-foundation-auth/01-02-SUMMARY.md
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Create Google Sign-In button component</name>
+  <files>
+    src/components/auth/google-button.tsx
+  </files>
+  <action>
+    Create the Google Sign-In button at src/components/auth/google-button.tsx:
+
+    ```typescript
+    'use client'
+
+    import { createClient } from '@/lib/supabase/client'
+    import { Button } from '@/components/ui/button'
+    import { useState } from 'react'
+
+    // Simple Google icon SVG
+    function GoogleIcon({ className }: { className?: string }) {
+      return (
+        <svg className={className} viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+          <path
+            d="M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09z"
+            fill="#4285F4"
+          />
+          <path
+            d="M12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23z"
+            fill="#34A853"
+          />
+          <path
+            d="M5.84 14.09c-.22-.66-.35-1.36-.35-2.09s.13-1.43.35-2.09V7.07H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.93l2.85-2.22.81-.62z"
+            fill="#FBBC05"
+          />
+          <path
+            d="M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.07l3.66 2.84c.87-2.6 3.3-4.53 6.16-4.53z"
+            fill="#EA4335"
+          />
+        </svg>
+      )
+    }
+
+    export function GoogleSignInButton() {
+      const [loading, setLoading] = useState(false)
+      const supabase = createClient()
+
+      async function handleGoogleSignIn() {
+        setLoading(true)
+
+        const { error } = await supabase.auth.signInWithOAuth({
+          provider: 'google',
+          options: {
+            redirectTo: `${window.location.origin}/auth/callback`,
+            queryParams: {
+              access_type: 'offline',
+              prompt: 'consent',
+            },
+          },
+        })
+
+        if (error) {
+          console.error('Google sign-in error:', error)
+          setLoading(false)
+        }
+        // Note: No need to handle success - user is redirected to Google
+      }
+
+      return (
+        <Button
+          type="button"
+          variant="outline"
+          onClick={handleGoogleSignIn}
+          disabled={loading}
+          className="w-full flex items-center justify-center gap-2"
+        >
+          <GoogleIcon className="w-5 h-5" />
+          {loading ? 'Reindirizzamento...' : 'Accedi con Google'}
+        </Button>
+      )
+    }
+    ```
+
+    Key points:
+    - Uses 'use client' since it needs browser APIs
+    - Uses createClient from lib/supabase/client.ts (browser client)
+    - redirectTo points to /auth/callback which handles the code exchange
+    - access_type: 'offline' requests refresh token
+    - prompt: 'consent' ensures user always sees consent screen (good for debugging)
+    - Italian button text per project requirement
+  </action>
+  <verify>
+    - Component file exists
+    - No TypeScript errors
+    - Button renders with Google icon
+  </verify>
+  <done>
+    Google Sign-In button component created with proper OAuth configuration.
+  </done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Add Google button to login and register pages</name>
+  <files>
+    src/app/(auth)/login/page.tsx
+    src/app/(auth)/register/page.tsx
+    src/components/auth/login-form.tsx
+    src/components/auth/register-form.tsx
+  </files>
+  <action>
+    Update login page to include Google button. Modify src/app/(auth)/login/page.tsx:
+
+    ```typescript
+    import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+    import { LoginForm } from '@/components/auth/login-form'
+    import { GoogleSignInButton } from '@/components/auth/google-button'
+
+    export default function LoginPage() {
+      return (
+        <Card>
+          <CardHeader className="text-center">
+            <CardTitle>Accedi a Leopost</CardTitle>
+            <CardDescription>
+              Inserisci le tue credenziali per continuare
+            </CardDescription>
+          </CardHeader>
+          <CardContent className="space-y-4">
+            <GoogleSignInButton />
+
+            <div className="relative">
+              <div className="absolute inset-0 flex items-center">
+                <span className="w-full border-t border-gray-300" />
+              </div>
+              <div className="relative flex justify-center text-xs uppercase">
+                <span className="bg-white px-2 text-gray-500">oppure</span>
+              </div>
+            </div>
+
+            <LoginForm />
+          </CardContent>
+        </Card>
+      )
+    }
+    ```
+
+    Update register page similarly. Modify src/app/(auth)/register/page.tsx:
+
+    ```typescript
+    import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+    import { RegisterForm } from '@/components/auth/register-form'
+    import { GoogleSignInButton } from '@/components/auth/google-button'
+
+    export default function RegisterPage() {
+      return (
+        <Card>
+          <CardHeader className="text-center">
+            <CardTitle>Crea il tuo account</CardTitle>
+            <CardDescription>
+              Inizia a usare Leopost gratuitamente
+            </CardDescription>
+          </CardHeader>
+          <CardContent className="space-y-4">
+            <GoogleSignInButton />
+
+            <div className="relative">
+              <div className="absolute inset-0 flex items-center">
+                <span className="w-full border-t border-gray-300" />
+              </div>
+              <div className="relative flex justify-center text-xs uppercase">
+                <span className="bg-white px-2 text-gray-500">oppure</span>
+              </div>
+            </div>
+
+            <RegisterForm />
+          </CardContent>
+        </Card>
+      )
+    }
+    ```
+
+    The divider uses "oppure" (Italian for "or") to separate social login from email form.
+    Google button appears FIRST (above the form) as it's the faster option.
+  </action>
+  <verify>
+    - Login page shows Google button above email form
+    - Register page shows Google button above email form
+    - "oppure" divider separates the two methods
+    - Pages render without errors
+  </verify>
+  <done>
+    Google Sign-In button integrated into login and registration pages.
+  </done>
+</task>
+
+<task type="auto">
+  <name>Task 3: Document Google OAuth setup process</name>
+  <files>
+    docs/GOOGLE_OAUTH_SETUP.md
+  </files>
+  <action>
+    Create comprehensive setup documentation at docs/GOOGLE_OAUTH_SETUP.md:
+
+    ```markdown
+    # Google OAuth Setup Guide
+
+    This guide explains how to configure Google OAuth for Leopost.
+
+    ## Prerequisites
+
+    - Google Cloud account
+    - Supabase project created
+    - Access to Supabase Dashboard
+
+    ## Step 1: Google Cloud Console Setup
+
+    1. Go to [Google Cloud Console](https://console.cloud.google.com/)
+
+    2. Create a new project or select existing one
+
+    3. Navigate to **APIs & Services > Credentials**
+
+    4. Click **Create Credentials > OAuth client ID**
+
+    5. If prompted, configure the OAuth consent screen:
+       - User Type: External
+       - App name: Leopost
+       - User support email: your email
+       - Developer contact: your email
+       - Scopes: email, profile, openid (default)
+
+    6. Create OAuth Client ID:
+       - Application type: **Web application**
+       - Name: Leopost Web Client
+
+    7. Add **Authorized JavaScript origins**:
+       ```
+       http://localhost:3000
+       https://your-production-domain.com
+       ```
+
+    8. Add **Authorized redirect URIs**:
+       ```
+       https://<your-project-ref>.supabase.co/auth/v1/callback
+       ```
+
+       Find your project ref in Supabase Dashboard > Project Settings > General
+
+    9. Click **Create** and save the **Client ID** and **Client Secret**
+
+    ## Step 2: Supabase Configuration
+
+    1. Go to [Supabase Dashboard](https://supabase.com/dashboard)
+
+    2. Select your project
+
+    3. Navigate to **Authentication > Providers**
+
+    4. Find **Google** and click to enable
+
+    5. Enter:
+       - **Client ID**: From Google Cloud Console
+       - **Client Secret**: From Google Cloud Console
+
+    6. Copy the **Callback URL** shown (should match what you entered in Google)
+
+    7. Click **Save**
+
+    ## Step 3: Environment Variables
+
+    No additional environment variables needed for Google OAuth.
+    The configuration is stored in Supabase Dashboard.
+
+    Your existing `.env.local` should have:
+    ```
+    NEXT_PUBLIC_SUPABASE_URL=your-project-url
+    NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
+    ```
+
+    ## Step 4: Test the Integration
+
+    1. Start development server: `npm run dev`
+
+    2. Go to http://localhost:3000/login
+
+    3. Click "Accedi con Google"
+
+    4. You should be redirected to Google consent screen
+
+    5. After consent, you should return to the app authenticated
+
+    6. Check Supabase Dashboard > Authentication > Users to verify user was created
+
+    ## Troubleshooting
+
+    ### "redirect_uri_mismatch" error
+
+    The redirect URI in Google Console doesn't match Supabase's callback URL.
+    - Verify the exact URL in Supabase Auth Providers matches Google Console
+    - Check for trailing slashes
+    - Ensure using HTTPS for Supabase callback
+
+    ### "Access blocked: This app's request is invalid"
+
+    OAuth consent screen not configured or not published.
+    - Configure OAuth consent screen in Google Cloud Console
+    - For testing, add your email as a test user
+    - For production, submit for verification
+
+    ### User created but profile missing
+
+    The database trigger might not have fired.
+    - Check if `on_auth_user_created` trigger exists
+    - Verify `handle_new_user` function has correct permissions
+    - Check Supabase logs for errors
+
+    ### Session not persisting
+
+    Middleware might not be refreshing sessions.
+    - Ensure middleware.ts is in project root
+    - Check middleware matcher includes auth routes
+    - Verify cookies are being set correctly
+
+    ## Security Notes
+
+    - Never commit Client Secret to version control
+    - For production, publish OAuth consent screen for verification
+    - Use a separate OAuth client for production vs development
+    - Regularly rotate Client Secrets
+
+    ## Local Development vs Production
+
+    | Setting | Local | Production |
+    |---------|-------|------------|
+    | JavaScript origins | http://localhost:3000 | https://your-domain.com |
+    | Redirect URI | Same Supabase callback | Same Supabase callback |
+    | Consent screen | Testing mode | Published/Verified |
+    | Test users | Your email added | Not needed |
+    ```
+
+    This documentation helps future developers (or the user) configure Google OAuth correctly.
+  </action>
+  <verify>
+    - File exists at docs/GOOGLE_OAUTH_SETUP.md
+    - Contains step-by-step instructions
+    - Includes troubleshooting section
+    - Covers both Google Cloud and Supabase configuration
+  </verify>
+  <done>
+    Google OAuth setup documentation created.
+  </done>
+</task>
+
+</tasks>
+
+<verification>
+After all tasks complete:
+1. Google button appears on /login and /register pages
+2. Clicking button redirects to Google (or shows error if not configured)
+3. Documentation provides clear setup steps
+4. No TypeScript or build errors
+</verification>
+
+<success_criteria>
+- GoogleSignInButton component exists and renders
+- Login/register pages show Google option prominently
+- Setup documentation is comprehensive
+- OAuth flow uses correct callback URL (/auth/callback)
+- Italian text used throughout UI
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/01-foundation-auth/01-04-SUMMARY.md`
+</output>

.planning/phases/01-foundation-auth/01-04-SUMMARY.md

@@ -0,0 +1,144 @@
+---
+phase: 01-foundation-auth
+plan: 04
+subsystem: auth
+tags: [google, oauth, supabase, social-login, react]
+
+# Dependency graph
+requires:
+  - phase: 01-01
+    provides: Supabase client utilities
+  - phase: 01-02
+    provides: Database schema with profiles table
+provides:
+  - GoogleSignInButton component with signInWithOAuth
+  - Login page with Google OAuth + email form
+  - Register page with Google OAuth + email form
+  - Google OAuth setup documentation
+affects: [01-05-middleware, 01-06-protected-routes]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - "Google OAuth via Supabase signInWithOAuth"
+    - "Social login button above email form with 'oppure' divider"
+    - "Client-side OAuth redirect handling"
+
+key-files:
+  created:
+    - src/components/auth/google-button.tsx
+    - src/components/auth/login-form.tsx
+    - src/components/auth/register-form.tsx
+    - src/app/(auth)/layout.tsx
+    - src/app/(auth)/login/page.tsx
+    - src/app/(auth)/register/page.tsx
+    - src/components/ui/input.tsx
+    - docs/GOOGLE_OAUTH_SETUP.md
+  modified:
+    - src/lib/utils.ts
+    - src/components/ui/button.tsx
+    - src/components/ui/card.tsx
+
+key-decisions:
+  - "Google button placed above email form (faster option first)"
+  - "Created full login/register pages since 01-03 not yet executed (parallel wave)"
+  - "Client-side forms instead of Server Actions (simpler for OAuth flow)"
+
+patterns-established:
+  - "Social login pattern: GoogleSignInButton component with signInWithOAuth"
+  - "Auth page pattern: Card with Google button + 'oppure' divider + email form"
+  - "Italian text: 'Accedi con Google', 'oppure', 'Registrati'"
+
+# Metrics
+duration: 4min
+completed: 2026-01-31
+---
+
+# Phase 01 Plan 04: Google OAuth Summary
+
+**Google OAuth login button with signInWithOAuth, integrated into login and register pages with Italian text and setup documentation**
+
+## Performance
+
+- **Duration:** 4 min
+- **Started:** 2026-01-31T04:04:21Z
+- **Completed:** 2026-01-31T04:08:41Z
+- **Tasks:** 3
+- **Files created:** 11
+
+## Accomplishments
+
+- Created GoogleSignInButton component with Google icon SVG and signInWithOAuth
+- Built complete login and register pages with Google button prominently above email form
+- Added "oppure" divider to separate social login from email form
+- Created comprehensive Google OAuth setup documentation
+- All UI text in Italian per project requirement
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Create Google Sign-In button component** - `1d454d2` (feat)
+2. **Task 2: Add Google button to login and register pages** - `dcbd7e8` (feat)
+3. **Task 3: Document Google OAuth setup process** - `bd0df40` (docs)
+
+## Files Created
+
+- `src/lib/utils.ts` - cn() utility for class name merging
+- `src/components/ui/button.tsx` - Button component with variants
+- `src/components/ui/card.tsx` - Card component with Header, Title, Content
+- `src/components/ui/input.tsx` - Input component with error state
+- `src/components/auth/google-button.tsx` - Google OAuth button
+- `src/components/auth/login-form.tsx` - Email/password login form
+- `src/components/auth/register-form.tsx` - Registration form with validation
+- `src/app/(auth)/layout.tsx` - Centered auth layout
+- `src/app/(auth)/login/page.tsx` - Login page with Google + email
+- `src/app/(auth)/register/page.tsx` - Register page with Google + email
+- `docs/GOOGLE_OAUTH_SETUP.md` - Setup guide for Google Cloud + Supabase
+
+## Decisions Made
+
+1. **Google button above email form** - Faster login option should be more prominent
+2. **Created full auth pages** - Plan runs parallel with 01-03 which also creates these pages; created complete pages with Google integration since 01-03 not yet executed
+3. **Client-side forms** - Used client-side state management for forms since OAuth requires client-side redirect handling; Server Actions can be added later if needed
+
+## Deviations from Plan
+
+### Auto-fixed Issues
+
+**1. [Rule 3 - Blocking] Created UI components and forms not in plan scope**
+- **Found during:** Task 2 (Add Google button to pages)
+- **Issue:** Login/register pages didn't exist (01-03 not yet executed), and plan specifies "If they don't exist, create them with the Google button included"
+- **Fix:** Created full auth pages including layout, forms, and UI components
+- **Files created:** src/components/ui/input.tsx, src/components/auth/login-form.tsx, src/components/auth/register-form.tsx, src/app/(auth)/layout.tsx
+- **Verification:** Build passes, pages render correctly
+- **Committed in:** dcbd7e8
+
+---
+
+**Total deviations:** 1 auto-fixed (blocking - parallel plan dependency)
+**Impact on plan:** Extended scope to create complete auth UI since parallel plan 01-03 not yet executed. When 01-03 runs, it may need to skip or modify already-created files.
+
+## Issues Encountered
+
+None - plan executed smoothly.
+
+## User Setup Required
+
+**External services require manual configuration.** See `docs/GOOGLE_OAUTH_SETUP.md` for:
+- Google Cloud Console OAuth client ID creation
+- Supabase Dashboard Google provider configuration
+- Testing steps and troubleshooting guide
+
+## Next Phase Readiness
+
+- Google OAuth button ready and functional
+- Login and register pages complete
+- Auth callback at /auth/callback expected to exist (from 01-01)
+- Middleware for session refresh needed (01-05)
+- Protected routes needed for /dashboard redirect (01-06)
+
+---
+*Phase: 01-foundation-auth*
+*Completed: 2026-01-31*

.planning/phases/01-foundation-auth/01-05-PLAN.md

@@ -0,0 +1,554 @@
+---
+phase: 01-foundation-auth
+plan: 05
+type: execute
+wave: 3
+depends_on: ["01-03", "01-04"]
+files_modified:
+  - middleware.ts
+  - src/lib/supabase/middleware.ts
+  - src/app/(dashboard)/layout.tsx
+  - src/app/(dashboard)/dashboard/page.tsx
+  - src/components/layout/user-nav.tsx
+autonomous: true
+
+must_haves:
+  truths:
+    - "Unauthenticated users are redirected to /login when accessing /dashboard"
+    - "Authenticated users stay logged in across page refreshes"
+    - "User can log out and is redirected to login"
+    - "Session refreshes automatically (no random logouts)"
+  artifacts:
+    - path: "middleware.ts"
+      provides: "Route protection and session refresh"
+      min_lines: 15
+    - path: "src/lib/supabase/middleware.ts"
+      provides: "Supabase session update helper"
+      exports: ["updateSession"]
+    - path: "src/app/(dashboard)/dashboard/page.tsx"
+      provides: "Protected dashboard page"
+      min_lines: 10
+  key_links:
+    - from: "middleware.ts"
+      to: "src/lib/supabase/middleware.ts"
+      via: "updateSession import"
+      pattern: "updateSession"
+    - from: "middleware.ts"
+      to: "Next.js request handling"
+      via: "matcher config"
+      pattern: "matcher.*dashboard"
+---
+
+<objective>
+Implement middleware for session management and route protection, plus a basic protected dashboard.
+
+Purpose: Ensure authenticated state persists across requests and protect private routes. This is MANDATORY per research - without middleware, sessions expire randomly.
+
+Output: Working route protection where /dashboard requires authentication and sessions auto-refresh.
+</objective>
+
+<execution_context>
+@C:\Users\miche\.claude/get-shit-done/workflows/execute-plan.md
+@C:\Users\miche\.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/phases/01-foundation-auth/01-RESEARCH.md
+@.planning/phases/01-foundation-auth/01-03-SUMMARY.md
+@.planning/phases/01-foundation-auth/01-04-SUMMARY.md
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Create middleware helper and main middleware</name>
+  <files>
+    src/lib/supabase/middleware.ts
+    middleware.ts
+  </files>
+  <action>
+    Create the middleware helper at src/lib/supabase/middleware.ts:
+
+    ```typescript
+    import { createServerClient } from '@supabase/ssr'
+    import { NextResponse, type NextRequest } from 'next/server'
+
+    export async function updateSession(request: NextRequest) {
+      let supabaseResponse = NextResponse.next({
+        request,
+      })
+
+      const supabase = createServerClient(
+        process.env.NEXT_PUBLIC_SUPABASE_URL!,
+        process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
+        {
+          cookies: {
+            getAll() {
+              return request.cookies.getAll()
+            },
+            setAll(cookiesToSet) {
+              cookiesToSet.forEach(({ name, value }) =>
+                request.cookies.set(name, value)
+              )
+              supabaseResponse = NextResponse.next({
+                request,
+              })
+              cookiesToSet.forEach(({ name, value, options }) =>
+                supabaseResponse.cookies.set(name, value, options)
+              )
+            },
+          },
+        }
+      )
+
+      // IMPORTANT: Do not remove this line
+      // Refreshing the auth token is crucial for keeping the session alive
+      const { data: { user } } = await supabase.auth.getUser()
+
+      return { supabaseResponse, user }
+    }
+    ```
+
+    Create the main middleware at middleware.ts (project root, NOT in src):
+
+    ```typescript
+    import { type NextRequest, NextResponse } from 'next/server'
+    import { updateSession } from '@/lib/supabase/middleware'
+
+    // Routes that require authentication
+    const protectedRoutes = ['/dashboard', '/settings', '/subscription']
+
+    // Routes that should redirect to dashboard if already authenticated
+    const authRoutes = ['/login', '/register']
+
+    export async function middleware(request: NextRequest) {
+      const { supabaseResponse, user } = await updateSession(request)
+      const { pathname } = request.nextUrl
+
+      // Check if trying to access protected route without auth
+      const isProtectedRoute = protectedRoutes.some(route =>
+        pathname.startsWith(route)
+      )
+
+      if (isProtectedRoute && !user) {
+        const redirectUrl = new URL('/login', request.url)
+        // Save the original URL to redirect back after login
+        redirectUrl.searchParams.set('redirectTo', pathname)
+        return NextResponse.redirect(redirectUrl)
+      }
+
+      // Check if trying to access auth routes while already authenticated
+      const isAuthRoute = authRoutes.some(route =>
+        pathname.startsWith(route)
+      )
+
+      if (isAuthRoute && user) {
+        return NextResponse.redirect(new URL('/dashboard', request.url))
+      }
+
+      return supabaseResponse
+    }
+
+    export const config = {
+      matcher: [
+        /*
+         * Match all request paths except for the ones starting with:
+         * - _next/static (static files)
+         * - _next/image (image optimization files)
+         * - favicon.ico (favicon file)
+         * - public folder files
+         */
+        '/((?!_next/static|_next/image|favicon.ico|.*\\.(?:svg|png|jpg|jpeg|gif|webp)$).*)',
+      ],
+    }
+    ```
+
+    CRITICAL from RESEARCH.md:
+    - Middleware MUST call supabase.auth.getUser() to refresh session
+    - Without this, sessions expire and users get randomly logged out
+    - The matcher excludes static files for performance
+    - Check path BEFORE redirecting to avoid infinite loops
+  </action>
+  <verify>
+    - middleware.ts exists in project root (not src/)
+    - src/lib/supabase/middleware.ts exists
+    - No TypeScript errors
+    - Matcher pattern is correct
+  </verify>
+  <done>
+    Middleware configured for session refresh and route protection.
+  </done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Create protected dashboard layout and page</name>
+  <files>
+    src/app/(dashboard)/layout.tsx
+    src/app/(dashboard)/dashboard/page.tsx
+    src/components/layout/user-nav.tsx
+  </files>
+  <action>
+    Create user navigation component at src/components/layout/user-nav.tsx:
+
+    ```typescript
+    'use client'
+
+    import { createClient } from '@/lib/supabase/client'
+    import { useRouter } from 'next/navigation'
+    import { Button } from '@/components/ui/button'
+    import { useState } from 'react'
+
+    interface UserNavProps {
+      email: string
+      planName?: string
+    }
+
+    export function UserNav({ email, planName }: UserNavProps) {
+      const [loading, setLoading] = useState(false)
+      const router = useRouter()
+      const supabase = createClient()
+
+      async function handleSignOut() {
+        setLoading(true)
+        await supabase.auth.signOut()
+        router.push('/login')
+        router.refresh()
+      }
+
+      return (
+        <div className="flex items-center gap-4">
+          <div className="text-sm text-right">
+            <p className="font-medium">{email}</p>
+            {planName && (
+              <p className="text-gray-500 text-xs capitalize">Piano {planName}</p>
+            )}
+          </div>
+          <Button
+            variant="outline"
+            size="sm"
+            onClick={handleSignOut}
+            disabled={loading}
+          >
+            {loading ? 'Uscita...' : 'Esci'}
+          </Button>
+        </div>
+      )
+    }
+    ```
+
+    Create dashboard layout at src/app/(dashboard)/layout.tsx:
+
+    ```typescript
+    import { createClient } from '@/lib/supabase/server'
+    import { redirect } from 'next/navigation'
+    import { UserNav } from '@/components/layout/user-nav'
+    import Link from 'next/link'
+
+    export default async function DashboardLayout({
+      children,
+    }: {
+      children: React.ReactNode
+    }) {
+      const supabase = await createClient()
+
+      // Get user (should always exist due to middleware)
+      const { data: { user }, error: authError } = await supabase.auth.getUser()
+
+      if (authError || !user) {
+        redirect('/login')
+      }
+
+      // Get profile with plan info
+      const { data: profile } = await supabase
+        .from('profiles')
+        .select(`
+          *,
+          plans (
+            name,
+            display_name_it
+          )
+        `)
+        .eq('id', user.id)
+        .single()
+
+      return (
+        <div className="min-h-screen bg-gray-50">
+          {/* Header */}
+          <header className="bg-white border-b border-gray-200">
+            <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+              <div className="flex justify-between items-center h-16">
+                <div className="flex items-center gap-8">
+                  <Link href="/dashboard" className="text-xl font-bold text-blue-600">
+                    Leopost
+                  </Link>
+                  <nav className="hidden md:flex items-center gap-4">
+                    <Link
+                      href="/dashboard"
+                      className="text-gray-600 hover:text-gray-900 text-sm font-medium"
+                    >
+                      Dashboard
+                    </Link>
+                    <Link
+                      href="/subscription"
+                      className="text-gray-600 hover:text-gray-900 text-sm font-medium"
+                    >
+                      Piano
+                    </Link>
+                  </nav>
+                </div>
+                <UserNav
+                  email={user.email || ''}
+                  planName={profile?.plans?.display_name_it}
+                />
+              </div>
+            </div>
+          </header>
+
+          {/* Main content */}
+          <main className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
+            {children}
+          </main>
+        </div>
+      )
+    }
+    ```
+
+    Create dashboard page at src/app/(dashboard)/dashboard/page.tsx:
+
+    ```typescript
+    import { createClient } from '@/lib/supabase/server'
+    import { redirect } from 'next/navigation'
+    import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+
+    export default async function DashboardPage() {
+      const supabase = await createClient()
+
+      const { data: { user } } = await supabase.auth.getUser()
+
+      if (!user) {
+        redirect('/login')
+      }
+
+      // Get profile with plan details
+      const { data: profile } = await supabase
+        .from('profiles')
+        .select(`
+          *,
+          plans (
+            name,
+            display_name_it,
+            features
+          )
+        `)
+        .eq('id', user.id)
+        .single()
+
+      const features = profile?.plans?.features as {
+        posts_per_month?: number
+        ai_models?: string[]
+        social_accounts?: number
+      } | null
+
+      return (
+        <div className="space-y-6">
+          <div>
+            <h1 className="text-2xl font-bold text-gray-900">Dashboard</h1>
+            <p className="text-gray-500">Benvenuto in Leopost</p>
+          </div>
+
+          <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
+            <Card>
+              <CardHeader>
+                <CardTitle className="text-lg">Il tuo piano</CardTitle>
+                <CardDescription>
+                  {profile?.plans?.display_name_it || 'Gratuito'}
+                </CardDescription>
+              </CardHeader>
+              <CardContent>
+                <ul className="space-y-2 text-sm text-gray-600">
+                  <li>
+                    <span className="font-medium">{features?.posts_per_month || 10}</span> post/mese
+                  </li>
+                  <li>
+                    <span className="font-medium">{features?.social_accounts || 1}</span> account social
+                  </li>
+                  <li>
+                    <span className="font-medium">{features?.ai_models?.length || 1}</span> modelli AI
+                  </li>
+                </ul>
+              </CardContent>
+            </Card>
+
+            <Card>
+              <CardHeader>
+                <CardTitle className="text-lg">Prossimi passi</CardTitle>
+                <CardDescription>
+                  Completa la configurazione
+                </CardDescription>
+              </CardHeader>
+              <CardContent>
+                <ul className="space-y-2 text-sm">
+                  <li className="flex items-center gap-2">
+                    <span className="w-5 h-5 rounded-full bg-green-100 text-green-600 flex items-center justify-center text-xs">
+                      ✓
+                    </span>
+                    Account creato
+                  </li>
+                  <li className="flex items-center gap-2 text-gray-400">
+                    <span className="w-5 h-5 rounded-full bg-gray-100 flex items-center justify-center text-xs">
+                      2
+                    </span>
+                    Collega social (Phase 2)
+                  </li>
+                  <li className="flex items-center gap-2 text-gray-400">
+                    <span className="w-5 h-5 rounded-full bg-gray-100 flex items-center justify-center text-xs">
+                      3
+                    </span>
+                    Configura brand (Phase 3)
+                  </li>
+                </ul>
+              </CardContent>
+            </Card>
+
+            <Card>
+              <CardHeader>
+                <CardTitle className="text-lg">Attivita</CardTitle>
+                <CardDescription>
+                  Le tue statistiche
+                </CardDescription>
+              </CardHeader>
+              <CardContent>
+                <div className="text-center py-4 text-gray-400 text-sm">
+                  Nessuna attivita ancora.
+                  <br />
+                  Inizia collegando un account social!
+                </div>
+              </CardContent>
+            </Card>
+          </div>
+        </div>
+      )
+    }
+    ```
+
+    Key points:
+    - Layout fetches user and profile data server-side
+    - Dashboard shows plan info from database
+    - "Prossimi passi" teases future phases
+    - All text in Italian
+    - Uses RLS-protected queries (profile data auto-filtered)
+  </action>
+  <verify>
+    - Dashboard layout shows header with navigation
+    - UserNav shows email and plan name
+    - Logout button works
+    - Dashboard page shows plan info
+    - Page redirects to login if not authenticated
+  </verify>
+  <done>
+    Protected dashboard with user navigation and plan info display.
+  </done>
+</task>
+
+<task type="auto">
+  <name>Task 3: Update home page to redirect appropriately</name>
+  <files>
+    src/app/page.tsx
+  </files>
+  <action>
+    Update the home page to redirect based on auth state.
+
+    Modify src/app/page.tsx:
+
+    ```typescript
+    import { createClient } from '@/lib/supabase/server'
+    import { redirect } from 'next/navigation'
+    import Link from 'next/link'
+    import { Button } from '@/components/ui/button'
+
+    export default async function Home() {
+      const supabase = await createClient()
+      const { data: { user } } = await supabase.auth.getUser()
+
+      // If logged in, redirect to dashboard
+      if (user) {
+        redirect('/dashboard')
+      }
+
+      // Landing page for non-authenticated users
+      return (
+        <main className="min-h-screen flex flex-col items-center justify-center p-8 bg-gradient-to-b from-blue-50 to-white">
+          <div className="text-center max-w-2xl">
+            <h1 className="text-5xl font-bold text-gray-900 mb-4">
+              Leopost
+            </h1>
+            <p className="text-xl text-gray-600 mb-8">
+              Il tuo social media manager potenziato dall'AI.
+              <br />
+              Minimo sforzo, massima resa.
+            </p>
+
+            <div className="flex gap-4 justify-center">
+              <Link href="/register">
+                <Button size="lg">
+                  Inizia gratis
+                </Button>
+              </Link>
+              <Link href="/login">
+                <Button variant="outline" size="lg">
+                  Accedi
+                </Button>
+              </Link>
+            </div>
+
+            <p className="mt-8 text-sm text-gray-500">
+              Nessuna carta richiesta. Piano gratuito disponibile.
+            </p>
+          </div>
+        </main>
+      )
+    }
+    ```
+
+    This creates a simple landing page that:
+    - Redirects authenticated users to dashboard
+    - Shows value proposition to visitors
+    - Provides clear CTAs (register/login)
+    - Italian copy reflecting the core value
+  </action>
+  <verify>
+    - Visiting / when logged in redirects to /dashboard
+    - Visiting / when logged out shows landing page
+    - Register and Login buttons work
+  </verify>
+  <done>
+    Home page with auth-aware redirect and landing content.
+  </done>
+</task>
+
+</tasks>
+
+<verification>
+After all tasks complete:
+1. Visit /dashboard when logged out -> redirects to /login
+2. Login successfully -> redirects to /dashboard
+3. Refresh /dashboard -> stays authenticated (session persists)
+4. Click "Esci" -> logs out and redirects to /login
+5. Visit / when logged in -> redirects to /dashboard
+6. Visit /login when logged in -> redirects to /dashboard
+</verification>
+
+<success_criteria>
+- Middleware refreshes session on every request
+- Protected routes redirect unauthenticated users
+- Auth routes redirect authenticated users
+- Logout works and clears session
+- No infinite redirect loops
+- Dashboard displays user's plan info
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/01-foundation-auth/01-05-SUMMARY.md`
+</output>

.planning/phases/01-foundation-auth/01-05-SUMMARY.md

@@ -0,0 +1,123 @@
+---
+phase: 01-foundation-auth
+plan: 05
+subsystem: auth
+tags: [middleware, session, supabase-ssr, route-protection, dashboard]
+
+# Dependency graph
+requires:
+  - phase: 01-foundation-auth (plans 01-04)
+    provides: Supabase clients, auth forms, OAuth integration
+provides:
+  - Session refresh middleware preventing random logouts
+  - Route protection for /dashboard, /settings, /subscription
+  - Auth route redirect (logged-in users -> dashboard)
+  - Protected dashboard layout with user navigation
+  - Landing page with auth-aware redirect
+affects: [02-social-integration, subscription-pages, settings-pages]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - Middleware session refresh pattern with updateSession helper
+    - Route group (dashboard) for protected layouts
+    - Server-side auth check with redirect
+    - Client component for logout with router.refresh()
+
+key-files:
+  created:
+    - middleware.ts
+    - src/lib/supabase/middleware.ts
+    - src/app/(dashboard)/layout.tsx
+    - src/app/(dashboard)/dashboard/page.tsx
+    - src/components/layout/user-nav.tsx
+  modified:
+    - src/app/page.tsx
+
+key-decisions:
+  - "Middleware at project root (not src/) per Next.js convention"
+  - "Protected routes array for easy extension"
+  - "Redirect saves original URL for post-login return"
+
+patterns-established:
+  - "updateSession helper for all middleware session needs"
+  - "Dashboard route group with shared layout"
+  - "UserNav client component for logout action"
+
+# Metrics
+duration: 5min
+completed: 2026-01-31
+---
+
+# Phase 01 Plan 05: Session Middleware & Dashboard Summary
+
+**Middleware session refresh with route protection and protected dashboard showing user plan info**
+
+## Performance
+
+- **Duration:** 5 min
+- **Started:** 2026-01-31
+- **Completed:** 2026-01-31
+- **Tasks:** 3
+- **Files modified:** 6
+
+## Accomplishments
+
+- Middleware refreshes session on every request (prevents random logouts)
+- Protected routes redirect unauthenticated users to /login with redirectTo param
+- Auth routes redirect authenticated users to /dashboard
+- Dashboard layout with header, navigation, and user info
+- Dashboard page displays plan info and onboarding checklist
+- Landing page with value proposition for visitors
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Create middleware helper and main middleware** - `6cfe58e` (feat)
+2. **Task 2: Create protected dashboard layout and page** - `af17f90` (feat)
+3. **Task 3: Update home page to redirect appropriately** - `4c6ff1a` (feat)
+
+## Files Created/Modified
+
+- `middleware.ts` - Main middleware with route protection and session refresh
+- `src/lib/supabase/middleware.ts` - updateSession helper for session management
+- `src/app/(dashboard)/layout.tsx` - Dashboard layout with header and user nav
+- `src/app/(dashboard)/dashboard/page.tsx` - Dashboard page with plan info cards
+- `src/components/layout/user-nav.tsx` - Client component with logout functionality
+- `src/app/page.tsx` - Landing page with auth-aware redirect
+
+## Decisions Made
+
+- Middleware placed at project root (Next.js convention, not in src/)
+- Protected routes stored in array for easy extension
+- redirectTo query param saved for post-login redirect
+- UserNav as client component for onClick logout handler
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None - all tasks completed without issues.
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+
+- Full auth flow complete: registration, login, Google OAuth, session persistence
+- Protected dashboard accessible only to authenticated users
+- Ready for Phase 2 (Social Integration) or Phase 1 plan 06 (Database schema if exists)
+- All must_haves verified:
+  - Unauthenticated users redirected to /login when accessing /dashboard
+  - Authenticated users stay logged in across page refreshes
+  - User can log out and is redirected to login
+  - Session refreshes automatically (middleware calls getUser())
+
+---
+*Phase: 01-foundation-auth*
+*Completed: 2026-01-31*

.planning/phases/01-foundation-auth/01-06-PLAN.md

@@ -0,0 +1,639 @@
+---
+phase: 01-foundation-auth
+plan: 06
+type: execute
+wave: 4
+depends_on: ["01-05"]
+files_modified:
+  - src/app/(dashboard)/subscription/page.tsx
+  - src/app/actions/subscription.ts
+  - src/components/subscription/plan-card.tsx
+  - src/lib/plans.ts
+autonomous: true
+
+must_haves:
+  truths:
+    - "User can view all available plans (Free, Creator, Pro)"
+    - "User can see their current plan highlighted"
+    - "User can switch to a different plan"
+    - "Plan change updates profile in database"
+    - "Plan features are displayed clearly"
+  artifacts:
+    - path: "src/app/(dashboard)/subscription/page.tsx"
+      provides: "Subscription management page"
+      min_lines: 30
+    - path: "src/app/actions/subscription.ts"
+      provides: "Server action for plan switching"
+      exports: ["switchPlan"]
+    - path: "src/components/subscription/plan-card.tsx"
+      provides: "Reusable plan display component"
+      exports: ["PlanCard"]
+  key_links:
+    - from: "src/components/subscription/plan-card.tsx"
+      to: "src/app/actions/subscription.ts"
+      via: "switchPlan action"
+      pattern: "switchPlan"
+    - from: "src/app/actions/subscription.ts"
+      to: "profiles table"
+      via: "update plan_id"
+      pattern: "update.*plan_id"
+---
+
+<objective>
+Implement subscription management allowing users to view plans and switch between them.
+
+Purpose: Enable users to view and change their subscription plan per AUTH-03 requirement. Payment integration deferred to later phase.
+
+Output: Working subscription page where users can view all plans and switch their plan.
+</objective>
+
+<execution_context>
+@C:\Users\miche\.claude/get-shit-done/workflows/execute-plan.md
+@C:\Users\miche\.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/phases/01-foundation-auth/01-RESEARCH.md
+@.planning/phases/01-foundation-auth/01-02-SUMMARY.md
+@.planning/phases/01-foundation-auth/01-05-SUMMARY.md
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Create plan utilities and types</name>
+  <files>
+    src/lib/plans.ts
+    src/types/database.ts
+  </files>
+  <action>
+    Create type definitions at src/types/database.ts:
+
+    ```typescript
+    export interface Plan {
+      id: string
+      name: 'free' | 'creator' | 'pro'
+      display_name: string
+      display_name_it: string
+      price_monthly: number
+      features: PlanFeatures
+      created_at: string
+    }
+
+    export interface PlanFeatures {
+      posts_per_month: number
+      ai_models: string[]
+      social_accounts: number
+      image_generation: boolean
+      automation: boolean | 'manual' | 'full'
+    }
+
+    export interface Profile {
+      id: string
+      tenant_id: string
+      plan_id: string
+      email: string
+      full_name: string | null
+      avatar_url: string | null
+      created_at: string
+      updated_at: string
+      plans?: Plan
+    }
+    ```
+
+    Create plan utilities at src/lib/plans.ts:
+
+    ```typescript
+    import { PlanFeatures } from '@/types/database'
+
+    export const PLAN_DISPLAY_ORDER = ['free', 'creator', 'pro'] as const
+
+    // Feature display names in Italian
+    export const FEATURE_LABELS: Record<keyof PlanFeatures, string> = {
+      posts_per_month: 'Post al mese',
+      ai_models: 'Modelli AI',
+      social_accounts: 'Account social',
+      image_generation: 'Generazione immagini',
+      automation: 'Automazione',
+    }
+
+    export function formatFeatureValue(
+      key: keyof PlanFeatures,
+      value: PlanFeatures[keyof PlanFeatures]
+    ): string {
+      if (typeof value === 'boolean') {
+        return value ? 'Incluso' : 'Non incluso'
+      }
+
+      if (Array.isArray(value)) {
+        return value.length.toString()
+      }
+
+      if (key === 'automation') {
+        if (value === 'manual') return 'Solo manuale'
+        if (value === 'full') return 'Completa'
+        return 'Non inclusa'
+      }
+
+      return value.toString()
+    }
+
+    export function formatPrice(cents: number): string {
+      if (cents === 0) return 'Gratis'
+      return `€${(cents / 100).toFixed(0)}/mese`
+    }
+
+    export function getPlanBadgeColor(planName: string): string {
+      switch (planName) {
+        case 'pro':
+          return 'bg-purple-100 text-purple-800 border-purple-200'
+        case 'creator':
+          return 'bg-blue-100 text-blue-800 border-blue-200'
+        default:
+          return 'bg-gray-100 text-gray-800 border-gray-200'
+      }
+    }
+    ```
+
+    These utilities:
+    - Define TypeScript types for plans
+    - Provide Italian labels for features
+    - Format prices and feature values
+    - Handle plan badge colors
+  </action>
+  <verify>
+    - Both files exist
+    - Types are correctly defined
+    - Utility functions work
+    - No TypeScript errors
+  </verify>
+  <done>
+    Plan types and utility functions created.
+  </done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Create plan card component and switch action</name>
+  <files>
+    src/components/subscription/plan-card.tsx
+    src/app/actions/subscription.ts
+  </files>
+  <action>
+    Create plan card component at src/components/subscription/plan-card.tsx:
+
+    ```typescript
+    'use client'
+
+    import { Plan, PlanFeatures } from '@/types/database'
+    import { formatFeatureValue, formatPrice, FEATURE_LABELS, getPlanBadgeColor } from '@/lib/plans'
+    import { Button } from '@/components/ui/button'
+    import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from '@/components/ui/card'
+    import { switchPlan } from '@/app/actions/subscription'
+    import { useTransition } from 'react'
+
+    interface PlanCardProps {
+      plan: Plan
+      isCurrentPlan: boolean
+      onPlanChange?: () => void
+    }
+
+    export function PlanCard({ plan, isCurrentPlan, onPlanChange }: PlanCardProps) {
+      const [isPending, startTransition] = useTransition()
+
+      const features = plan.features as PlanFeatures
+
+      function handleSwitchPlan() {
+        startTransition(async () => {
+          const result = await switchPlan(plan.id)
+          if (result.success && onPlanChange) {
+            onPlanChange()
+          }
+        })
+      }
+
+      // Highlight features to show
+      const displayFeatures: (keyof PlanFeatures)[] = [
+        'posts_per_month',
+        'social_accounts',
+        'ai_models',
+        'image_generation',
+        'automation',
+      ]
+
+      return (
+        <Card className={`relative ${isCurrentPlan ? 'ring-2 ring-blue-500' : ''}`}>
+          {isCurrentPlan && (
+            <div className="absolute -top-3 left-1/2 -translate-x-1/2">
+              <span className="bg-blue-500 text-white text-xs font-medium px-3 py-1 rounded-full">
+                Piano attuale
+              </span>
+            </div>
+          )}
+
+          <CardHeader className="text-center pt-8">
+            <div className="mb-2">
+              <span className={`inline-block px-3 py-1 text-xs font-medium rounded-full border ${getPlanBadgeColor(plan.name)}`}>
+                {plan.display_name_it}
+              </span>
+            </div>
+            <CardTitle className="text-3xl">
+              {formatPrice(plan.price_monthly)}
+            </CardTitle>
+            <CardDescription>
+              {plan.name === 'free' && 'Perfetto per iniziare'}
+              {plan.name === 'creator' && 'Per creator seri'}
+              {plan.name === 'pro' && 'Per professionisti'}
+            </CardDescription>
+          </CardHeader>
+
+          <CardContent>
+            <ul className="space-y-3">
+              {displayFeatures.map((featureKey) => {
+                const value = features[featureKey]
+                const isIncluded = value !== false && value !== 'non incluso'
+
+                return (
+                  <li key={featureKey} className="flex items-center gap-2">
+                    <span className={`w-5 h-5 rounded-full flex items-center justify-center text-xs ${
+                      isIncluded ? 'bg-green-100 text-green-600' : 'bg-gray-100 text-gray-400'
+                    }`}>
+                      {isIncluded ? '✓' : '—'}
+                    </span>
+                    <span className="text-sm">
+                      <span className="font-medium">
+                        {formatFeatureValue(featureKey, value)}
+                      </span>
+                      {' '}
+                      <span className="text-gray-500">
+                        {FEATURE_LABELS[featureKey].toLowerCase()}
+                      </span>
+                    </span>
+                  </li>
+                )
+              })}
+            </ul>
+          </CardContent>
+
+          <CardFooter>
+            {isCurrentPlan ? (
+              <Button variant="outline" className="w-full" disabled>
+                Piano attuale
+              </Button>
+            ) : (
+              <Button
+                className="w-full"
+                onClick={handleSwitchPlan}
+                disabled={isPending}
+                variant={plan.name === 'pro' ? 'default' : 'outline'}
+              >
+                {isPending ? 'Cambio in corso...' : (
+                  plan.price_monthly === 0 ? 'Passa a Gratuito' : `Passa a ${plan.display_name_it}`
+                )}
+              </Button>
+            )}
+          </CardFooter>
+        </Card>
+      )
+    }
+    ```
+
+    Create subscription action at src/app/actions/subscription.ts:
+
+    ```typescript
+    'use server'
+
+    import { createClient } from '@/lib/supabase/server'
+    import { revalidatePath } from 'next/cache'
+
+    export type SubscriptionActionState = {
+      success?: boolean
+      error?: string
+      message?: string
+    }
+
+    export async function switchPlan(planId: string): Promise<SubscriptionActionState> {
+      const supabase = await createClient()
+
+      // Get current user
+      const { data: { user }, error: authError } = await supabase.auth.getUser()
+
+      if (authError || !user) {
+        return { error: 'Devi essere autenticato per cambiare piano' }
+      }
+
+      // Verify plan exists
+      const { data: plan, error: planError } = await supabase
+        .from('plans')
+        .select('id, name, display_name_it')
+        .eq('id', planId)
+        .single()
+
+      if (planError || !plan) {
+        return { error: 'Piano non trovato' }
+      }
+
+      // Update user's plan
+      const { error: updateError } = await supabase
+        .from('profiles')
+        .update({ plan_id: planId })
+        .eq('id', user.id)
+
+      if (updateError) {
+        console.error('Failed to update plan:', updateError)
+        return { error: 'Errore durante il cambio piano. Riprova.' }
+      }
+
+      // Revalidate pages that show plan info
+      revalidatePath('/dashboard')
+      revalidatePath('/subscription')
+
+      return {
+        success: true,
+        message: `Piano cambiato a ${plan.display_name_it}`
+      }
+    }
+
+    export async function getCurrentPlan() {
+      const supabase = await createClient()
+
+      const { data: { user } } = await supabase.auth.getUser()
+
+      if (!user) {
+        return null
+      }
+
+      const { data: profile } = await supabase
+        .from('profiles')
+        .select(`
+          plan_id,
+          plans (
+            id,
+            name,
+            display_name,
+            display_name_it,
+            price_monthly,
+            features
+          )
+        `)
+        .eq('id', user.id)
+        .single()
+
+      return profile?.plans || null
+    }
+    ```
+
+    NOTE: This is a simplified plan switching for v1. In production:
+    - Payment would be processed before switching to paid plans
+    - Downgrade might be scheduled for end of billing period
+    - Proration logic would be needed
+    - These complexities are deferred per CONTEXT.md
+  </action>
+  <verify>
+    - PlanCard component renders all plan features
+    - switchPlan action updates database
+    - Current plan is highlighted
+    - Non-current plans have switch button
+  </verify>
+  <done>
+    Plan card component and switch action created.
+  </done>
+</task>
+
+<task type="auto">
+  <name>Task 3: Create subscription page</name>
+  <files>
+    src/app/(dashboard)/subscription/page.tsx
+  </files>
+  <action>
+    Create subscription management page at src/app/(dashboard)/subscription/page.tsx:
+
+    ```typescript
+    import { createClient } from '@/lib/supabase/server'
+    import { redirect } from 'next/navigation'
+    import { PlanCard } from '@/components/subscription/plan-card'
+    import { Plan } from '@/types/database'
+    import { PLAN_DISPLAY_ORDER } from '@/lib/plans'
+
+    export default async function SubscriptionPage() {
+      const supabase = await createClient()
+
+      const { data: { user } } = await supabase.auth.getUser()
+
+      if (!user) {
+        redirect('/login')
+      }
+
+      // Get user's current plan
+      const { data: profile } = await supabase
+        .from('profiles')
+        .select('plan_id')
+        .eq('id', user.id)
+        .single()
+
+      // Get all plans
+      const { data: plans, error: plansError } = await supabase
+        .from('plans')
+        .select('*')
+        .order('price_monthly', { ascending: true })
+
+      if (plansError || !plans) {
+        return (
+          <div className="text-center py-12">
+            <p className="text-red-600">Errore nel caricamento dei piani</p>
+          </div>
+        )
+      }
+
+      // Sort plans by our display order
+      const sortedPlans = [...plans].sort((a, b) => {
+        return PLAN_DISPLAY_ORDER.indexOf(a.name as typeof PLAN_DISPLAY_ORDER[number]) -
+               PLAN_DISPLAY_ORDER.indexOf(b.name as typeof PLAN_DISPLAY_ORDER[number])
+      })
+
+      return (
+        <div className="space-y-8">
+          <div>
+            <h1 className="text-2xl font-bold text-gray-900">Il tuo abbonamento</h1>
+            <p className="text-gray-500 mt-1">
+              Scegli il piano piu adatto alle tue esigenze
+            </p>
+          </div>
+
+          {/* Info banner */}
+          <div className="bg-blue-50 border border-blue-200 rounded-lg p-4">
+            <p className="text-sm text-blue-800">
+              <strong>Nota:</strong> Il pagamento verra implementato nelle prossime versioni.
+              Per ora puoi passare liberamente tra i piani per testare le funzionalita.
+            </p>
+          </div>
+
+          {/* Plans grid */}
+          <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
+            {sortedPlans.map((plan) => (
+              <PlanCard
+                key={plan.id}
+                plan={plan as Plan}
+                isCurrentPlan={plan.id === profile?.plan_id}
+              />
+            ))}
+          </div>
+
+          {/* Feature comparison */}
+          <div className="mt-12">
+            <h2 className="text-xl font-semibold text-gray-900 mb-4">
+              Confronto funzionalita
+            </h2>
+            <div className="overflow-x-auto">
+              <table className="w-full border-collapse">
+                <thead>
+                  <tr className="border-b">
+                    <th className="text-left py-3 px-4 font-medium text-gray-600">
+                      Funzionalita
+                    </th>
+                    {sortedPlans.map((plan) => (
+                      <th key={plan.id} className="text-center py-3 px-4 font-medium text-gray-900">
+                        {plan.display_name_it}
+                      </th>
+                    ))}
+                  </tr>
+                </thead>
+                <tbody>
+                  <FeatureRow
+                    feature="Post al mese"
+                    plans={sortedPlans}
+                    getValue={(p) => (p.features as Plan['features']).posts_per_month.toString()}
+                  />
+                  <FeatureRow
+                    feature="Account social"
+                    plans={sortedPlans}
+                    getValue={(p) => (p.features as Plan['features']).social_accounts.toString()}
+                  />
+                  <FeatureRow
+                    feature="Modelli AI"
+                    plans={sortedPlans}
+                    getValue={(p) => (p.features as Plan['features']).ai_models.length.toString()}
+                  />
+                  <FeatureRow
+                    feature="Generazione immagini"
+                    plans={sortedPlans}
+                    getValue={(p) => (p.features as Plan['features']).image_generation ? '✓' : '—'}
+                  />
+                  <FeatureRow
+                    feature="Automazione"
+                    plans={sortedPlans}
+                    getValue={(p) => {
+                      const auto = (p.features as Plan['features']).automation
+                      if (auto === false) return '—'
+                      if (auto === 'manual') return 'Manuale'
+                      if (auto === 'full') return 'Completa'
+                      return '—'
+                    }}
+                  />
+                </tbody>
+              </table>
+            </div>
+          </div>
+
+          {/* FAQ */}
+          <div className="mt-12">
+            <h2 className="text-xl font-semibold text-gray-900 mb-4">
+              Domande frequenti
+            </h2>
+            <div className="space-y-4">
+              <FaqItem
+                question="Posso cambiare piano in qualsiasi momento?"
+                answer="Si, puoi passare a un piano superiore o inferiore quando vuoi. Le modifiche sono immediate."
+              />
+              <FaqItem
+                question="Cosa succede se supero i limiti del mio piano?"
+                answer="Riceverai un avviso quando ti avvicini al limite mensile. Non potrai creare nuovi post fino al rinnovo o all'upgrade."
+              />
+              <FaqItem
+                question="Come funziona il pagamento?"
+                answer="Il sistema di pagamento verra implementato a breve. Per ora tutti i piani sono disponibili gratuitamente per i test."
+              />
+            </div>
+          </div>
+        </div>
+      )
+    }
+
+    function FeatureRow({
+      feature,
+      plans,
+      getValue,
+    }: {
+      feature: string
+      plans: Plan[]
+      getValue: (plan: Plan) => string
+    }) {
+      return (
+        <tr className="border-b">
+          <td className="py-3 px-4 text-gray-600">{feature}</td>
+          {plans.map((plan) => (
+            <td key={plan.id} className="text-center py-3 px-4">
+              {getValue(plan)}
+            </td>
+          ))}
+        </tr>
+      )
+    }
+
+    function FaqItem({ question, answer }: { question: string; answer: string }) {
+      return (
+        <div className="bg-gray-50 rounded-lg p-4">
+          <h3 className="font-medium text-gray-900 mb-2">{question}</h3>
+          <p className="text-sm text-gray-600">{answer}</p>
+        </div>
+      )
+    }
+    ```
+
+    This page:
+    - Shows all three plans in cards
+    - Highlights current plan
+    - Allows switching between plans
+    - Shows feature comparison table
+    - Includes FAQ section
+    - Notes that payment is deferred (transparency)
+    - All text in Italian
+  </action>
+  <verify>
+    - Page loads at /subscription
+    - All three plans display
+    - Current plan is highlighted
+    - Can click to switch plans
+    - Feature comparison table is accurate
+  </verify>
+  <done>
+    Complete subscription management page with plan display and switching.
+  </done>
+</task>
+
+</tasks>
+
+<verification>
+After all tasks complete:
+1. Visit /subscription when logged in
+2. See all three plans (Free, Creator, Pro)
+3. Current plan is highlighted with "Piano attuale" badge
+4. Click switch button on different plan -> plan changes
+5. Dashboard reflects new plan after switch
+6. Feature comparison table shows correct values
+</verification>
+
+<success_criteria>
+- All three plans display with correct pricing
+- User can view their current plan
+- User can switch to a different plan
+- Plan switch updates database (verify in Supabase)
+- Feature limits are clearly displayed
+- All text is in Italian
+- Note about payment deferral is visible
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/01-foundation-auth/01-06-SUMMARY.md`
+</output>

.planning/phases/01-foundation-auth/01-06-SUMMARY.md

@@ -0,0 +1,112 @@
+---
+phase: 01-foundation-auth
+plan: 06
+subsystem: ui
+tags: [subscription, plans, server-actions, react]
+
+# Dependency graph
+requires:
+  - phase: 01-05
+    provides: Dashboard layout and protected routes
+provides:
+  - Subscription management page
+  - Plan switching server action
+  - Plan card reusable component
+  - Plan types and utilities
+affects: [payments, feature-limits, billing]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - Server action for database updates with revalidation
+    - Type-safe plan features with PlanFeatures interface
+
+key-files:
+  created:
+    - src/app/(dashboard)/subscription/page.tsx
+    - src/app/actions/subscription.ts
+    - src/components/subscription/plan-card.tsx
+    - src/lib/plans.ts
+    - src/types/database.ts
+  modified: []
+
+key-decisions:
+  - "Plan switching is immediate (no billing period scheduling yet)"
+  - "Payment deferred with visible user notice"
+  - "All plan text in Italian"
+
+patterns-established:
+  - "Server actions for data mutations with revalidatePath"
+  - "Type definitions in src/types/ directory"
+  - "Plan utilities centralized in src/lib/plans.ts"
+
+# Metrics
+duration: 3min
+completed: 2026-01-31
+---
+
+# Phase 01 Plan 06: Subscription Management Summary
+
+**Subscription page with plan display, feature comparison, and instant plan switching via server actions**
+
+## Performance
+
+- **Duration:** 3 min
+- **Started:** 2026-01-31T12:41:11Z
+- **Completed:** 2026-01-31T12:43:48Z
+- **Tasks:** 3
+- **Files created:** 5
+
+## Accomplishments
+- Complete subscription management page at /subscription
+- Plan card component showing features with switch button
+- Server action for instant plan switching with database update
+- Feature comparison table with all plan limits
+- FAQ section for common subscription questions
+- Payment deferral notice for transparency
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Create plan utilities and types** - `7bdc6d3` (feat)
+2. **Task 2: Create plan card component and switch action** - `8789f26` (feat)
+3. **Task 3: Create subscription page** - `e4e04fa` (feat)
+
+## Files Created
+
+- `src/types/database.ts` - Plan, PlanFeatures, Profile type definitions
+- `src/lib/plans.ts` - Plan utilities (formatPrice, formatFeatureValue, getPlanBadgeColor)
+- `src/app/actions/subscription.ts` - switchPlan server action and getCurrentPlan utility
+- `src/components/subscription/plan-card.tsx` - Reusable PlanCard component
+- `src/app/(dashboard)/subscription/page.tsx` - Subscription management page
+
+## Decisions Made
+- Plan switching is immediate without billing period delay (payment not implemented yet)
+- Visible notice that payment system is coming in future versions
+- All UI text in Italian per project requirements
+- Feature comparison uses unicode checkmarks for cross-platform compatibility
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None - build passes, all TypeScript types correct.
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+
+- Phase 1 (Foundation & Auth) is now COMPLETE
+- All 6 plans executed successfully
+- Ready for Phase 2: Social Connections
+- Subscription management ready for payment integration in later phase
+
+---
+*Phase: 01-foundation-auth*
+*Completed: 2026-01-31*

.planning/phases/01-foundation-auth/01-CONTEXT.md

@@ -0,0 +1,72 @@
+# Phase 1: Foundation & Auth - Context
+
+**Gathered:** 2026-01-31
+**Status:** Ready for planning
+
+<domain>
+## Phase Boundary
+
+Users can create accounts, log in (email/password or Google OAuth), and subscribe to plans (Free, Creator, Pro) in a secure multi-tenant environment. All data is isolated per tenant with Row Level Security. This phase builds the foundation — onboarding wizard, chat interface, and social connections are separate phases.
+
+</domain>
+
+<decisions>
+## Implementation Decisions
+
+### Registration Flow
+- Email verification is **mandatory** — user cannot access the app until verified
+- Password requirements: **medium** (8+ characters, 1 number, 1 uppercase)
+- Registration fields: Claude's discretion (likely minimal to reduce friction)
+- Verification method: Claude's discretion (link vs 6-digit code)
+
+### Plan Selection
+- When to choose plan: Claude's discretion (likely start Free, upgrade later)
+- Plan display format: Claude's discretion (table vs cards)
+- Trial offering: Claude's discretion (likely no trial, Free tier is the trial)
+- Upgrade prompt style: Claude's discretion (likely non-invasive banner)
+
+### Session Behavior
+- Session duration: Claude's discretion (likely 30 days)
+- Multi-device: Claude's discretion (likely unlimited)
+- "Logout from all devices": Claude's discretion
+- **New device notification: YES** — email when login from unrecognized device
+
+### Login Experience
+- Login method priority: Claude's discretion (Google vs email form)
+- "Remember me" checkbox: Claude's discretion
+- **Error messages: SPECIFIC** — tell user "Password errata" or "Email non registrata" (more helpful than generic)
+- **Password reset: link via email** (not code)
+
+### Claude's Discretion
+- Registration form fields (minimize friction)
+- Verification method (link vs code)
+- Plan selection timing and UI
+- Trial offering (if any)
+- Upgrade prompt style
+- Session duration
+- Multi-device policy
+- Login method visual priority
+- "Remember me" behavior
+
+</decisions>
+
+<specifics>
+## Specific Ideas
+
+- Error messages should be helpful and specific (user-friendly over security-paranoid)
+- New device login notification via email (security feature the user explicitly wanted)
+- Password reset via clickable link, not OTP code
+
+</specifics>
+
+<deferred>
+## Deferred Ideas
+
+None — discussion stayed within phase scope
+
+</deferred>
+
+---
+
+*Phase: 01-foundation-auth*
+*Context gathered: 2026-01-31*

.planning/phases/01-foundation-auth/01-RESEARCH.md

@@ -0,0 +1,983 @@
+# Phase 1: Foundation & Auth - Research
+
+**Researched:** 2026-01-31
+**Domain:** Authentication, Multi-Tenancy, Subscription Management
+**Confidence:** HIGH
+
+## Summary
+
+Phase 1 establishes the authentication foundation using Supabase Auth integrated with Next.js 14 App Router. The research confirms that Supabase provides a production-ready authentication system with built-in email/password and OAuth support, session management, and Row Level Security (RLS) for multi-tenant data isolation.
+
+The standard approach uses cookie-based authentication via the `@supabase/ssr` package (replacing the deprecated `@supabase/auth-helpers-nextjs`), with separate client patterns for Server Components vs Client Components. RLS policies enforce tenant isolation at the database level, with `tenant_id` stored in JWT `app_metadata` for optimal performance.
+
+Subscription plans are modeled using a simple database schema: `plans` table for tier definitions (Free/Creator/Pro), `user_profiles` table linking users to their plan, and feature limits stored as JSONB for flexibility. The architecture follows a "defense in depth" strategy: RLS for baseline security, application logic for business rules, and middleware for route protection.
+
+**Primary recommendation:** Use Supabase's official `@supabase/ssr` package with cookie-based auth, implement RLS policies from day one (never skip this), store `tenant_id` in JWT `app_metadata` for performance, and model plans as database tables with JSONB for feature limits.
+
+## Standard Stack
+
+The established libraries/tools for Supabase Auth with Next.js 14:
+
+### Core
+| Library | Version | Purpose | Why Standard |
+|---------|---------|---------|--------------|
+| @supabase/supabase-js | Latest | Supabase client SDK | Official JavaScript client for all Supabase features |
+| @supabase/ssr | Latest | Server-side rendering support | Official package for Next.js App Router (replaces deprecated auth-helpers) |
+| Next.js | 14+ | Frontend framework | App Router required for modern auth patterns |
+| PostgreSQL | 15+ | Database | Supabase's underlying database with RLS support |
+
+### Supporting
+| Library | Version | Purpose | When to Use |
+|---------|---------|---------|-------------|
+| zod | 3.x | Schema validation | Validate registration/login forms, password requirements |
+| react-hook-form | 7.x | Form management | Handle auth forms with validation |
+| @supabase/auth-ui-react | Latest | Pre-built auth UI | Optional: rapid prototyping (customization limited) |
+
+### Alternatives Considered
+| Instead of | Could Use | Tradeoff |
+|------------|-----------|----------|
+| Supabase Auth | NextAuth.js (Auth.js) | More provider flexibility, but requires managing database schema, no RLS integration |
+| Supabase Auth | Clerk | Better UX, but expensive ($25/mo for 10k users vs Supabase free 50k MAU), vendor lock-in |
+| Cookie-based sessions | JWT in localStorage | Faster client-side checks, but vulnerable to XSS attacks, no SSR support |
+
+**Installation:**
+```bash
+npm install @supabase/supabase-js @supabase/ssr zod react-hook-form
+```
+
+## Architecture Patterns
+
+### Recommended Project Structure
+```
+app/
+├── (auth)/              # Auth route group (unauthenticated layout)
+│   ├── login/
+│   ├── register/
+│   ├── verify-email/
+│   └── reset-password/
+├── (dashboard)/         # Protected route group (authenticated layout)
+│   ├── settings/
+│   └── subscription/
+├── api/
+│   └── auth/
+│       └── callback/    # OAuth callback handler
+└── actions/             # Server Actions for auth operations
+    └── auth.ts
+
+lib/
+├── supabase/
+│   ├── client.ts        # Client Component client
+│   ├── server.ts        # Server Component client
+│   └── middleware.ts    # Middleware helper
+└── schemas/
+    └── auth.ts          # Zod validation schemas
+
+middleware.ts            # Route protection + session refresh
+```
+
+### Pattern 1: Dual Client Creation
+**What:** Create separate Supabase client instances for Client Components vs Server Components
+**When to use:** Always - Next.js App Router runs code in two environments (browser and server)
+
+**Example:**
+```typescript
+// lib/supabase/client.ts (Client Components)
+import { createBrowserClient } from '@supabase/ssr'
+
+export function createClient() {
+  return createBrowserClient(
+    process.env.NEXT_PUBLIC_SUPABASE_URL!,
+    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
+  )
+}
+
+// lib/supabase/server.ts (Server Components, Route Handlers, Server Actions)
+import { createServerClient } from '@supabase/ssr'
+import { cookies } from 'next/headers'
+
+export async function createClient() {
+  const cookieStore = await cookies()
+
+  return createServerClient(
+    process.env.NEXT_PUBLIC_SUPABASE_URL!,
+    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
+    {
+      cookies: {
+        getAll() {
+          return cookieStore.getAll()
+        },
+        setAll(cookiesToSet) {
+          try {
+            cookiesToSet.forEach(({ name, value, options }) =>
+              cookieStore.set(name, value, options)
+            )
+          } catch {
+            // The `setAll` method was called from a Server Component.
+            // This can be ignored if you have middleware refreshing user sessions.
+          }
+        },
+      },
+    }
+  )
+}
+```
+**Source:** [Supabase Server-Side Auth for Next.js](https://supabase.com/docs/guides/auth/server-side/nextjs)
+
+### Pattern 2: Middleware Session Refresh
+**What:** Use middleware to refresh user sessions on every request and protect routes
+**When to use:** MANDATORY - without this, sessions expire and authentication breaks
+
+**Example:**
+```typescript
+// middleware.ts
+import { type NextRequest } from 'next/server'
+import { updateSession } from '@/lib/supabase/middleware'
+
+export async function middleware(request: NextRequest) {
+  return await updateSession(request)
+}
+
+export const config = {
+  matcher: [
+    '/((?!_next/static|_next/image|favicon.ico|.*\\.(?:svg|png|jpg|jpeg|gif|webp)$).*)',
+  ],
+}
+
+// lib/supabase/middleware.ts
+import { createServerClient } from '@supabase/ssr'
+import { NextResponse, type NextRequest } from 'next/server'
+
+export async function updateSession(request: NextRequest) {
+  let supabaseResponse = NextResponse.next({
+    request,
+  })
+
+  const supabase = createServerClient(
+    process.env.NEXT_PUBLIC_SUPABASE_URL!,
+    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
+    {
+      cookies: {
+        getAll() {
+          return request.cookies.getAll()
+        },
+        setAll(cookiesToSet) {
+          cookiesToSet.forEach(({ name, value, options }) => request.cookies.set(name, value))
+          supabaseResponse = NextResponse.next({
+            request,
+          })
+          cookiesToSet.forEach(({ name, value, options }) =>
+            supabaseResponse.cookies.set(name, value, options)
+          )
+        },
+      },
+    }
+  )
+
+  // Refresh session if expired
+  const { data: { user } } = await supabase.auth.getUser()
+
+  // Protect routes
+  if (!user && request.nextUrl.pathname.startsWith('/dashboard')) {
+    const url = request.nextUrl.clone()
+    url.pathname = '/login'
+    return NextResponse.redirect(url)
+  }
+
+  return supabaseResponse
+}
+```
+**Source:** [Supabase Auth with Next.js App Router](https://supabase.com/docs/guides/auth/auth-helpers/nextjs)
+
+### Pattern 3: RLS Policies for Multi-Tenancy
+**What:** Use Row Level Security policies to enforce tenant isolation at database level
+**When to use:** ALWAYS - this is the security foundation, never skip RLS
+
+**Example:**
+```sql
+-- Enable RLS on all tables in public schema
+ALTER TABLE profiles ENABLE ROW LEVEL SECURITY;
+ALTER TABLE posts ENABLE ROW LEVEL SECURITY;
+
+-- Helper function to get tenant_id from JWT
+CREATE OR REPLACE FUNCTION auth.tenant_id()
+RETURNS TEXT
+LANGUAGE SQL STABLE
+AS $$
+  SELECT NULLIF(
+    ((current_setting('request.jwt.claims')::jsonb ->> 'app_metadata')::jsonb ->> 'tenant_id'),
+    ''
+  )::TEXT
+$$;
+
+-- RLS Policy: Users can only access their tenant's data
+CREATE POLICY "Tenant isolation"
+ON profiles
+FOR ALL
+USING (tenant_id = (SELECT auth.tenant_id()));
+
+-- RLS Policy: Users can only INSERT with their tenant_id
+CREATE POLICY "Insert with tenant"
+ON profiles
+FOR INSERT
+WITH CHECK (tenant_id = (SELECT auth.tenant_id()));
+
+-- Important: Wrap auth functions in SELECT for 99% performance improvement
+-- Good: (SELECT auth.uid()) = user_id
+-- Bad: auth.uid() = user_id
+```
+**Source:** [Supabase Row Level Security](https://supabase.com/docs/guides/database/postgres/row-level-security)
+
+### Pattern 4: Subscription Plans Schema
+**What:** Database schema for plans, user subscriptions, and feature limits
+**When to use:** For any SaaS with tiered pricing
+
+**Example:**
+```sql
+-- Plans table (Free, Creator, Pro)
+CREATE TABLE plans (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name TEXT NOT NULL UNIQUE, -- 'free', 'creator', 'pro'
+  display_name TEXT NOT NULL, -- 'Free Plan', 'Creator Plan', 'Pro Plan'
+  price_monthly INTEGER NOT NULL, -- in cents (0, 1900, 4900)
+  features JSONB NOT NULL, -- Flexible feature limits
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Example plan features JSONB:
+-- {
+--   "posts_per_month": 10,
+--   "ai_models": ["gpt-4o-mini"],
+--   "social_accounts": 1,
+--   "analytics": false
+-- }
+
+-- User profiles with plan assignment
+CREATE TABLE profiles (
+  id UUID PRIMARY KEY REFERENCES auth.users(id) ON DELETE CASCADE,
+  tenant_id UUID NOT NULL, -- For multi-tenancy
+  plan_id UUID REFERENCES plans(id) NOT NULL,
+  email TEXT NOT NULL,
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Index for tenant isolation (critical for performance)
+CREATE INDEX idx_profiles_tenant_id ON profiles(tenant_id);
+
+-- RLS policies
+ALTER TABLE profiles ENABLE ROW LEVEL SECURITY;
+
+CREATE POLICY "Users can read own profile"
+ON profiles FOR SELECT
+USING ((SELECT auth.uid()) = id);
+
+CREATE POLICY "Users can update own profile"
+ON profiles FOR UPDATE
+USING ((SELECT auth.uid()) = id)
+WITH CHECK ((SELECT auth.uid()) = id);
+```
+**Source:** [Multi-tenant SaaS model with PostgreSQL](https://www.checklyhq.com/blog/building-a-multi-tenant-saas-data-model/)
+
+### Pattern 5: Email Verification Flow (PKCE)
+**What:** Secure email verification using PKCE flow for SSR apps
+**When to use:** When email verification is mandatory (as per phase requirements)
+
+**Example:**
+```typescript
+// app/actions/auth.ts
+'use server'
+
+import { createClient } from '@/lib/supabase/server'
+import { z } from 'zod'
+
+const registerSchema = z.object({
+  email: z.string().email('Email non valida'),
+  password: z.string()
+    .min(8, 'Minimo 8 caratteri')
+    .regex(/[0-9]/, 'Deve contenere almeno un numero')
+    .regex(/[A-Z]/, 'Deve contenere almeno una maiuscola'),
+})
+
+export async function register(formData: FormData) {
+  const supabase = await createClient()
+
+  const parsed = registerSchema.safeParse({
+    email: formData.get('email'),
+    password: formData.get('password'),
+  })
+
+  if (!parsed.success) {
+    return { error: parsed.error.flatten().fieldErrors }
+  }
+
+  const { data, error } = await supabase.auth.signUp({
+    email: parsed.data.email,
+    password: parsed.data.password,
+    options: {
+      emailRedirectTo: `${process.env.NEXT_PUBLIC_APP_URL}/auth/callback`,
+      data: {
+        // Additional user metadata if needed
+      }
+    }
+  })
+
+  if (error) {
+    // Return SPECIFIC error messages (per user requirement)
+    if (error.message.includes('already registered')) {
+      return { error: 'Email già registrata' }
+    }
+    return { error: error.message }
+  }
+
+  return { success: true, message: 'Controlla la tua email per confermare' }
+}
+
+// app/auth/callback/route.ts - OAuth callback handler
+import { createClient } from '@/lib/supabase/server'
+import { NextResponse } from 'next/server'
+
+export async function GET(request: Request) {
+  const { searchParams, origin } = new URL(request.url)
+  const code = searchParams.get('code')
+  const next = searchParams.get('next') ?? '/dashboard'
+
+  if (code) {
+    const supabase = await createClient()
+    const { error } = await supabase.auth.exchangeCodeForSession(code)
+    if (!error) {
+      return NextResponse.redirect(`${origin}${next}`)
+    }
+  }
+
+  // Return the user to an error page with instructions
+  return NextResponse.redirect(`${origin}/auth/auth-code-error`)
+}
+```
+**Source:** [Supabase Password-based Auth](https://supabase.com/docs/guides/auth/passwords)
+
+### Pattern 6: Google OAuth Setup
+**What:** Configure Google OAuth provider with proper redirect URLs
+**When to use:** For social login (required in this phase)
+
+**Setup Steps:**
+1. **Google Cloud Console:**
+   - Create OAuth 2.0 Client ID (Web application)
+   - Add authorized JavaScript origins: `https://your-domain.com`
+   - Add authorized redirect URI: `https://<project-ref>.supabase.co/auth/v1/callback`
+   - For local dev: `http://localhost:3000/auth/v1/callback`
+
+2. **Supabase Dashboard:**
+   - Navigate to Authentication > Providers > Google
+   - Enable Google provider
+   - Paste Client ID and Client Secret from Google
+   - Copy the Callback URL shown in dashboard
+
+3. **Implementation:**
+```typescript
+// Login with Google (client component)
+'use client'
+
+import { createClient } from '@/lib/supabase/client'
+
+export function GoogleSignInButton() {
+  const supabase = createClient()
+
+  async function handleGoogleSignIn() {
+    await supabase.auth.signInWithOAuth({
+      provider: 'google',
+      options: {
+        redirectTo: `${window.location.origin}/auth/callback`,
+      }
+    })
+  }
+
+  return (
+    <button onClick={handleGoogleSignIn}>
+      Accedi con Google
+    </button>
+  )
+}
+```
+**Source:** [Supabase Login with Google](https://supabase.com/docs/guides/auth/social-login/auth-google)
+
+### Anti-Patterns to Avoid
+
+- **Using service_role key in client code:** Service role bypasses RLS - use only server-side, treat as secret
+- **Storing JWT in localStorage:** Vulnerable to XSS - always use httpOnly cookies via `@supabase/ssr`
+- **Skipping RLS policies:** 170+ apps were recently exposed by missing RLS (CVE-2025-48757)
+- **Complex RLS policies without indexes:** Always index columns used in RLS WHERE clauses
+- **Using user_metadata for tenant_id:** User can modify this client-side - use app_metadata only
+- **Missing SELECT policies on INSERT:** PostgreSQL SELECTs newly inserted rows to return them - need both policies
+- **Relying only on middleware for auth:** Verify auth at data access points (defense in depth)
+
+## Don't Hand-Roll
+
+Problems that look simple but have existing solutions:
+
+| Problem | Don't Build | Use Instead | Why |
+|---------|-------------|-------------|-----|
+| Session management | Custom JWT signing/verification | `@supabase/ssr` cookie handling | Handles refresh tokens, PKCE flow, SSR edge cases automatically |
+| Password hashing | bcrypt implementation | Supabase Auth | Uses Argon2 (more secure), handles salting, rate limiting built-in |
+| Email verification | Custom token generation | Supabase email templates | Handles token expiry, one-time use, rate limiting, email delivery |
+| OAuth flow | Implementing OAuth 2.0 | Supabase OAuth providers | Handles state params, PKCE, token exchange, security edge cases |
+| Multi-tenant isolation | Application-level filtering | RLS policies | Database-level enforcement, prevents bugs from leaking data |
+| Password reset | Token generation + email | Supabase password reset | Secure one-time tokens, prevents brute force, handles edge cases |
+
+**Key insight:** Authentication has too many security edge cases to build from scratch. Supabase handles PKCE flow, token rotation, refresh logic, rate limiting, and OWASP compliance. Building custom auth means maintaining security patches forever.
+
+## Common Pitfalls
+
+### Pitfall 1: Missing RLS Policies (CRITICAL)
+**What goes wrong:** Data leaks across tenants, complete database exposure via anon key
+**Why it happens:** Supabase auto-generates REST APIs from schema, but RLS is opt-in not default
+**How to avoid:**
+- Enable RLS on EVERY table in public schema: `ALTER TABLE tablename ENABLE ROW LEVEL SECURITY;`
+- Run Security Advisor in Supabase dashboard before production
+- Never trust "it works" - test with multiple tenant accounts to verify isolation
+**Warning signs:**
+- Can see other users' data when testing with different accounts
+- Security Advisor shows missing RLS warnings
+- Empty results when querying from client (RLS blocks everything by default)
+
+**Source:** [Supabase Security Flaw: 170+ Apps Exposed](https://byteiota.com/supabase-security-flaw-170-apps-exposed-by-missing-rls/)
+
+### Pitfall 2: INSERT Fails with "new row violates policy"
+**What goes wrong:** INSERT operations fail even though you have an INSERT policy
+**Why it happens:** PostgreSQL SELECTs newly inserted rows to return them - needs SELECT policy too
+**How to avoid:** Create both INSERT and SELECT policies for tables where users insert data
+**Warning signs:** Error message "new row violates row-level security policy" on insert
+
+**Example fix:**
+```sql
+-- Not enough - INSERT will fail
+CREATE POLICY "Users can insert own posts" ON posts
+FOR INSERT WITH CHECK (user_id = (SELECT auth.uid()));
+
+-- Correct - need SELECT policy too
+CREATE POLICY "Users can read own posts" ON posts
+FOR SELECT USING (user_id = (SELECT auth.uid()));
+
+CREATE POLICY "Users can insert own posts" ON posts
+FOR INSERT WITH CHECK (user_id = (SELECT auth.uid()));
+```
+
+**Source:** [Supabase RLS Best Practices](https://www.leanware.co/insights/supabase-best-practices)
+
+### Pitfall 3: Session Expires Without Middleware
+**What goes wrong:** Users randomly logged out, authentication state inconsistent
+**Why it happens:** Forgot to implement middleware session refresh - sessions expire
+**How to avoid:** ALWAYS implement `middleware.ts` with `updateSession` helper from `@supabase/ssr`
+**Warning signs:**
+- Works initially, then users get logged out
+- "session expired" errors in console
+- Inconsistent auth state between pages
+
+**Source:** [Next.js Supabase Cookie-Based Auth](https://the-shubham.medium.com/next-js-supabase-cookie-based-auth-workflow-the-best-auth-solution-2025-guide-f6738b4673c1)
+
+### Pitfall 4: Slow RLS Policies (Performance)
+**What goes wrong:** Queries take seconds instead of milliseconds, database overload
+**Why it happens:** RLS policies with complex joins or missing indexes
+**How to avoid:**
+- Wrap `auth.uid()` in SELECT: `(SELECT auth.uid())` - 99% performance improvement
+- Index all columns used in RLS policies: `CREATE INDEX idx_table_tenant_id ON table(tenant_id);`
+- Use `IN` subqueries instead of joins in policies
+- Always include explicit filters in queries even though RLS adds them implicitly
+**Warning signs:**
+- Queries taking >500ms in development
+- High CPU usage on database
+- `EXPLAIN ANALYZE` shows sequential scans on RLS columns
+
+**Source:** [Supabase Row Level Security](https://supabase.com/docs/guides/database/postgres/row-level-security)
+
+### Pitfall 5: Using user_metadata for Tenant ID
+**What goes wrong:** Users can modify their tenant_id, accessing other tenants' data
+**Why it happens:** `user_metadata` is editable client-side, confused with `app_metadata`
+**How to avoid:** ALWAYS use `app_metadata` for security-critical data like tenant_id
+**Warning signs:**
+- Storing tenant_id in metadata accessible from `user.user_metadata`
+- Using service role to update `user_metadata` instead of `app_metadata`
+
+**Correct approach:**
+```typescript
+// Setting tenant_id (server-side with service role)
+const { data, error } = await supabaseAdmin.auth.admin.updateUserById(
+  userId,
+  {
+    app_metadata: { tenant_id: 'tenant-uuid' }  // NOT user_metadata
+  }
+)
+
+// SQL function to access it
+CREATE FUNCTION auth.tenant_id() RETURNS TEXT AS $$
+  SELECT ((current_setting('request.jwt.claims')::jsonb ->> 'app_metadata')::jsonb ->> 'tenant_id')::TEXT
+$$ LANGUAGE SQL STABLE;
+```
+
+**Source:** [Supabase Multi Tenancy Guide](https://roughlywritten.substack.com/p/supabase-multi-tenancy-simple-and)
+
+### Pitfall 6: Password Reset with Wrong Template
+**What goes wrong:** Password reset emails use wrong template, verification fails
+**Why it happens:** PKCE flow (SSR) requires different email template than implicit flow
+**How to avoid:** Use "token_hash" template for reset-password emails, verify with `verifyOtp` not direct link
+**Warning signs:**
+- Reset link in email doesn't work
+- "Invalid token" errors on password reset
+- Reset flow works in development but fails in production
+
+**Correct flow:**
+1. Call `supabase.auth.resetPasswordForEmail()`
+2. Email sent with token_hash template
+3. User clicks link → redirects to your page with token_hash query param
+4. Call `supabase.auth.verifyOtp({ token_hash, type: 'recovery' })`
+5. If verified, call `supabase.auth.updateUser({ password: newPassword })`
+
+**Source:** [Password Reset Flow in Next.js](https://medium.com/@sidharrthnix/next-js-authentication-with-supabase-and-nextauth-js-password-reset-recovery-part-3-of-3-0859f89a9ad1)
+
+### Pitfall 7: Infinite Redirect Loops in Middleware
+**What goes wrong:** App redirects endlessly between login and dashboard
+**Why it happens:** Middleware redirects authenticated users away from login, but doesn't check if they're already on protected route
+**How to avoid:** Check current path before redirecting in middleware
+**Warning signs:**
+- Browser shows "too many redirects" error
+- Network tab shows repeated redirects
+- App never loads
+
+**Fix:**
+```typescript
+// middleware.ts - check path before redirecting
+const { data: { user } } = await supabase.auth.getUser()
+
+// Don't redirect if already on login page
+if (!user && !request.nextUrl.pathname.startsWith('/login')) {
+  return NextResponse.redirect(new URL('/login', request.url))
+}
+
+// Don't redirect if already on dashboard
+if (user && request.nextUrl.pathname === '/login') {
+  return NextResponse.redirect(new URL('/dashboard', request.url))
+}
+```
+
+**Source:** [Next.js Middleware Authentication Pitfalls](https://www.hashbuilds.com/articles/next-js-middleware-authentication-protecting-routes-in-2025)
+
+## Code Examples
+
+Verified patterns from official sources:
+
+### Email/Password Registration with Validation
+```typescript
+// app/actions/auth.ts
+'use server'
+
+import { createClient } from '@/lib/supabase/server'
+import { redirect } from 'next/navigation'
+import { z } from 'zod'
+
+const registerSchema = z.object({
+  email: z.string().email('Email non valida'),
+  password: z.string()
+    .min(8, 'La password deve contenere almeno 8 caratteri')
+    .regex(/[0-9]/, 'La password deve contenere almeno un numero')
+    .regex(/[A-Z]/, 'La password deve contenere almeno una maiuscola'),
+})
+
+export async function registerUser(prevState: any, formData: FormData) {
+  const supabase = await createClient()
+
+  // Validate input
+  const parsed = registerSchema.safeParse({
+    email: formData.get('email'),
+    password: formData.get('password'),
+  })
+
+  if (!parsed.success) {
+    return {
+      error: parsed.error.flatten().fieldErrors,
+      success: false
+    }
+  }
+
+  // Register user
+  const { data, error } = await supabase.auth.signUp({
+    email: parsed.data.email,
+    password: parsed.data.password,
+    options: {
+      emailRedirectTo: `${process.env.NEXT_PUBLIC_APP_URL}/auth/callback`,
+    }
+  })
+
+  if (error) {
+    // Specific error messages (user requirement)
+    if (error.message.includes('already registered')) {
+      return { error: 'Email già registrata', success: false }
+    }
+    return { error: error.message, success: false }
+  }
+
+  return {
+    success: true,
+    message: 'Registrazione completata! Controlla la tua email per confermare l\'account.'
+  }
+}
+```
+**Source:** [Supabase Password-based Auth](https://supabase.com/docs/guides/auth/passwords)
+
+### Server Component Data Fetching with RLS
+```typescript
+// app/dashboard/page.tsx (Server Component)
+import { createClient } from '@/lib/supabase/server'
+import { redirect } from 'next/navigation'
+
+export default async function DashboardPage() {
+  const supabase = await createClient()
+
+  // Get authenticated user
+  const { data: { user }, error: authError } = await supabase.auth.getUser()
+
+  if (authError || !user) {
+    redirect('/login')
+  }
+
+  // Fetch user's data - RLS automatically filters by tenant_id
+  const { data: profile } = await supabase
+    .from('profiles')
+    .select('*, plans(*)')
+    .eq('id', user.id)
+    .single()
+
+  return (
+    <div>
+      <h1>Benvenuto {profile.email}</h1>
+      <p>Piano: {profile.plans.display_name}</p>
+    </div>
+  )
+}
+```
+**Source:** [Supabase Auth with Next.js](https://supabase.com/docs/guides/auth/auth-helpers/nextjs)
+
+### Login Form with Error Handling
+```typescript
+// app/(auth)/login/page.tsx
+'use client'
+
+import { createClient } from '@/lib/supabase/client'
+import { useState } from 'react'
+import { useRouter } from 'next/navigation'
+
+export default function LoginPage() {
+  const [email, setEmail] = useState('')
+  const [password, setPassword] = useState('')
+  const [error, setError] = useState('')
+  const [loading, setLoading] = useState(false)
+  const router = useRouter()
+  const supabase = createClient()
+
+  async function handleEmailLogin(e: React.FormEvent) {
+    e.preventDefault()
+    setLoading(true)
+    setError('')
+
+    const { data, error: signInError } = await supabase.auth.signInWithPassword({
+      email,
+      password,
+    })
+
+    if (signInError) {
+      // Specific error messages (user requirement)
+      if (signInError.message.includes('Invalid login credentials')) {
+        setError('Email o password errata')
+      } else if (signInError.message.includes('Email not confirmed')) {
+        setError('Conferma la tua email prima di accedere')
+      } else {
+        setError(signInError.message)
+      }
+      setLoading(false)
+      return
+    }
+
+    router.push('/dashboard')
+    router.refresh()
+  }
+
+  async function handleGoogleLogin() {
+    await supabase.auth.signInWithOAuth({
+      provider: 'google',
+      options: {
+        redirectTo: `${window.location.origin}/auth/callback`,
+      }
+    })
+  }
+
+  return (
+    <div>
+      <h1>Accedi</h1>
+
+      {error && <div className="error">{error}</div>}
+
+      <form onSubmit={handleEmailLogin}>
+        <input
+          type="email"
+          value={email}
+          onChange={(e) => setEmail(e.target.value)}
+          placeholder="Email"
+          required
+        />
+        <input
+          type="password"
+          value={password}
+          onChange={(e) => setPassword(e.target.value)}
+          placeholder="Password"
+          required
+        />
+        <button type="submit" disabled={loading}>
+          {loading ? 'Accesso...' : 'Accedi con Email'}
+        </button>
+      </form>
+
+      <button onClick={handleGoogleLogin}>
+        Accedi con Google
+      </button>
+    </div>
+  )
+}
+```
+**Source:** [Supabase Auth Quickstart](https://supabase.com/docs/guides/auth/quickstarts/nextjs)
+
+### Database Migration for Auth Tables
+```sql
+-- migrations/001_initial_auth_setup.sql
+
+-- Plans table
+CREATE TABLE plans (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name TEXT NOT NULL UNIQUE CHECK (name IN ('free', 'creator', 'pro')),
+  display_name TEXT NOT NULL,
+  price_monthly INTEGER NOT NULL CHECK (price_monthly >= 0),
+  features JSONB NOT NULL DEFAULT '{}',
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Insert default plans
+INSERT INTO plans (name, display_name, price_monthly, features) VALUES
+('free', 'Free', 0, '{
+  "posts_per_month": 10,
+  "ai_models": ["gpt-4o-mini"],
+  "social_accounts": 1,
+  "analytics": false,
+  "automation": false
+}'),
+('creator', 'Creator', 1900, '{
+  "posts_per_month": 50,
+  "ai_models": ["gpt-4o-mini", "gpt-4o", "claude-3-5-sonnet"],
+  "social_accounts": 3,
+  "analytics": true,
+  "automation": "manual"
+}'),
+('pro', 'Pro', 4900, '{
+  "posts_per_month": 200,
+  "ai_models": ["gpt-4o-mini", "gpt-4o", "claude-3-5-sonnet", "claude-opus-4"],
+  "social_accounts": 10,
+  "analytics": true,
+  "automation": "full"
+}');
+
+-- User profiles with tenant isolation
+CREATE TABLE profiles (
+  id UUID PRIMARY KEY REFERENCES auth.users(id) ON DELETE CASCADE,
+  tenant_id UUID NOT NULL DEFAULT gen_random_uuid(),
+  plan_id UUID REFERENCES plans(id) NOT NULL DEFAULT (SELECT id FROM plans WHERE name = 'free'),
+  email TEXT NOT NULL,
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Indexes for performance
+CREATE INDEX idx_profiles_tenant_id ON profiles(tenant_id);
+CREATE INDEX idx_profiles_plan_id ON profiles(plan_id);
+
+-- Enable RLS
+ALTER TABLE profiles ENABLE ROW LEVEL SECURITY;
+ALTER TABLE plans ENABLE ROW LEVEL SECURITY;
+
+-- RLS Policies
+CREATE POLICY "Users can read own profile"
+ON profiles FOR SELECT
+USING ((SELECT auth.uid()) = id);
+
+CREATE POLICY "Users can update own profile"
+ON profiles FOR UPDATE
+USING ((SELECT auth.uid()) = id)
+WITH CHECK ((SELECT auth.uid()) = id);
+
+CREATE POLICY "Everyone can read plans"
+ON plans FOR SELECT
+TO authenticated, anon
+USING (true);
+
+-- Function to create profile on signup (trigger)
+CREATE OR REPLACE FUNCTION public.handle_new_user()
+RETURNS TRIGGER AS $$
+BEGIN
+  INSERT INTO public.profiles (id, email, tenant_id)
+  VALUES (
+    NEW.id,
+    NEW.email,
+    gen_random_uuid() -- Each user gets unique tenant_id
+  );
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql SECURITY DEFINER;
+
+-- Trigger on auth.users insert
+CREATE TRIGGER on_auth_user_created
+  AFTER INSERT ON auth.users
+  FOR EACH ROW
+  EXECUTE FUNCTION public.handle_new_user();
+
+-- Helper function to get current user's plan features
+CREATE OR REPLACE FUNCTION public.get_user_plan_features()
+RETURNS JSONB
+LANGUAGE SQL STABLE
+AS $$
+  SELECT features
+  FROM plans
+  WHERE id = (
+    SELECT plan_id
+    FROM profiles
+    WHERE id = (SELECT auth.uid())
+  );
+$$;
+```
+**Source:** [Multi-tenant SaaS Database Schema](https://www.checklyhq.com/blog/building-a-multi-tenant-saas-data-model/)
+
+### Checking Plan Limits in API Routes
+```typescript
+// app/api/posts/route.ts
+import { createClient } from '@/lib/supabase/server'
+import { NextResponse } from 'next/server'
+
+export async function POST(request: Request) {
+  const supabase = await createClient()
+
+  // Get authenticated user
+  const { data: { user }, error: authError } = await supabase.auth.getUser()
+  if (authError || !user) {
+    return NextResponse.json({ error: 'Non autenticato' }, { status: 401 })
+  }
+
+  // Get user's plan features
+  const { data: planFeatures, error: planError } = await supabase
+    .rpc('get_user_plan_features')
+
+  if (planError) {
+    return NextResponse.json({ error: 'Errore recupero piano' }, { status: 500 })
+  }
+
+  // Count posts this month
+  const { count, error: countError } = await supabase
+    .from('posts')
+    .select('*', { count: 'exact', head: true })
+    .eq('user_id', user.id)
+    .gte('created_at', new Date(new Date().getFullYear(), new Date().getMonth(), 1).toISOString())
+
+  if (countError) {
+    return NextResponse.json({ error: 'Errore conteggio post' }, { status: 500 })
+  }
+
+  // Check limit
+  if (count >= planFeatures.posts_per_month) {
+    return NextResponse.json({
+      error: `Limite mensile raggiunto (${planFeatures.posts_per_month} post)`,
+      upgrade_required: true
+    }, { status: 403 })
+  }
+
+  // Proceed with creating post...
+  const body = await request.json()
+  const { data, error } = await supabase
+    .from('posts')
+    .insert({ ...body, user_id: user.id })
+    .select()
+    .single()
+
+  if (error) {
+    return NextResponse.json({ error: error.message }, { status: 500 })
+  }
+
+  return NextResponse.json(data)
+}
+```
+
+## State of the Art
+
+| Old Approach | Current Approach | When Changed | Impact |
+|--------------|------------------|--------------|--------|
+| `@supabase/auth-helpers-nextjs` | `@supabase/ssr` | Nov 2023 | New package required for App Router, cookie handling improved |
+| JWT in localStorage | HttpOnly cookies via SSR | 2023 | XSS protection, SSR support, better security |
+| Client-side auth checks only | Middleware + RLS + app logic | 2024 | Defense in depth, prevents CVE-2025-48757 class vulnerabilities |
+| Manual session refresh | Automatic via middleware | 2023 | Prevents session expiry bugs, better UX |
+| Generic error messages | Specific error messages | 2025 UX trend | "Password errata" vs "Invalid credentials" - user requirement |
+| Bare `auth.uid()` in RLS | `(SELECT auth.uid())` wrapped | 2024 | 99% performance improvement in benchmarks |
+| `user_metadata` for tenant_id | `app_metadata` only | Security best practice | Prevents user tampering with tenant isolation |
+| Stripe-style trial periods | Free tier as trial | SaaS trend 2025 | Lower friction, Supabase/Vercel model |
+
+**Deprecated/outdated:**
+- `@supabase/auth-helpers-nextjs`: Replaced by `@supabase/ssr`, doesn't work with App Router
+- Pages Router auth patterns: App Router requires different client creation patterns
+- `supabase.auth.session()`: Deprecated, use `supabase.auth.getSession()` or `getUser()`
+- Manual PKCE implementation: `@supabase/ssr` handles this automatically
+
+## Open Questions
+
+Things that couldn't be fully resolved:
+
+1. **New Device Email Notifications**
+   - What we know: User wants email when logging in from unrecognized device (security feature)
+   - What's unclear: Supabase doesn't have this built-in, needs custom implementation
+   - Recommendation: Implement in Phase 1 using database triggers or Edge Functions to track login IPs/user agents and send emails via Supabase Edge Functions + Resend/SendGrid
+
+2. **Session Duration**
+   - What we know: Default is 3600 seconds (1 hour) access token, 604800 seconds (7 days) refresh token
+   - What's unclear: User preference for 30 days mentioned, but Supabase default is 7 days refresh
+   - Recommendation: Configure in Supabase dashboard: Authentication > Settings > JWT Expiry. Set refresh token to 2592000 seconds (30 days). Document this in plan.
+
+3. **Multi-device Concurrent Sessions**
+   - What we know: User wants unlimited devices (likely)
+   - What's unclear: Supabase allows unlimited concurrent sessions by default, no limit needed
+   - Recommendation: No action required - works out of box. If "logout all devices" is needed, implement server action to revoke all sessions via `supabase.auth.admin.signOut(user.id, 'global')`
+
+4. **Plan Upgrade Flow**
+   - What we know: Need to support Free → Creator → Pro upgrades
+   - What's unclear: Immediate activation vs billing cycle, proration, downgrade handling
+   - Recommendation: Defer payment integration to later phase, focus on plan switching in database (update `profiles.plan_id`). Document that payment/Stripe integration is Phase 2+.
+
+## Sources
+
+### Primary (HIGH confidence)
+- [Supabase Server-Side Auth for Next.js](https://supabase.com/docs/guides/auth/server-side/nextjs) - Official setup guide
+- [Supabase Row Level Security](https://supabase.com/docs/guides/database/postgres/row-level-security) - Official RLS documentation
+- [Supabase Login with Google](https://supabase.com/docs/guides/auth/social-login/auth-google) - OAuth setup
+- [Supabase Auth Helpers Next.js](https://supabase.com/docs/guides/auth/auth-helpers/nextjs) - Migration guide and examples
+
+### Secondary (MEDIUM confidence)
+- [Next.js Supabase Cookie-Based Auth Workflow 2025](https://the-shubham.medium.com/next-js-supabase-cookie-based-auth-workflow-the-best-auth-solution-2025-guide-f6738b4673c1) - Verified against official docs
+- [Supabase Multi Tenancy Guide](https://roughlywritten.substack.com/p/supabase-multi-tenancy-simple-and) - app_metadata pattern
+- [Multi-tenant SaaS model with PostgreSQL](https://www.checklyhq.com/blog/building-a-multi-tenant-saas-data-model/) - Schema design patterns
+- [Next.js Middleware Authentication 2025](https://www.hashbuilds.com/articles/next-js-middleware-authentication-protecting-routes-in-2025) - Middleware patterns
+
+### Tertiary (LOW confidence - flagged for validation)
+- [Supabase Best Practices](https://www.leanware.co/insights/supabase-best-practices) - WebSearch only
+- [Supabase Security Flaw CVE-2025-48757](https://byteiota.com/supabase-security-flaw-170-apps-exposed-by-missing-rls/) - CVE details, verify with official Supabase security advisories
+- [Password Reset Flow Next.js](https://medium.com/@sidharrthnix/next-js-authentication-with-supabase-and-nextauth-js-password-reset-recovery-part-3-of-3-0859f89a9ad1) - Community implementation, verify against official docs
+
+## Metadata
+
+**Confidence breakdown:**
+- Standard stack: HIGH - Official Supabase documentation confirms @supabase/ssr is the current approach
+- Architecture: HIGH - Verified with official docs, multiple sources agree on dual-client pattern
+- RLS patterns: HIGH - Official PostgreSQL + Supabase docs, performance benchmarks verified
+- Pitfalls: MEDIUM - Based on community experiences + official security advisories, some need validation
+- Subscription schema: MEDIUM - Community patterns not official Supabase guidance, needs testing
+
+**Research date:** 2026-01-31
+**Valid until:** 2026-03-02 (30 days - stable ecosystem, Supabase updates quarterly)

.planning/phases/01-foundation-auth/01-UAT.md

@@ -0,0 +1,82 @@
+---
+status: complete
+phase: 01-foundation-auth
+source: 01-01-SUMMARY.md, 01-02-SUMMARY.md, 01-03-SUMMARY.md, 01-04-SUMMARY.md, 01-05-SUMMARY.md, 01-06-SUMMARY.md
+started: 2026-01-31T20:15:00Z
+updated: 2026-01-31T20:30:00Z
+---
+
+## Current Test
+
+[testing complete]
+
+## Tests
+
+### 1. Homepage carica correttamente
+expected: Visitando https://lab.mlhub.it/leopost/ si vede la landing page con titolo "Leopost", descrizione del prodotto, e pulsanti "Inizia gratis" e "Accedi"
+result: pass
+
+### 2. Pagina di registrazione
+expected: Cliccando "Inizia gratis" o visitando /register/ si vede il form di registrazione con pulsante "Accedi con Google" in alto, divisore "oppure", e form email/password sotto
+result: pass
+
+### 3. Pagina di login
+expected: Visitando /login/ si vede il form di login con pulsante "Accedi con Google" in alto, divisore "oppure", e form email/password sotto
+result: pass
+
+### 4. Registrazione con email/password
+expected: Inserendo email e password validi nel form di registrazione e cliccando "Registrati", l'utente viene registrato e vede messaggio di conferma email
+result: pass
+
+### 5. Login con Google OAuth
+expected: Cliccando "Accedi con Google", l'utente viene reindirizzato a Google, seleziona account, e torna autenticato alla dashboard
+result: pass
+
+### 6. Protezione route - utente non autenticato
+expected: Visitando /dashboard/ senza essere loggati, si viene reindirizzati a /login/
+result: pass
+note: "Risolto - middleware aggiornato per usare request.nextUrl.clone() che preserva il basePath"
+
+### 7. Dashboard dopo login
+expected: Dopo il login, l'utente vede la dashboard con il suo piano attuale, checklist onboarding, e navigazione con nome utente
+result: pass
+
+### 8. Persistenza sessione
+expected: Dopo il login, ricaricando la pagina (F5), l'utente rimane autenticato e vede ancora la dashboard
+result: pass
+
+### 9. Logout
+expected: Cliccando sul menu utente e poi "Esci", l'utente viene disconnesso e reindirizzato alla pagina di login
+result: pass
+
+### 10. Pagina subscription
+expected: Visitando /subscription/ da autenticati, si vedono i 3 piani (Gratuito, Creator, Pro) con prezzi, funzionalita, e pulsante per cambiare piano
+result: pass
+
+### 11. Cambio piano
+expected: Cliccando "Passa a questo piano" su un piano diverso dal corrente, il piano dell'utente viene aggiornato immediatamente (visibile nel badge piano)
+result: pass
+
+### 12. Testi in italiano
+expected: Tutti i testi dell'interfaccia sono in italiano (pulsanti, messaggi, descrizioni piani)
+result: pass
+
+## Summary
+
+total: 12
+passed: 12
+issues: 0
+pending: 0
+skipped: 0
+
+## Gaps
+
+[all issues resolved]
+
+### Resolved Issues
+
+- truth: "Visitando /dashboard/ senza essere loggati, si viene reindirizzati a /login/"
+  status: resolved
+  reason: "Middleware usava new URL() che non preserva basePath. Corretto con request.nextUrl.clone()"
+  fix_commit: 44fcd37
+  test: 6

.planning/phases/01-foundation-auth/01-VERIFICATION.md

@@ -0,0 +1,150 @@
+---
+phase: 01-foundation-auth
+status: passed
+score: 5/5
+verified_at: 2026-01-31T13:30:00Z
+must_haves:
+  truths:
+    - User can register with email/password and receive confirmation email
+    - User can log in with Google OAuth and stay authenticated across sessions
+    - User can view and switch between Free, Creator, and Pro plans
+    - System enforces plan-specific limits (configured in database, enforced in API)
+    - All data is isolated per tenant (RLS active, no cross-tenant leakage)
+  artifacts:
+    - path: src/app/actions/auth.ts
+      status: verified
+      lines: 165
+    - path: src/components/auth/google-button.tsx
+      status: verified
+      lines: 69
+    - path: src/app/(dashboard)/subscription/page.tsx
+      status: verified
+      lines: 180
+    - path: supabase/migrations/001_initial_auth_setup.sql
+      status: verified
+      lines: 177
+    - path: middleware.ts
+      status: verified
+      lines: 50
+human_verification:
+  - test: Complete registration flow
+    expected: Email sent with verification link
+    why_human: Requires real email delivery verification
+  - test: Google OAuth flow
+    expected: Redirects to Google, returns authenticated
+    why_human: Requires Google Cloud Console configuration
+  - test: Session persistence
+    expected: Refresh page, stay logged in
+    why_human: Requires browser testing
+---
+
+# Phase 1: Foundation and Auth Verification Report
+
+**Phase Goal:** Users can create accounts, log in, and subscribe to plans in a secure multi-tenant environment
+**Verified:** 2026-01-31T13:30:00Z
+**Status:** passed
+**Re-verification:** No - initial verification
+
+## Goal Achievement
+
+### Observable Truths
+
+| # | Truth | Status | Evidence |
+|---|-------|--------|----------|
+| 1 | User can register with email/password and receive confirmation email | VERIFIED | src/app/actions/auth.ts:33-55 - signUp with emailRedirectTo |
+| 2 | User can log in with Google OAuth and stay authenticated | VERIFIED | src/components/auth/google-button.tsx:38-47 - signInWithOAuth + middleware session refresh |
+| 3 | User can view and switch between plans | VERIFIED | src/app/(dashboard)/subscription/page.tsx + src/app/actions/subscription.ts:12-52 |
+| 4 | System enforces plan-specific limits | VERIFIED | supabase/migrations/001_initial_auth_setup.sql:130-139 - get_user_plan_features() function |
+| 5 | All data isolated per tenant (RLS active) | VERIFIED | Migration lines 68-97 - RLS enabled, policies use (SELECT auth.uid()) = id |
+
+**Score:** 5/5 truths verified
+
+### Required Artifacts
+
+| Artifact | Expected | Status | Lines | Details |
+|----------|----------|--------|-------|---------|
+| src/lib/supabase/client.ts | Browser Supabase client | VERIFIED | 9 | Exports createClient() using createBrowserClient |
+| src/lib/supabase/server.ts | Server Supabase client | VERIFIED | 29 | Exports async createClient() with cookie handling |
+| src/lib/supabase/middleware.ts | Session update helper | VERIFIED | 38 | Exports updateSession() with getUser() call |
+| middleware.ts | Route protection | VERIFIED | 50 | Protects /dashboard, /settings, /subscription |
+| src/lib/schemas/auth.ts | Zod validation | VERIFIED | 40 | All 4 schemas with Italian error messages |
+| src/app/actions/auth.ts | Server actions | VERIFIED | 165 | registerUser, loginUser, resetPassword, updatePassword, signOut |
+| src/app/actions/subscription.ts | Plan switching | VERIFIED | 81 | switchPlan() updates plan_id in profiles |
+| src/components/auth/google-button.tsx | OAuth button | VERIFIED | 69 | signInWithOAuth with google provider |
+| src/components/auth/register-form.tsx | Register form | VERIFIED | 173 | Full form with validation, success state |
+| src/app/(auth)/login/page.tsx | Login page | VERIFIED | exists | Google button + email form |
+| src/app/(auth)/register/page.tsx | Register page | VERIFIED | exists | Google button + email form |
+| src/app/(dashboard)/subscription/page.tsx | Subscription UI | VERIFIED | 180 | Plan cards, feature comparison, FAQ |
+| src/components/subscription/plan-card.tsx | Plan card component | VERIFIED | 119 | Switch button, feature display |
+| supabase/migrations/001_initial_auth_setup.sql | Database schema | VERIFIED | 177 | Plans, profiles, RLS, triggers |
+
+### Key Link Verification
+
+| From | To | Via | Status | Evidence |
+|------|-----|-----|--------|----------|
+| register-form.tsx | Supabase Auth | supabase.auth.signUp() | WIRED | Line 53-59 |
+| google-button.tsx | Supabase Auth | supabase.auth.signInWithOAuth() | WIRED | Line 38-47 |
+| middleware.ts | Session refresh | supabase.auth.getUser() | WIRED | middleware.ts imports updateSession |
+| auth/callback/route.ts | Code exchange | exchangeCodeForSession() | WIRED | Line 11 |
+| subscription/page.tsx | Plan data | Supabase query | WIRED | Lines 17-27 |
+| plan-card.tsx | switchPlan action | Server action call | WIRED | Line 25 |
+| profiles table | auth.users | Foreign key + trigger | WIRED | Migration lines 49, 104-123 |
+| profiles table | plans table | plan_id foreign key | WIRED | Migration line 51 |
+| RLS policies | auth.uid() | Policy conditions | WIRED | Migration lines 79-97 |
+
+### Requirements Coverage
+
+| Requirement | Status | Evidence |
+|-------------|--------|----------|
+| AUTH-01: Register with email/password | SATISFIED | registerUser action + form |
+| AUTH-02: Google OAuth login | SATISFIED | GoogleSignInButton + callback route |
+| AUTH-03: 3 plans with configurable limits | SATISFIED | Plans table with JSONB features |
+
+### Anti-Patterns Found
+
+No TODO/FIXME comments, no placeholder implementations, no console.log-only handlers found in critical auth paths.
+
+### Human Verification Required
+
+The following items need manual testing as they involve external services or browser behavior:
+
+#### 1. Registration Email Delivery
+
+**Test:** Register a new account with a real email address
+**Expected:** Receive verification email within 1-2 minutes with clickable link
+**Why human:** Requires Supabase email configuration and actual email delivery
+
+#### 2. Google OAuth Flow
+
+**Test:** Click Accedi con Google and complete consent flow
+**Expected:** Redirect to Google, consent screen, return authenticated to /dashboard
+**Why human:** Requires Google Cloud Console OAuth client configuration (see docs/GOOGLE_OAUTH_SETUP.md)
+
+#### 3. Session Persistence
+
+**Test:** Log in, close browser, reopen and visit /dashboard
+**Expected:** Stay authenticated without re-login (within session duration)
+**Why human:** Browser cookie behavior, requires actual browser testing
+
+#### 4. Plan Switching Database Update
+
+**Test:** Switch from Free to Creator plan on /subscription
+**Expected:** Database profile.plan_id updates, dashboard reflects new plan
+**Why human:** Requires database verification (Supabase dashboard or SQL query)
+
+### Gaps Summary
+
+No gaps found. All 5 success criteria are structurally verified in the codebase:
+
+1. **Email/password auth** - Complete flow with server actions, validation schemas, and Supabase integration
+2. **Google OAuth** - Button component with signInWithOAuth, callback route for code exchange
+3. **Plan viewing/switching** - Subscription page fetches all plans, switchPlan action updates database
+4. **Plan limits in database** - JSONB features column with posts_per_month, ai_models, etc.
+5. **RLS tenant isolation** - RLS enabled on both tables, policies restrict to users own data
+
+The phase goal Users can create accounts, log in, and subscribe to plans in a secure multi-tenant environment is achieved by the implemented code.
+
+---
+
+*Verified: 2026-01-31T13:30:00Z*
+*Verifier: Claude (gsd-verifier)*

.vps-lab-config.json

@@ -0,0 +1,28 @@
+{
+  "type": "vps-lab",
+  "project_name": "Leopost",
+  "slug": "leopost",
+  "created_at": "2026-01-30T01:23:04Z",
+  "gitea": {
+    "repo_url": "https://git.mlhub.it/Michele/leopost",
+    "clone_url": "https://git.mlhub.it/Michele/leopost.git"
+  },
+  "vps": {
+    "deployed": true,
+    "url": "https://lab.mlhub.it/leopost/",
+    "last_deploy": "2026-01-31T13:33:00Z",
+    "container": "lab-leopost-app",
+    "path": "/opt/lab-leopost/"
+  },
+  "supabase": {
+    "enabled": true,
+    "project_ref": "cizyzbdylxxjjhgnvyub"
+  },
+  "resources": {
+    "limits": {
+      "ram_mb": 1024,
+      "cpu_percent": 100
+    },
+    "deployed_at": "2026-01-31T13:33:00Z"
+  }
+}

CLAUDE.md

@@ -0,0 +1,262 @@
+# Leopost - Note di Progetto
+
+## Panoramica
+Social media manager potenziato dall'AI. Gestisce post su multiple piattaforme social.
+
+**URL Live:** https://lab.mlhub.it/leopost/
+**Repository:** https://git.mlhub.it/Michele/leopost
+**Supabase Project:** `cizyzbdylxxjjhgnvyub`
+
+## Stack Tecnico
+- **Frontend:** Next.js 16 con App Router
+- **Auth:** Supabase Auth (Email/Password + Google OAuth)
+- **Database:** Supabase Cloud PostgreSQL
+- **Deployment:** Docker su VPS con nginx reverse proxy
+
+## Configurazione Critica
+
+### Next.js per Subpath Deployment
+```typescript
+// next.config.ts
+const nextConfig: NextConfig = {
+  basePath: '/leopost',
+  trailingSlash: true,
+};
+```
+
+### Variabili Ambiente (.env su VPS)
+```
+SUPABASE_URL=https://cizyzbdylxxjjhgnvyub.supabase.co
+SUPABASE_ANON_KEY=...
+SUPABASE_SERVICE_ROLE_KEY=...
+APP_URL=https://lab.mlhub.it/leopost
+```
+
+---
+
+## Problemi Riscontrati e Soluzioni
+
+### 1. Build OOM (Out of Memory)
+**Problema:** Build Next.js killed durante `npm run build` con 512MB RAM limit.
+**Soluzione:** Aumentare memory limit in docker-compose.yml a 1024MB.
+
+### 2. Redirect Loop HTTP/HTTPS
+**Problema:** `/leopost` senza trailing slash causava loop redirect e downgrade a HTTP.
+**Soluzione:**
+- Aggiungere `trailingSlash: true` in next.config.ts
+- Aggiungere location esplicita in nginx:
+```nginx
+location = /leopost {
+    return 301 https://$host/leopost/;
+}
+```
+
+### 3. Middleware Intercetta Tutte le Route
+**Problema:** Homepage bianca perché il middleware Next.js intercettava anche le pagine statiche.
+**Soluzione:** Limitare il matcher del middleware solo alle route che richiedono auth check:
+```typescript
+export const config = {
+  matcher: [
+    '/dashboard/:path*',
+    '/settings/:path*',
+    '/subscription/:path*',
+    '/login',
+    '/login/',
+    '/register',
+    '/register/',
+  ],
+}
+```
+**NON includere:** `/`, `/auth/:path*`, pagine statiche pubbliche.
+
+### 4. OAuth 502 Bad Gateway - Header Troppo Grandi (CRITICO)
+**Problema:** Google OAuth callback restituiva 502 Bad Gateway.
+**Causa:** Supabase Auth setta cookie JWT molto grandi (~4KB) nella risposta. I buffer nginx di default sono troppo piccoli.
+
+**Soluzione - ENTRAMBI i livelli nginx richiedono configurazione:**
+
+**A) lab-router** (`/opt/lab-router/projects/leopost.conf`):
+```nginx
+location /leopost/ {
+    proxy_pass http://lab-leopost-app:3000;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto https;
+    proxy_set_header Connection "";
+
+    # CRITICO per Supabase Auth
+    proxy_buffer_size 256k;
+    proxy_buffers 8 256k;
+    proxy_busy_buffers_size 512k;
+}
+```
+
+**B) NPM (Nginx Proxy Manager)** - file `/data/nginx/custom/server_proxy.conf`:
+```nginx
+# Large buffer sizes for Supabase Auth JWT cookies
+proxy_buffer_size 256k;
+proxy_buffers 8 256k;
+proxy_busy_buffers_size 512k;
+```
+
+**Importante:** Il 502 può venire da ENTRAMBI i nginx nella catena:
+```
+Browser → NPM → lab-router → app
+```
+Se solo lab-router ha i buffer grandi ma NPM no, il 502 viene da NPM.
+
+### 5. OAuth Redirect URL Errati
+**Problema:** Dopo Google auth, redirect a localhost o URL senza basePath.
+**Soluzione:** Usare `NEXT_PUBLIC_APP_URL` per costruire redirect URL dinamici:
+```typescript
+// src/app/auth/callback/route.ts
+const baseUrl = process.env.NEXT_PUBLIC_APP_URL || 'https://lab.mlhub.it/leopost'
+return NextResponse.redirect(`${baseUrl}${next}`)
+```
+
+### 6. Middleware Redirect Senza basePath
+**Problema:** Middleware redirect a `/login/` invece di `/leopost/login/` → 404.
+**Causa:** `new URL('/login/', request.url)` non include il basePath.
+**Soluzione:** Usare `request.nextUrl.clone()`:
+```typescript
+// middleware.ts
+// ❌ SBAGLIATO
+const redirectUrl = new URL('/login/', request.url)
+
+// ✅ CORRETTO
+const redirectUrl = request.nextUrl.clone()
+redirectUrl.pathname = '/login/'
+return NextResponse.redirect(redirectUrl)
+```
+
+### 7. Email Conferma Redirect Errato
+**Problema:** Link conferma email reindirizza a `lab.mlhub.it/auth/callback` senza basePath.
+**Causa:** `window.location.origin` non include basePath.
+**Soluzione:** Usare `NEXT_PUBLIC_APP_URL`:
+```typescript
+// src/components/auth/register-form.tsx
+const appUrl = process.env.NEXT_PUBLIC_APP_URL || window.location.origin
+
+await supabase.auth.signUp({
+  email, password,
+  options: {
+    emailRedirectTo: `${appUrl}/auth/callback/`,
+  }
+})
+```
+
+---
+
+## Configurazione Supabase Dashboard
+
+### Authentication > URL Configuration
+- **Site URL:** `https://lab.mlhub.it/leopost`
+- **Redirect URLs:**
+  - `https://lab.mlhub.it/leopost/auth/callback`
+  - `https://lab.mlhub.it/leopost/auth/callback/`
+
+### Authentication > Providers > Google
+- Abilitare Google provider
+- Configurare Client ID e Client Secret da Google Cloud Console
+- Authorized redirect URI in Google: `https://cizyzbdylxxjjhgnvyub.supabase.co/auth/v1/callback`
+
+---
+
+## Comandi Utili
+
+```bash
+# Deploy aggiornamenti
+cd "D:\Michele\Progetti\Claude\VPS echosystem\lab\leopost"
+git add . && git commit -m "Update" && git push origin main
+ssh mic@72.62.49.98 "cd /opt/lab-leopost && git pull && docker compose restart"
+
+# Verificare log container
+ssh mic@72.62.49.98 "docker logs --tail 50 lab-leopost-app"
+
+# Verificare log nginx lab-router
+ssh mic@72.62.49.98 "docker logs --tail 50 lab-router"
+
+# Verificare log NPM (per errori 502)
+ssh mic@72.62.49.98 "docker exec nginx-proxy-app-1 tail -30 /data/logs/proxy-host-8_error.log"
+```
+
+---
+
+## Design System: "Editorial Fresh"
+
+Il progetto usa un design system personalizzato chiamato "Editorial Fresh" - ispirato al design editoriale/magazine con tipografia forte e layout distintivo.
+
+### Font
+| Tipo | Font | Uso |
+|------|------|-----|
+| Display | **Fraunces** | Titoli, heading (serif con carattere) |
+| Body | **DM Sans** | Testo, paragrafi, UI |
+
+```css
+.font-display { font-family: var(--font-display); }
+.font-body { font-family: var(--font-body); }
+```
+
+### Palette Colori
+| Nome | Valore | CSS Variable | Uso |
+|------|--------|--------------|-----|
+| Cream | `#FFFBF5` | `--color-cream` | Background principale |
+| Cream Dark | `#F5F0E8` | `--color-cream-dark` | Background secondario |
+| Ink | `#1A1A1A` | `--color-ink` | Testo principale, bottoni |
+| Ink Light | `#4A4A4A` | `--color-ink-light` | Testo secondario |
+| Ink Muted | `#7A7A7A` | `--color-ink-muted` | Testo disabilitato |
+| Accent | `#E85A4F` | `--color-accent` | CTA, elementi distintivi (corallo) |
+| Success | `#2D7A4F` | `--color-success` | Conferme |
+| Error | `#C53030` | `--color-error` | Errori |
+
+### Classi Utility Custom
+```css
+/* Testi */
+.text-accent     /* Corallo */
+.text-muted      /* Grigio chiaro */
+.text-ink        /* Nero */
+.text-ink-light  /* Grigio scuro */
+
+/* Background */
+.bg-cream        /* Sfondo principale */
+.bg-cream-dark   /* Sfondo alternativo */
+.bg-accent-light /* Sfondo accent leggero */
+
+/* Elementi editoriali */
+.editorial-tag   /* Tag uppercase corallo (SOCIAL MEDIA MANAGER) */
+.editorial-line  /* Linea decorativa 60px × 3px corallo */
+.card-editorial  /* Card con barra accent in cima */
+```
+
+### Componenti
+| Componente | File | Note |
+|------------|------|------|
+| Button | `src/components/ui/button.tsx` | Varianti: default, outline, ghost, accent |
+| Input | `src/components/ui/input.tsx` | Bordi quadrati, focus nero |
+| Card Editorial | CSS class | Bordo top accent, padding 2rem |
+
+### Principi di Design
+1. **Niente bordi arrotondati** - Stile editoriale con angoli vivi
+2. **Tipografia forte** - Fraunces per impatto, DM Sans per leggibilità
+3. **Spazio generoso** - Padding abbondante, respiro tra elementi
+4. **Accent limitato** - Corallo usato con parsimonia per CTA e emphasis
+5. **Animazioni sottili** - fade-up on load, transizioni 200ms
+
+### Come Mantenere Coerenza
+Quando crei nuove pagine/componenti:
+1. Usa `font-display` per tutti i titoli
+2. Usa le classi `text-*` e `bg-*` del design system
+3. Bottoni principali con `variant="default"` (nero → accent on hover)
+4. Form inputs senza border-radius
+5. Ogni sezione inizia con `editorial-tag` + titolo `font-display`
+
+---
+
+## Stato Fasi
+
+- [x] **Fase 1:** Autenticazione (Email/Password + Google OAuth) + Design System
+- [ ] **Fase 2:** Dashboard e gestione account social
+- [ ] **Fase 3:** Creazione e scheduling post
+- [ ] **Fase 4:** Integrazione AI per generazione contenuti

README.md

@@ -0,0 +1,38 @@
+# Leopost
+
+Lab project hosted at https://lab.mlhub.it/leopost/
+
+## Development
+
+This project uses [gsd (get-shit-done)](https://github.com/glittercowboy/get-shit-done) for spec-driven development.
+
+### Getting Started
+
+1. Run `/gsd:new-project` to initialize project specs
+2. Follow gsd workflow: discuss → plan → execute → verify
+3. Run `vps-lab-deploy` when ready to deploy
+
+### Project Structure
+
+```
+leopost/
+├── .planning/          # gsd planning docs (created by /gsd:new-project)
+│   ├── PROJECT.md      # Project vision
+│   ├── REQUIREMENTS.md # Scoped requirements
+│   ├── ROADMAP.md      # Phase breakdown
+│   └── STATE.md        # Project memory
+├── src/                # Source code (created during development)
+└── README.md           # This file
+```
+
+## Repository
+
+- **Gitea**: https://git.mlhub.it/Michele/leopost
+- **Clone**: `git clone https://git.mlhub.it/Michele/leopost.git`
+
+## Deployment
+
+When ready to deploy, use `vps-lab-deploy` skill.
+
+- **URL**: https://lab.mlhub.it/leopost/
+- **VPS**: /opt/lab-leopost/

deploy.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+set -e
+
+PROJECT_DIR="/opt/lab-leopost"
+cd "$PROJECT_DIR"
+
+echo "[$(date)] Auto-deploy triggered" >> deploy.log
+
+# Pull latest
+git pull origin main
+
+# Rebuild e restart
+docker compose build --no-cache
+docker compose up -d
+
+echo "[$(date)] Auto-deploy completed" >> deploy.log

docker-compose.yml

@@ -0,0 +1,28 @@
+networks:
+  proxy_net:
+    external: true
+
+services:
+  app:
+    image: node:20-alpine
+    container_name: lab-leopost-app
+    working_dir: /app
+    volumes:
+      - ./:/app
+      - /app/node_modules
+      - /app/.next
+    networks:
+      - proxy_net
+    environment:
+      - NODE_ENV=production
+      - NEXT_PUBLIC_SUPABASE_URL=${SUPABASE_URL}
+      - NEXT_PUBLIC_SUPABASE_ANON_KEY=${SUPABASE_ANON_KEY}
+      - SUPABASE_SERVICE_ROLE_KEY=${SUPABASE_SERVICE_ROLE_KEY}
+      - NEXT_PUBLIC_APP_URL=${APP_URL}
+    command: sh -c "npm install --include=dev && npm run build && npm start"
+    deploy:
+      resources:
+        limits:
+          memory: 1024M
+          cpus: '1.0'
+    restart: unless-stopped

docs/DATABASE.md

@@ -0,0 +1,133 @@
+# Database Schema - Leopost
+
+## Overview
+
+Leopost uses Supabase (PostgreSQL) with Row Level Security for multi-tenant data isolation.
+
+## Tables
+
+### plans
+
+Subscription plan definitions.
+
+| Column | Type | Description |
+|--------|------|-------------|
+| id | UUID | Primary key |
+| name | TEXT | Unique identifier: 'free', 'creator', 'pro' |
+| display_name | TEXT | English display name |
+| display_name_it | TEXT | Italian display name |
+| price_monthly | INTEGER | Price in cents (0, 1900, 4900) |
+| features | JSONB | Feature limits and flags |
+| created_at | TIMESTAMPTZ | Creation timestamp |
+
+**Features JSONB structure:**
+```json
+{
+  "posts_per_month": 10,
+  "ai_models": ["gpt-4o-mini"],
+  "social_accounts": 1,
+  "image_generation": false,
+  "automation": false
+}
+```
+
+**Plan tiers:**
+
+| Plan | Price | Posts/Month | AI Models | Social Accounts | Images | Automation |
+|------|-------|-------------|-----------|-----------------|--------|------------|
+| Free | 0 | 10 | gpt-4o-mini | 1 | No | No |
+| Creator | 19 EUR | 50 | gpt-4o-mini, gpt-4o, claude-3-5-sonnet | 3 | Yes | Manual |
+| Pro | 49 EUR | 200 | All models + claude-opus-4 | 10 | Yes | Full |
+
+### profiles
+
+User profiles with tenant isolation.
+
+| Column | Type | Description |
+|--------|------|-------------|
+| id | UUID | Primary key, references auth.users |
+| tenant_id | UUID | Tenant isolation key (auto-generated) |
+| plan_id | UUID | References plans.id, defaults to 'free' |
+| email | TEXT | User email |
+| full_name | TEXT | Optional display name |
+| avatar_url | TEXT | Optional avatar URL |
+| created_at | TIMESTAMPTZ | Creation timestamp |
+| updated_at | TIMESTAMPTZ | Last update timestamp |
+
+**Indexes:**
+- `idx_profiles_tenant_id` - For tenant-scoped queries
+- `idx_profiles_plan_id` - For plan-based queries
+- `idx_profiles_email` - For email lookups
+
+## Row Level Security
+
+**CRITICAL**: RLS is enabled on all tables. Never bypass RLS in client code.
+
+### plans
+- SELECT: Everyone (authenticated + anon) can read
+
+### profiles
+- SELECT: Users can only read their own profile
+- UPDATE: Users can only update their own profile
+- INSERT: System creates via trigger on signup
+
+**Performance note:** All policies use `(SELECT auth.uid())` subquery pattern for 99% performance improvement over bare `auth.uid()` calls.
+
+## Helper Functions
+
+### get_user_plan_features()
+Returns JSONB of current user's plan features. Use for limit checking.
+
+```typescript
+const { data } = await supabase.rpc('get_user_plan_features')
+// Returns: { posts_per_month: 10, ai_models: [...], ... }
+```
+
+### get_user_plan_name()
+Returns TEXT of current user's plan name ('free', 'creator', 'pro').
+
+```typescript
+const { data } = await supabase.rpc('get_user_plan_name')
+// Returns: 'free' | 'creator' | 'pro'
+```
+
+## Triggers
+
+### on_auth_user_created
+Automatically creates a profile when a new user signs up via Supabase Auth.
+- Sets tenant_id to new UUID (multi-tenant isolation)
+- Sets plan_id to 'free' plan
+- Copies email, full_name, avatar_url from auth metadata
+
+### profiles_updated_at
+Automatically updates `updated_at` timestamp on profile changes.
+
+## Running Migrations
+
+### Option 1: Supabase Dashboard
+1. Go to SQL Editor
+2. Paste migration content from `supabase/migrations/001_initial_auth_setup.sql`
+3. Run
+
+### Option 2: Supabase CLI
+```bash
+supabase db push
+```
+
+### Option 3: Direct connection
+```bash
+psql $DATABASE_URL -f supabase/migrations/001_initial_auth_setup.sql
+```
+
+## Security Notes
+
+- **Never** use service_role key in client code
+- **Always** verify RLS is enabled after schema changes
+- Use Supabase Security Advisor in dashboard before production
+- tenant_id is in profiles table, not JWT (simpler approach for v1)
+- All helper functions use SECURITY DEFINER to bypass RLS when appropriate
+
+## Related Files
+
+- Migration: `supabase/migrations/001_initial_auth_setup.sql`
+- Seed: `supabase/seed.sql`

docs/GOOGLE_OAUTH_SETUP.md

@@ -0,0 +1,134 @@
+# Google OAuth Setup Guide
+
+This guide explains how to configure Google OAuth for Leopost.
+
+## Prerequisites
+
+- Google Cloud account
+- Supabase project created
+- Access to Supabase Dashboard
+
+## Step 1: Google Cloud Console Setup
+
+1. Go to [Google Cloud Console](https://console.cloud.google.com/)
+
+2. Create a new project or select existing one
+
+3. Navigate to **APIs & Services > Credentials**
+
+4. Click **Create Credentials > OAuth client ID**
+
+5. If prompted, configure the OAuth consent screen:
+   - User Type: External
+   - App name: Leopost
+   - User support email: your email
+   - Developer contact: your email
+   - Scopes: email, profile, openid (default)
+
+6. Create OAuth Client ID:
+   - Application type: **Web application**
+   - Name: Leopost Web Client
+
+7. Add **Authorized JavaScript origins**:
+   ```
+   http://localhost:3000
+   https://your-production-domain.com
+   ```
+
+8. Add **Authorized redirect URIs**:
+   ```
+   https://<your-project-ref>.supabase.co/auth/v1/callback
+   ```
+
+   Find your project ref in Supabase Dashboard > Project Settings > General
+
+9. Click **Create** and save the **Client ID** and **Client Secret**
+
+## Step 2: Supabase Configuration
+
+1. Go to [Supabase Dashboard](https://supabase.com/dashboard)
+
+2. Select your project
+
+3. Navigate to **Authentication > Providers**
+
+4. Find **Google** and click to enable
+
+5. Enter:
+   - **Client ID**: From Google Cloud Console
+   - **Client Secret**: From Google Cloud Console
+
+6. Copy the **Callback URL** shown (should match what you entered in Google)
+
+7. Click **Save**
+
+## Step 3: Environment Variables
+
+No additional environment variables needed for Google OAuth.
+The configuration is stored in Supabase Dashboard.
+
+Your existing `.env.local` should have:
+```
+NEXT_PUBLIC_SUPABASE_URL=your-project-url
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
+```
+
+## Step 4: Test the Integration
+
+1. Start development server: `npm run dev`
+
+2. Go to http://localhost:3000/login
+
+3. Click "Accedi con Google"
+
+4. You should be redirected to Google consent screen
+
+5. After consent, you should return to the app authenticated
+
+6. Check Supabase Dashboard > Authentication > Users to verify user was created
+
+## Troubleshooting
+
+### "redirect_uri_mismatch" error
+
+The redirect URI in Google Console doesn't match Supabase's callback URL.
+- Verify the exact URL in Supabase Auth Providers matches Google Console
+- Check for trailing slashes
+- Ensure using HTTPS for Supabase callback
+
+### "Access blocked: This app's request is invalid"
+
+OAuth consent screen not configured or not published.
+- Configure OAuth consent screen in Google Cloud Console
+- For testing, add your email as a test user
+- For production, submit for verification
+
+### User created but profile missing
+
+The database trigger might not have fired.
+- Check if `on_auth_user_created` trigger exists
+- Verify `handle_new_user` function has correct permissions
+- Check Supabase logs for errors
+
+### Session not persisting
+
+Middleware might not be refreshing sessions.
+- Ensure middleware.ts is in project root
+- Check middleware matcher includes auth routes
+- Verify cookies are being set correctly
+
+## Security Notes
+
+- Never commit Client Secret to version control
+- For production, publish OAuth consent screen for verification
+- Use a separate OAuth client for production vs development
+- Regularly rotate Client Secrets
+
+## Local Development vs Production
+
+| Setting | Local | Production |
+|---------|-------|------------|
+| JavaScript origins | http://localhost:3000 | https://your-domain.com |
+| Redirect URI | Same Supabase callback | Same Supabase callback |
+| Consent screen | Testing mode | Published/Verified |
+| Test users | Your email added | Not needed |

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;

middleware.ts

@@ -0,0 +1,55 @@
+import { type NextRequest, NextResponse } from 'next/server'
+import { updateSession } from '@/lib/supabase/middleware'
+
+// Routes that require authentication
+const protectedRoutes = ['/dashboard', '/settings', '/subscription']
+
+// Routes that should redirect to dashboard if already authenticated
+const authRoutes = ['/login', '/register']
+
+export async function middleware(request: NextRequest) {
+  const { pathname } = request.nextUrl
+
+  const { supabaseResponse, user } = await updateSession(request)
+
+  // Check if trying to access protected route without auth
+  const isProtectedRoute = protectedRoutes.some(route =>
+    pathname === route || pathname === `${route}/` || pathname.startsWith(`${route}/`)
+  )
+
+  if (isProtectedRoute && !user) {
+    // Use nextUrl.clone() to preserve basePath in redirect
+    const redirectUrl = request.nextUrl.clone()
+    redirectUrl.pathname = '/login/'
+    redirectUrl.searchParams.set('redirectTo', pathname)
+    return NextResponse.redirect(redirectUrl)
+  }
+
+  // Check if trying to access auth routes while already authenticated
+  const isAuthRoute = authRoutes.some(route =>
+    pathname === route || pathname === `${route}/` || pathname.startsWith(`${route}/`)
+  )
+
+  if (isAuthRoute && user) {
+    // Use nextUrl.clone() to preserve basePath in redirect
+    const url = request.nextUrl.clone()
+    url.pathname = '/dashboard/'
+    return NextResponse.redirect(url)
+  }
+
+  return supabaseResponse
+}
+
+export const config = {
+  matcher: [
+    // Only run middleware on specific routes that need auth handling
+    // Note: /auth/callback is excluded - it handles its own auth flow
+    '/dashboard/:path*',
+    '/settings/:path*',
+    '/subscription/:path*',
+    '/login',
+    '/login/',
+    '/register',
+    '/register/',
+  ],
+}

next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

next.config.ts

@@ -0,0 +1,8 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  basePath: '/leopost',
+  trailingSlash: true,
+};
+
+export default nextConfig;

package.json

@@ -0,0 +1,32 @@
+{
+  "name": "leopost",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint"
+  },
+  "dependencies": {
+    "@supabase/ssr": "^0.8.0",
+    "@supabase/supabase-js": "^2.93.3",
+    "clsx": "^2.1.1",
+    "next": "16.1.6",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "react-hook-form": "^7.71.1",
+    "tailwind-merge": "^3.4.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.1.6",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}

postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

src/app/(auth)/layout.tsx

@@ -0,0 +1,62 @@
+import Link from 'next/link'
+
+export default function AuthLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <div className="min-h-screen bg-cream flex">
+      {/* Left side - Branding */}
+      <div className="hidden lg:flex lg:w-1/2 bg-ink p-12 flex-col justify-between relative overflow-hidden">
+        {/* Decorative elements */}
+        <div className="absolute top-0 right-0 w-64 h-64 bg-accent/10 rounded-full -translate-y-1/2 translate-x-1/2"></div>
+        <div className="absolute bottom-0 left-0 w-96 h-96 bg-accent/5 rounded-full translate-y-1/2 -translate-x-1/2"></div>
+
+        {/* Logo */}
+        <Link href="/" className="relative z-10">
+          <span className="font-display text-3xl font-semibold text-cream">Leopost</span>
+        </Link>
+
+        {/* Quote */}
+        <div className="relative z-10 max-w-md">
+          <div className="w-12 h-1 bg-accent mb-8"></div>
+          <blockquote className="font-display text-3xl text-cream/90 leading-snug font-medium italic">
+            "Finalmente un assistente che capisce il mio brand e mi fa risparmiare ore ogni settimana."
+          </blockquote>
+          <div className="mt-8 flex items-center gap-4">
+            <div className="w-12 h-12 rounded-full bg-cream/20 flex items-center justify-center">
+              <span className="font-display text-cream font-semibold">MR</span>
+            </div>
+            <div>
+              <p className="text-cream font-medium">Marco Rossi</p>
+              <p className="text-cream/60 text-sm">Social Media Manager</p>
+            </div>
+          </div>
+        </div>
+
+        {/* Footer */}
+        <p className="text-cream/40 text-sm relative z-10">
+          © 2026 Leopost
+        </p>
+      </div>
+
+      {/* Right side - Form */}
+      <div className="flex-1 flex flex-col">
+        {/* Mobile header */}
+        <div className="lg:hidden p-6 border-b border-editorial">
+          <Link href="/" className="font-display text-2xl font-semibold">
+            Leopost
+          </Link>
+        </div>
+
+        {/* Form container */}
+        <div className="flex-1 flex items-center justify-center p-6 sm:p-12">
+          <div className="w-full max-w-md opacity-0 animate-fade-up">
+            {children}
+          </div>
+        </div>
+      </div>
+    </div>
+  )
+}

src/app/(auth)/login/page.tsx

@@ -0,0 +1,48 @@
+import { LoginForm } from '@/components/auth/login-form'
+import { GoogleSignInButton } from '@/components/auth/google-button'
+import Link from 'next/link'
+
+export default function LoginPage() {
+  return (
+    <div>
+      {/* Header */}
+      <div className="mb-8">
+        <span className="editorial-tag">Bentornato</span>
+        <h1 className="mt-4 text-3xl font-display font-semibold">
+          Accedi a Leopost
+        </h1>
+        <p className="mt-2 text-ink-light">
+          Inserisci le tue credenziali per continuare
+        </p>
+      </div>
+
+      {/* Google Sign In */}
+      <GoogleSignInButton />
+
+      {/* Divider */}
+      <div className="relative my-8">
+        <div className="absolute inset-0 flex items-center">
+          <div className="w-full border-t border-editorial"></div>
+        </div>
+        <div className="relative flex justify-center">
+          <span className="bg-cream px-4 text-sm text-muted uppercase tracking-wide">
+            oppure
+          </span>
+        </div>
+      </div>
+
+      {/* Email/Password Form */}
+      <LoginForm />
+
+      {/* Footer links */}
+      <div className="mt-8 pt-6 border-t border-editorial text-center">
+        <p className="text-sm text-ink-light">
+          Non hai un account?{' '}
+          <Link href="/register/" className="text-accent hover:underline font-medium">
+            Registrati gratis
+          </Link>
+        </p>
+      </div>
+    </div>
+  )
+}

src/app/(auth)/register/page.tsx

@@ -0,0 +1,48 @@
+import { RegisterForm } from '@/components/auth/register-form'
+import { GoogleSignInButton } from '@/components/auth/google-button'
+import Link from 'next/link'
+
+export default function RegisterPage() {
+  return (
+    <div>
+      {/* Header */}
+      <div className="mb-8">
+        <span className="editorial-tag">Inizia gratis</span>
+        <h1 className="mt-4 text-3xl font-display font-semibold">
+          Crea il tuo account
+        </h1>
+        <p className="mt-2 text-ink-light">
+          Inizia a gestire i tuoi social in modo intelligente
+        </p>
+      </div>
+
+      {/* Google Sign In */}
+      <GoogleSignInButton />
+
+      {/* Divider */}
+      <div className="relative my-8">
+        <div className="absolute inset-0 flex items-center">
+          <div className="w-full border-t border-editorial"></div>
+        </div>
+        <div className="relative flex justify-center">
+          <span className="bg-cream px-4 text-sm text-muted uppercase tracking-wide">
+            oppure
+          </span>
+        </div>
+      </div>
+
+      {/* Email/Password Form */}
+      <RegisterForm />
+
+      {/* Footer links */}
+      <div className="mt-8 pt-6 border-t border-editorial text-center">
+        <p className="text-sm text-ink-light">
+          Hai già un account?{' '}
+          <Link href="/login/" className="text-accent hover:underline font-medium">
+            Accedi
+          </Link>
+        </p>
+      </div>
+    </div>
+  )
+}

src/app/(auth)/reset-password/page.tsx

@@ -0,0 +1,97 @@
+'use client'
+
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+import { Button } from '@/components/ui/button'
+import { Input } from '@/components/ui/input'
+import Link from 'next/link'
+import { useState } from 'react'
+import { createClient } from '@/lib/supabase/client'
+
+export default function ResetPasswordPage() {
+  const [email, setEmail] = useState('')
+  const [error, setError] = useState<string | null>(null)
+  const [success, setSuccess] = useState(false)
+  const [loading, setLoading] = useState(false)
+  const supabase = createClient()
+
+  async function handleSubmit(e: React.FormEvent) {
+    e.preventDefault()
+    setError(null)
+    setLoading(true)
+
+    const { error: resetError } = await supabase.auth.resetPasswordForEmail(
+      email,
+      {
+        redirectTo: `${window.location.origin}/auth/callback?next=/update-password`,
+      }
+    )
+
+    if (resetError) {
+      setError(resetError.message)
+      setLoading(false)
+      return
+    }
+
+    setSuccess(true)
+    setLoading(false)
+  }
+
+  return (
+    <Card>
+      <CardHeader className="text-center">
+        <CardTitle>Recupera password</CardTitle>
+        <CardDescription>
+          Inserisci la tua email per ricevere il link di reset
+        </CardDescription>
+      </CardHeader>
+      <CardContent>
+        {success ? (
+          <div className="text-center space-y-4">
+            <div className="p-4 bg-green-50 border border-green-200 rounded-md">
+              <p className="text-green-800">
+                Se l&apos;email esiste, riceverai un link per reimpostare la password.
+              </p>
+            </div>
+            <Link href="/login" className="text-blue-600 hover:underline">
+              Torna al login
+            </Link>
+          </div>
+        ) : (
+          <form onSubmit={handleSubmit} className="space-y-4">
+            {error && (
+              <div className="p-3 bg-red-50 border border-red-200 rounded-md">
+                <p className="text-red-800 text-sm">{error}</p>
+              </div>
+            )}
+
+            <div>
+              <label htmlFor="email" className="block text-sm font-medium text-gray-700 mb-1">
+                Email
+              </label>
+              <Input
+                id="email"
+                name="email"
+                type="email"
+                autoComplete="email"
+                required
+                placeholder="tu@esempio.com"
+                value={email}
+                onChange={(e) => setEmail(e.target.value)}
+              />
+            </div>
+
+            <Button type="submit" className="w-full" disabled={loading}>
+              {loading ? 'Invio...' : 'Invia link di reset'}
+            </Button>
+
+            <p className="text-center text-sm text-gray-600">
+              <Link href="/login" className="text-blue-600 hover:underline">
+                Torna al login
+              </Link>
+            </p>
+          </form>
+        )}
+      </CardContent>
+    </Card>
+  )
+}

src/app/(auth)/update-password/page.tsx

@@ -0,0 +1,144 @@
+'use client'
+
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+import { Button } from '@/components/ui/button'
+import { Input } from '@/components/ui/input'
+import Link from 'next/link'
+import { useState } from 'react'
+import { createClient } from '@/lib/supabase/client'
+
+export default function UpdatePasswordPage() {
+  const [password, setPassword] = useState('')
+  const [confirmPassword, setConfirmPassword] = useState('')
+  const [error, setError] = useState<string | null>(null)
+  const [fieldErrors, setFieldErrors] = useState<Record<string, string>>({})
+  const [success, setSuccess] = useState(false)
+  const [loading, setLoading] = useState(false)
+  const supabase = createClient()
+
+  function validatePassword(pwd: string): string | null {
+    if (pwd.length < 8) {
+      return 'La password deve contenere almeno 8 caratteri'
+    }
+    if (!/[0-9]/.test(pwd)) {
+      return 'La password deve contenere almeno un numero'
+    }
+    if (!/[A-Z]/.test(pwd)) {
+      return 'La password deve contenere almeno una lettera maiuscola'
+    }
+    return null
+  }
+
+  async function handleSubmit(e: React.FormEvent) {
+    e.preventDefault()
+    setError(null)
+    setFieldErrors({})
+    setLoading(true)
+
+    // Validate password
+    const passwordError = validatePassword(password)
+    if (passwordError) {
+      setFieldErrors({ password: passwordError })
+      setLoading(false)
+      return
+    }
+
+    // Validate confirm password
+    if (password !== confirmPassword) {
+      setFieldErrors({ confirmPassword: 'Le password non coincidono' })
+      setLoading(false)
+      return
+    }
+
+    const { error: updateError } = await supabase.auth.updateUser({
+      password: password,
+    })
+
+    if (updateError) {
+      setError(updateError.message)
+      setLoading(false)
+      return
+    }
+
+    setSuccess(true)
+    setLoading(false)
+  }
+
+  return (
+    <Card>
+      <CardHeader className="text-center">
+        <CardTitle>Nuova password</CardTitle>
+        <CardDescription>
+          Inserisci la tua nuova password
+        </CardDescription>
+      </CardHeader>
+      <CardContent>
+        {success ? (
+          <div className="text-center space-y-4">
+            <div className="p-4 bg-green-50 border border-green-200 rounded-md">
+              <p className="text-green-800">Password aggiornata con successo!</p>
+            </div>
+            <Link href="/login" className="text-blue-600 hover:underline">
+              Vai al login
+            </Link>
+          </div>
+        ) : (
+          <form onSubmit={handleSubmit} className="space-y-4">
+            {error && (
+              <div className="p-3 bg-red-50 border border-red-200 rounded-md">
+                <p className="text-red-800 text-sm">{error}</p>
+              </div>
+            )}
+
+            <div>
+              <label htmlFor="password" className="block text-sm font-medium text-gray-700 mb-1">
+                Nuova Password
+              </label>
+              <Input
+                id="password"
+                name="password"
+                type="password"
+                autoComplete="new-password"
+                required
+                placeholder="Minimo 8 caratteri"
+                value={password}
+                onChange={(e) => setPassword(e.target.value)}
+                error={!!fieldErrors.password}
+              />
+              {fieldErrors.password && (
+                <p className="mt-1 text-sm text-red-600">{fieldErrors.password}</p>
+              )}
+              <p className="mt-1 text-xs text-gray-500">
+                Almeno 8 caratteri, 1 numero, 1 maiuscola
+              </p>
+            </div>
+
+            <div>
+              <label htmlFor="confirmPassword" className="block text-sm font-medium text-gray-700 mb-1">
+                Conferma Password
+              </label>
+              <Input
+                id="confirmPassword"
+                name="confirmPassword"
+                type="password"
+                autoComplete="new-password"
+                required
+                placeholder="Ripeti la password"
+                value={confirmPassword}
+                onChange={(e) => setConfirmPassword(e.target.value)}
+                error={!!fieldErrors.confirmPassword}
+              />
+              {fieldErrors.confirmPassword && (
+                <p className="mt-1 text-sm text-red-600">{fieldErrors.confirmPassword}</p>
+              )}
+            </div>
+
+            <Button type="submit" className="w-full" disabled={loading}>
+              {loading ? 'Aggiornamento...' : 'Aggiorna password'}
+            </Button>
+          </form>
+        )}
+      </CardContent>
+    </Card>
+  )
+}

src/app/(auth)/verify-email/page.tsx

@@ -0,0 +1,26 @@
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+import Link from 'next/link'
+
+export default function VerifyEmailPage() {
+  return (
+    <Card>
+      <CardHeader className="text-center">
+        <CardTitle>Verifica la tua email</CardTitle>
+        <CardDescription>
+          Ti abbiamo inviato un link di conferma
+        </CardDescription>
+      </CardHeader>
+      <CardContent className="text-center space-y-4">
+        <p className="text-gray-600">
+          Controlla la tua casella email e clicca sul link per attivare il tuo account.
+        </p>
+        <p className="text-sm text-gray-500">
+          Non hai ricevuto l&apos;email? Controlla lo spam.
+        </p>
+        <Link href="/login" className="text-blue-600 hover:underline">
+          Torna al login
+        </Link>
+      </CardContent>
+    </Card>
+  )
+}

src/app/(dashboard)/dashboard/page.tsx

@@ -0,0 +1,135 @@
+import { createClient } from '@/lib/supabase/server'
+import { redirect } from 'next/navigation'
+import Link from 'next/link'
+
+export default async function DashboardPage() {
+  const supabase = await createClient()
+
+  const { data: { user } } = await supabase.auth.getUser()
+
+  if (!user) {
+    redirect('/login')
+  }
+
+  // Get profile with plan details
+  const { data: profile } = await supabase
+    .from('profiles')
+    .select(`
+      *,
+      plans (
+        name,
+        display_name_it,
+        features
+      )
+    `)
+    .eq('id', user.id)
+    .single()
+
+  const features = profile?.plans?.features as {
+    posts_per_month?: number
+    ai_models?: string[]
+    social_accounts?: number
+  } | null
+
+  return (
+    <div className="space-y-10 opacity-0 animate-fade-up">
+      {/* Header */}
+      <div>
+        <span className="editorial-tag">Dashboard</span>
+        <h1 className="mt-4 text-4xl font-display font-semibold">
+          Bentornato in Leopost
+        </h1>
+        <p className="mt-2 text-ink-light text-lg">
+          Gestisci i tuoi contenuti social da qui.
+        </p>
+      </div>
+
+      {/* Cards Grid */}
+      <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
+        {/* Plan Card */}
+        <div className="card-editorial">
+          <div className="flex items-start justify-between mb-4">
+            <h2 className="font-display text-xl font-semibold">Il tuo piano</h2>
+            <span className="editorial-tag">
+              {profile?.plans?.display_name_it || 'Gratuito'}
+            </span>
+          </div>
+          <ul className="space-y-3 text-ink-light">
+            <li className="flex justify-between">
+              <span>Post al mese</span>
+              <span className="font-medium text-ink">{features?.posts_per_month || 10}</span>
+            </li>
+            <li className="flex justify-between">
+              <span>Account social</span>
+              <span className="font-medium text-ink">{features?.social_accounts || 1}</span>
+            </li>
+            <li className="flex justify-between">
+              <span>Modelli AI</span>
+              <span className="font-medium text-ink">{features?.ai_models?.length || 1}</span>
+            </li>
+          </ul>
+          <div className="mt-6 pt-4 border-t border-editorial">
+            <Link
+              href="/subscription/"
+              className="text-sm text-accent hover:underline font-medium"
+            >
+              Cambia piano →
+            </Link>
+          </div>
+        </div>
+
+        {/* Onboarding Card */}
+        <div className="card-editorial">
+          <h2 className="font-display text-xl font-semibold mb-4">Prossimi passi</h2>
+          <ul className="space-y-4">
+            <li className="flex items-start gap-3">
+              <span className="w-6 h-6 flex items-center justify-center bg-success text-white text-xs font-medium">
+                ✓
+              </span>
+              <div>
+                <p className="font-medium text-ink">Account creato</p>
+                <p className="text-sm text-ink-light">Completo</p>
+              </div>
+            </li>
+            <li className="flex items-start gap-3">
+              <span className="w-6 h-6 flex items-center justify-center bg-cream-dark text-ink-muted text-xs font-medium">
+                2
+              </span>
+              <div>
+                <p className="font-medium text-ink-muted">Collega social</p>
+                <p className="text-sm text-ink-muted">Prossimamente</p>
+              </div>
+            </li>
+            <li className="flex items-start gap-3">
+              <span className="w-6 h-6 flex items-center justify-center bg-cream-dark text-ink-muted text-xs font-medium">
+                3
+              </span>
+              <div>
+                <p className="font-medium text-ink-muted">Configura brand</p>
+                <p className="text-sm text-ink-muted">Prossimamente</p>
+              </div>
+            </li>
+          </ul>
+        </div>
+
+        {/* Activity Card */}
+        <div className="card-editorial">
+          <h2 className="font-display text-xl font-semibold mb-4">Attività</h2>
+          <div className="py-8 text-center">
+            <div className="w-16 h-16 mx-auto mb-4 bg-cream-dark flex items-center justify-center">
+              <svg className="w-8 h-8 text-ink-muted" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z" />
+              </svg>
+            </div>
+            <p className="text-ink-muted text-sm">
+              Nessuna attività ancora.
+            </p>
+            <p className="text-ink-muted text-sm mt-1">
+              Collega un account social per iniziare!
+            </p>
+          </div>
+        </div>
+      </div>
+    </div>
+  )
+}

src/app/(dashboard)/layout.tsx

@@ -0,0 +1,72 @@
+import { createClient } from '@/lib/supabase/server'
+import { redirect } from 'next/navigation'
+import { UserNav } from '@/components/layout/user-nav'
+import Link from 'next/link'
+
+export default async function DashboardLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  const supabase = await createClient()
+
+  // Get user (should always exist due to middleware)
+  const { data: { user }, error: authError } = await supabase.auth.getUser()
+
+  if (authError || !user) {
+    redirect('/login')
+  }
+
+  // Get profile with plan info
+  const { data: profile } = await supabase
+    .from('profiles')
+    .select(`
+      *,
+      plans (
+        name,
+        display_name_it
+      )
+    `)
+    .eq('id', user.id)
+    .single()
+
+  return (
+    <div className="min-h-screen bg-cream">
+      {/* Header */}
+      <header className="bg-white border-b border-editorial sticky top-0 z-50">
+        <div className="max-w-7xl mx-auto px-6">
+          <div className="flex justify-between items-center h-16">
+            <div className="flex items-center gap-10">
+              <Link href="/dashboard/" className="font-display text-xl font-semibold text-ink">
+                Leopost
+              </Link>
+              <nav className="hidden md:flex items-center gap-6">
+                <Link
+                  href="/dashboard/"
+                  className="text-ink-light hover:text-ink transition-colors text-sm font-medium"
+                >
+                  Dashboard
+                </Link>
+                <Link
+                  href="/subscription/"
+                  className="text-ink-light hover:text-ink transition-colors text-sm font-medium"
+                >
+                  Piano
+                </Link>
+              </nav>
+            </div>
+            <UserNav
+              email={user.email || ''}
+              planName={profile?.plans?.display_name_it}
+            />
+          </div>
+        </div>
+      </header>
+
+      {/* Main content */}
+      <main className="max-w-7xl mx-auto px-6 py-10">
+        {children}
+      </main>
+    </div>
+  )
+}

src/app/(dashboard)/subscription/page.tsx

@@ -0,0 +1,183 @@
+import { createClient } from '@/lib/supabase/server'
+import { redirect } from 'next/navigation'
+import { PlanCard } from '@/components/subscription/plan-card'
+import { Plan, PlanFeatures } from '@/types/database'
+import { PLAN_DISPLAY_ORDER } from '@/lib/plans'
+
+export default async function SubscriptionPage() {
+  const supabase = await createClient()
+
+  const { data: { user } } = await supabase.auth.getUser()
+
+  if (!user) {
+    redirect('/login')
+  }
+
+  // Get user's current plan
+  const { data: profile } = await supabase
+    .from('profiles')
+    .select('plan_id')
+    .eq('id', user.id)
+    .single()
+
+  // Get all plans
+  const { data: plans, error: plansError } = await supabase
+    .from('plans')
+    .select('*')
+    .order('price_monthly', { ascending: true })
+
+  if (plansError || !plans) {
+    return (
+      <div className="text-center py-12">
+        <p className="text-error">Errore nel caricamento dei piani</p>
+      </div>
+    )
+  }
+
+  // Sort plans by our display order
+  const sortedPlans = [...plans].sort((a, b) => {
+    return PLAN_DISPLAY_ORDER.indexOf(a.name as typeof PLAN_DISPLAY_ORDER[number]) -
+           PLAN_DISPLAY_ORDER.indexOf(b.name as typeof PLAN_DISPLAY_ORDER[number])
+  })
+
+  return (
+    <div className="space-y-12 opacity-0 animate-fade-up">
+      {/* Header */}
+      <div>
+        <span className="editorial-tag">Abbonamento</span>
+        <h1 className="mt-4 text-4xl font-display font-semibold">
+          Scegli il tuo piano
+        </h1>
+        <p className="mt-2 text-ink-light text-lg">
+          Trova il piano più adatto alle tue esigenze
+        </p>
+      </div>
+
+      {/* Info banner */}
+      <div className="p-5 bg-accent-light border-l-4 border-accent">
+        <p className="text-sm text-ink">
+          <strong>Nota:</strong> Il pagamento verrà implementato nelle prossime versioni.
+          Per ora puoi passare liberamente tra i piani per testare le funzionalità.
+        </p>
+      </div>
+
+      {/* Plans grid */}
+      <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
+        {sortedPlans.map((plan) => (
+          <PlanCard
+            key={plan.id}
+            plan={plan as Plan}
+            isCurrentPlan={plan.id === profile?.plan_id}
+          />
+        ))}
+      </div>
+
+      {/* Feature comparison */}
+      <div>
+        <h2 className="text-2xl font-display font-semibold mb-6">
+          Confronto funzionalità
+        </h2>
+        <div className="overflow-x-auto">
+          <table className="w-full">
+            <thead>
+              <tr className="border-b-2 border-ink">
+                <th className="text-left py-4 px-4 font-display font-semibold text-ink">
+                  Funzionalità
+                </th>
+                {sortedPlans.map((plan) => (
+                  <th key={plan.id} className="text-center py-4 px-4 font-display font-semibold text-ink">
+                    {plan.display_name_it}
+                  </th>
+                ))}
+              </tr>
+            </thead>
+            <tbody>
+              <FeatureRow
+                feature="Post al mese"
+                plans={sortedPlans as Plan[]}
+                getValue={(p) => (p.features as PlanFeatures).posts_per_month.toString()}
+              />
+              <FeatureRow
+                feature="Account social"
+                plans={sortedPlans as Plan[]}
+                getValue={(p) => (p.features as PlanFeatures).social_accounts.toString()}
+              />
+              <FeatureRow
+                feature="Modelli AI"
+                plans={sortedPlans as Plan[]}
+                getValue={(p) => (p.features as PlanFeatures).ai_models.length.toString()}
+              />
+              <FeatureRow
+                feature="Generazione immagini"
+                plans={sortedPlans as Plan[]}
+                getValue={(p) => (p.features as PlanFeatures).image_generation ? '✓' : '—'}
+              />
+              <FeatureRow
+                feature="Automazione"
+                plans={sortedPlans as Plan[]}
+                getValue={(p) => {
+                  const auto = (p.features as PlanFeatures).automation
+                  if (auto === false) return '—'
+                  if (auto === 'manual') return 'Manuale'
+                  if (auto === 'full') return 'Completa'
+                  return '—'
+                }}
+              />
+            </tbody>
+          </table>
+        </div>
+      </div>
+
+      {/* FAQ */}
+      <div>
+        <h2 className="text-2xl font-display font-semibold mb-6">
+          Domande frequenti
+        </h2>
+        <div className="space-y-4">
+          <FaqItem
+            question="Posso cambiare piano in qualsiasi momento?"
+            answer="Sì, puoi passare a un piano superiore o inferiore quando vuoi. Le modifiche sono immediate."
+          />
+          <FaqItem
+            question="Cosa succede se supero i limiti del mio piano?"
+            answer="Riceverai un avviso quando ti avvicini al limite mensile. Non potrai creare nuovi post fino al rinnovo o all'upgrade."
+          />
+          <FaqItem
+            question="Come funziona il pagamento?"
+            answer="Il sistema di pagamento verrà implementato a breve. Per ora tutti i piani sono disponibili gratuitamente per i test."
+          />
+        </div>
+      </div>
+    </div>
+  )
+}
+
+function FeatureRow({
+  feature,
+  plans,
+  getValue,
+}: {
+  feature: string
+  plans: Plan[]
+  getValue: (plan: Plan) => string
+}) {
+  return (
+    <tr className="border-b border-editorial">
+      <td className="py-4 px-4 text-ink-light">{feature}</td>
+      {plans.map((plan) => (
+        <td key={plan.id} className="text-center py-4 px-4 font-medium">
+          {getValue(plan)}
+        </td>
+      ))}
+    </tr>
+  )
+}
+
+function FaqItem({ question, answer }: { question: string; answer: string }) {
+  return (
+    <div className="card-editorial">
+      <h3 className="font-display font-semibold text-ink mb-2">{question}</h3>
+      <p className="text-ink-light">{answer}</p>
+    </div>
+  )
+}

src/app/actions/auth.ts

@@ -0,0 +1,164 @@
+'use server'
+
+import { createClient } from '@/lib/supabase/server'
+import { registerSchema, loginSchema, resetPasswordSchema, updatePasswordSchema } from '@/lib/schemas/auth'
+import { redirect } from 'next/navigation'
+import { revalidatePath } from 'next/cache'
+
+export type ActionState = {
+  error?: string
+  fieldErrors?: Record<string, string[]>
+  success?: boolean
+  message?: string
+}
+
+export async function registerUser(
+  prevState: ActionState,
+  formData: FormData
+): Promise<ActionState> {
+  const supabase = await createClient()
+
+  const parsed = registerSchema.safeParse({
+    email: formData.get('email'),
+    password: formData.get('password'),
+    confirmPassword: formData.get('confirmPassword'),
+  })
+
+  if (!parsed.success) {
+    return {
+      fieldErrors: parsed.error.flatten().fieldErrors,
+    }
+  }
+
+  const { data, error } = await supabase.auth.signUp({
+    email: parsed.data.email,
+    password: parsed.data.password,
+    options: {
+      emailRedirectTo: `${process.env.NEXT_PUBLIC_APP_URL}/auth/callback`,
+    }
+  })
+
+  if (error) {
+    // SPECIFIC error messages per user requirement
+    if (error.message.includes('already registered')) {
+      return { error: 'Questa email e gia registrata' }
+    }
+    if (error.message.includes('invalid')) {
+      return { error: 'Email non valida' }
+    }
+    return { error: error.message }
+  }
+
+  return {
+    success: true,
+    message: 'Registrazione completata! Controlla la tua email per confermare l\'account.'
+  }
+}
+
+export async function loginUser(
+  prevState: ActionState,
+  formData: FormData
+): Promise<ActionState> {
+  const supabase = await createClient()
+
+  const parsed = loginSchema.safeParse({
+    email: formData.get('email'),
+    password: formData.get('password'),
+  })
+
+  if (!parsed.success) {
+    return {
+      fieldErrors: parsed.error.flatten().fieldErrors,
+    }
+  }
+
+  const { data, error } = await supabase.auth.signInWithPassword({
+    email: parsed.data.email,
+    password: parsed.data.password,
+  })
+
+  if (error) {
+    // SPECIFIC error messages per user requirement
+    if (error.message.includes('Invalid login credentials')) {
+      return { error: 'Email o password errata' }
+    }
+    if (error.message.includes('Email not confirmed')) {
+      return { error: 'Devi confermare la tua email prima di accedere' }
+    }
+    return { error: error.message }
+  }
+
+  revalidatePath('/', 'layout')
+  redirect('/dashboard')
+}
+
+export async function resetPassword(
+  prevState: ActionState,
+  formData: FormData
+): Promise<ActionState> {
+  const supabase = await createClient()
+
+  const parsed = resetPasswordSchema.safeParse({
+    email: formData.get('email'),
+  })
+
+  if (!parsed.success) {
+    return {
+      fieldErrors: parsed.error.flatten().fieldErrors,
+    }
+  }
+
+  const { error } = await supabase.auth.resetPasswordForEmail(
+    parsed.data.email,
+    {
+      redirectTo: `${process.env.NEXT_PUBLIC_APP_URL}/auth/callback?next=/update-password`,
+    }
+  )
+
+  if (error) {
+    return { error: error.message }
+  }
+
+  return {
+    success: true,
+    message: 'Se l\'email esiste, riceverai un link per reimpostare la password.'
+  }
+}
+
+export async function updatePassword(
+  prevState: ActionState,
+  formData: FormData
+): Promise<ActionState> {
+  const supabase = await createClient()
+
+  const parsed = updatePasswordSchema.safeParse({
+    password: formData.get('password'),
+    confirmPassword: formData.get('confirmPassword'),
+  })
+
+  if (!parsed.success) {
+    return {
+      fieldErrors: parsed.error.flatten().fieldErrors,
+    }
+  }
+
+  const { error } = await supabase.auth.updateUser({
+    password: parsed.data.password,
+  })
+
+  if (error) {
+    return { error: error.message }
+  }
+
+  return {
+    success: true,
+    message: 'Password aggiornata con successo!'
+  }
+}
+
+export async function signOut() {
+  const supabase = await createClient()
+  await supabase.auth.signOut()
+  revalidatePath('/', 'layout')
+  redirect('/login')
+}

src/app/actions/subscription.ts

@@ -0,0 +1,80 @@
+'use server'
+
+import { createClient } from '@/lib/supabase/server'
+import { revalidatePath } from 'next/cache'
+
+export type SubscriptionActionState = {
+  success?: boolean
+  error?: string
+  message?: string
+}
+
+export async function switchPlan(planId: string): Promise<SubscriptionActionState> {
+  const supabase = await createClient()
+
+  // Get current user
+  const { data: { user }, error: authError } = await supabase.auth.getUser()
+
+  if (authError || !user) {
+    return { error: 'Devi essere autenticato per cambiare piano' }
+  }
+
+  // Verify plan exists
+  const { data: plan, error: planError } = await supabase
+    .from('plans')
+    .select('id, name, display_name_it')
+    .eq('id', planId)
+    .single()
+
+  if (planError || !plan) {
+    return { error: 'Piano non trovato' }
+  }
+
+  // Update user's plan
+  const { error: updateError } = await supabase
+    .from('profiles')
+    .update({ plan_id: planId })
+    .eq('id', user.id)
+
+  if (updateError) {
+    console.error('Failed to update plan:', updateError)
+    return { error: 'Errore durante il cambio piano. Riprova.' }
+  }
+
+  // Revalidate pages that show plan info
+  revalidatePath('/dashboard')
+  revalidatePath('/subscription')
+
+  return {
+    success: true,
+    message: `Piano cambiato a ${plan.display_name_it}`
+  }
+}
+
+export async function getCurrentPlan() {
+  const supabase = await createClient()
+
+  const { data: { user } } = await supabase.auth.getUser()
+
+  if (!user) {
+    return null
+  }
+
+  const { data: profile } = await supabase
+    .from('profiles')
+    .select(`
+      plan_id,
+      plans (
+        id,
+        name,
+        display_name,
+        display_name_it,
+        price_monthly,
+        features
+      )
+    `)
+    .eq('id', user.id)
+    .single()
+
+  return profile?.plans || null
+}

src/app/auth/callback/route.ts

@@ -0,0 +1,24 @@
+import { createClient } from '@/lib/supabase/server'
+import { NextResponse } from 'next/server'
+
+export async function GET(request: Request) {
+  const { searchParams } = new URL(request.url)
+  const code = searchParams.get('code')
+  const next = searchParams.get('next') ?? '/dashboard/'
+
+  // Use the configured app URL for redirects
+  const baseUrl = process.env.NEXT_PUBLIC_APP_URL || 'https://lab.mlhub.it/leopost'
+
+  if (code) {
+    const supabase = await createClient()
+    const { error } = await supabase.auth.exchangeCodeForSession(code)
+
+    if (!error) {
+      // Redirect to dashboard (or next page) after successful auth
+      return NextResponse.redirect(`${baseUrl}${next}`)
+    }
+  }
+
+  // Return the user to login page with error
+  return NextResponse.redirect(`${baseUrl}/login/?error=auth_callback_error`)
+}

src/app/globals.css

@@ -0,0 +1,252 @@
+@import "tailwindcss";
+
+/* ==========================================================================
+   LEOPOST DESIGN SYSTEM - "Editorial Fresh"
+   ========================================================================== */
+
+@theme inline {
+  /* Typography */
+  --font-body: var(--font-body), system-ui, sans-serif;
+  --font-display: var(--font-display), Georgia, serif;
+
+  /* Color Palette */
+  --color-cream: #FFFBF5;
+  --color-cream-dark: #F5F0E8;
+  --color-ink: #1A1A1A;
+  --color-ink-light: #4A4A4A;
+  --color-ink-muted: #7A7A7A;
+
+  /* Accent - Coral Red */
+  --color-accent: #E85A4F;
+  --color-accent-hover: #D14940;
+  --color-accent-light: #FFF0EE;
+
+  /* Semantic */
+  --color-background: var(--color-cream);
+  --color-foreground: var(--color-ink);
+  --color-muted: var(--color-ink-muted);
+  --color-border: #E5E0D8;
+  --color-border-strong: #D0C9BD;
+
+  /* Success/Error */
+  --color-success: #2D7A4F;
+  --color-success-light: #E8F5ED;
+  --color-error: #C53030;
+  --color-error-light: #FEE2E2;
+}
+
+/* ==========================================================================
+   BASE STYLES
+   ========================================================================== */
+
+body {
+  background-color: var(--color-cream);
+  color: var(--color-ink);
+  font-family: var(--font-body);
+  font-size: 16px;
+  line-height: 1.6;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+/* Display Typography */
+.font-display {
+  font-family: var(--font-display);
+  font-optical-sizing: auto;
+}
+
+.font-body {
+  font-family: var(--font-body);
+}
+
+/* Heading Styles */
+h1, h2, h3, h4, h5, h6,
+.heading {
+  font-family: var(--font-display);
+  font-weight: 600;
+  line-height: 1.2;
+  color: var(--color-ink);
+  letter-spacing: -0.02em;
+}
+
+/* ==========================================================================
+   EDITORIAL ELEMENTS
+   ========================================================================== */
+
+/* Decorative line */
+.editorial-line {
+  width: 60px;
+  height: 3px;
+  background-color: var(--color-accent);
+}
+
+/* Pull quote style */
+.pull-quote {
+  font-family: var(--font-display);
+  font-size: 1.5rem;
+  font-style: italic;
+  color: var(--color-ink-light);
+  border-left: 3px solid var(--color-accent);
+  padding-left: 1.5rem;
+}
+
+/* Label/Tag style */
+.editorial-tag {
+  font-size: 0.75rem;
+  font-weight: 600;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: var(--color-accent);
+}
+
+/* ==========================================================================
+   COMPONENT OVERRIDES
+   ========================================================================== */
+
+/* Buttons - Primary */
+.btn-primary {
+  background-color: var(--color-ink);
+  color: var(--color-cream);
+  font-weight: 500;
+  padding: 0.75rem 1.5rem;
+  border-radius: 0;
+  transition: all 0.2s ease;
+}
+
+.btn-primary:hover {
+  background-color: var(--color-accent);
+  transform: translateY(-1px);
+}
+
+/* Buttons - Secondary */
+.btn-secondary {
+  background-color: transparent;
+  color: var(--color-ink);
+  font-weight: 500;
+  padding: 0.75rem 1.5rem;
+  border: 2px solid var(--color-ink);
+  border-radius: 0;
+  transition: all 0.2s ease;
+}
+
+.btn-secondary:hover {
+  background-color: var(--color-ink);
+  color: var(--color-cream);
+}
+
+/* Button outline variant - explicit hover fix */
+.btn-outline {
+  background-color: transparent;
+  color: var(--color-ink);
+  border: 2px solid var(--color-ink);
+  transition: all 0.2s ease;
+}
+
+.btn-outline:hover {
+  background-color: var(--color-ink);
+  color: var(--color-cream);
+}
+
+/* Cards */
+.card-editorial {
+  background-color: white;
+  border: 1px solid var(--color-border);
+  padding: 2rem;
+  position: relative;
+}
+
+.card-editorial::before {
+  content: '';
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 4px;
+  background-color: var(--color-accent);
+}
+
+/* Input fields */
+input[type="text"],
+input[type="email"],
+input[type="password"],
+textarea {
+  border: 1px solid var(--color-border);
+  border-radius: 0;
+  background-color: white;
+  padding: 0.75rem 1rem;
+  font-family: var(--font-body);
+  transition: border-color 0.2s ease;
+}
+
+input:focus,
+textarea:focus {
+  outline: none;
+  border-color: var(--color-ink);
+}
+
+/* ==========================================================================
+   UTILITIES
+   ========================================================================== */
+
+/* Text colors */
+.text-accent { color: var(--color-accent); }
+.text-muted { color: var(--color-ink-muted); }
+.text-ink { color: var(--color-ink); }
+.text-ink-light { color: var(--color-ink-light); }
+.text-cream { color: var(--color-cream); }
+
+/* Background colors */
+.bg-cream { background-color: var(--color-cream); }
+.bg-cream-dark { background-color: var(--color-cream-dark); }
+.bg-accent-light { background-color: var(--color-accent-light); }
+
+/* Border colors */
+.border-editorial { border-color: var(--color-border); }
+
+/* ==========================================================================
+   ANIMATIONS
+   ========================================================================== */
+
+@keyframes fade-up {
+  from {
+    opacity: 0;
+    transform: translateY(20px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+@keyframes fade-in {
+  from { opacity: 0; }
+  to { opacity: 1; }
+}
+
+.animate-fade-up {
+  animation: fade-up 0.6s ease-out forwards;
+}
+
+.animate-fade-in {
+  animation: fade-in 0.4s ease-out forwards;
+}
+
+/* Staggered animations */
+.stagger-1 { animation-delay: 0.1s; }
+.stagger-2 { animation-delay: 0.2s; }
+.stagger-3 { animation-delay: 0.3s; }
+.stagger-4 { animation-delay: 0.4s; }
+
+/* ==========================================================================
+   SELECTION & FOCUS
+   ========================================================================== */
+
+::selection {
+  background-color: var(--color-accent);
+  color: white;
+}
+
+:focus-visible {
+  outline: 2px solid var(--color-accent);
+  outline-offset: 2px;
+}

src/app/layout.tsx

@@ -0,0 +1,37 @@
+import type { Metadata } from "next";
+import { DM_Sans, Fraunces } from "next/font/google";
+import "./globals.css";
+
+const dmSans = DM_Sans({
+  variable: "--font-body",
+  subsets: ["latin"],
+  display: "swap",
+});
+
+const fraunces = Fraunces({
+  variable: "--font-display",
+  subsets: ["latin"],
+  display: "swap",
+});
+
+export const metadata: Metadata = {
+  title: {
+    default: "Leopost",
+    template: "%s | Leopost",
+  },
+  description: "Social media manager potenziato dall'AI. Gestisci i tuoi post su multiple piattaforme social.",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="it">
+      <body className={`${dmSans.variable} ${fraunces.variable} font-body antialiased`}>
+        {children}
+      </body>
+    </html>
+  );
+}

src/app/page.tsx

@@ -0,0 +1,194 @@
+import Link from 'next/link'
+
+export default function Home() {
+  return (
+    <main className="min-h-screen bg-cream">
+      {/* Header */}
+      <header className="fixed top-0 left-0 right-0 z-50 bg-cream/90 backdrop-blur-sm border-b border-editorial">
+        <div className="max-w-6xl mx-auto px-6 py-4 flex items-center justify-between">
+          <Link href="/" className="font-display text-2xl font-semibold tracking-tight">
+            Leopost
+          </Link>
+          <nav className="flex items-center gap-6">
+            <Link
+              href="/login/"
+              className="text-ink-light hover:text-ink transition-colors text-sm font-medium"
+            >
+              Accedi
+            </Link>
+            <Link
+              href="/register/"
+              className="btn-primary text-sm"
+            >
+              Inizia gratis
+            </Link>
+          </nav>
+        </div>
+      </header>
+
+      {/* Hero Section */}
+      <section className="pt-32 pb-20 px-6">
+        <div className="max-w-6xl mx-auto">
+          <div className="grid lg:grid-cols-2 gap-16 items-center">
+            {/* Left Column - Text */}
+            <div className="opacity-0 animate-fade-up">
+              <span className="editorial-tag">Social Media Manager</span>
+
+              <h1 className="mt-6 text-5xl md:text-6xl lg:text-7xl font-display font-semibold leading-[1.1] tracking-tight">
+                Il tuo assistente
+                <br />
+                <span className="text-accent">editoriale</span>
+                <br />
+                potenziato dall&apos;AI
+              </h1>
+
+              <div className="editorial-line mt-8"></div>
+
+              <p className="mt-8 text-xl text-ink-light leading-relaxed max-w-lg">
+                Crea, programma e pubblica contenuti su tutti i tuoi canali social.
+                Minimo sforzo, massima resa.
+              </p>
+
+              <div className="mt-10 flex flex-col sm:flex-row gap-4">
+                <Link href="/register/" className="btn-primary text-center">
+                  Inizia gratis
+                </Link>
+                <Link href="/login/" className="btn-secondary text-center">
+                  Ho già un account
+                </Link>
+              </div>
+
+              <p className="mt-6 text-sm text-muted">
+                Nessuna carta richiesta · Piano gratuito per sempre
+              </p>
+            </div>
+
+            {/* Right Column - Visual */}
+            <div className="opacity-0 animate-fade-up stagger-2 hidden lg:block">
+              <div className="relative">
+                {/* Decorative background */}
+                <div className="absolute -inset-4 bg-cream-dark rounded-sm -rotate-2"></div>
+
+                {/* Main card */}
+                <div className="card-editorial relative">
+                  <div className="space-y-6">
+                    {/* Fake chat message */}
+                    <div className="flex gap-4">
+                      <div className="w-10 h-10 rounded-full bg-accent/20 flex items-center justify-center flex-shrink-0">
+                        <span className="text-accent font-display font-semibold">L</span>
+                      </div>
+                      <div>
+                        <p className="font-medium text-sm">Leopost AI</p>
+                        <p className="mt-1 text-ink-light">
+                          Ho preparato 3 post per la tua pagina Instagram.
+                          Vuoi che li programmi per la prossima settimana?
+                        </p>
+                      </div>
+                    </div>
+
+                    {/* Divider */}
+                    <div className="border-t border-editorial"></div>
+
+                    {/* Post preview cards */}
+                    <div className="grid grid-cols-3 gap-3">
+                      <div className="aspect-square bg-cream-dark rounded-sm flex items-center justify-center">
+                        <span className="text-2xl">📸</span>
+                      </div>
+                      <div className="aspect-square bg-cream-dark rounded-sm flex items-center justify-center">
+                        <span className="text-2xl">✨</span>
+                      </div>
+                      <div className="aspect-square bg-cream-dark rounded-sm flex items-center justify-center">
+                        <span className="text-2xl">🎯</span>
+                      </div>
+                    </div>
+
+                    {/* Action buttons */}
+                    <div className="flex gap-3">
+                      <button className="flex-1 py-2 text-sm font-medium bg-ink text-cream">
+                        Programma tutti
+                      </button>
+                      <button className="flex-1 py-2 text-sm font-medium border border-editorial">
+                        Modifica
+                      </button>
+                    </div>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </div>
+        </div>
+      </section>
+
+      {/* Features Section */}
+      <section className="py-20 px-6 bg-cream-dark">
+        <div className="max-w-6xl mx-auto">
+          <div className="text-center mb-16 opacity-0 animate-fade-up">
+            <span className="editorial-tag">Come funziona</span>
+            <h2 className="mt-4 text-4xl font-display font-semibold">
+              Tre passi verso la libertà editoriale
+            </h2>
+          </div>
+
+          <div className="grid md:grid-cols-3 gap-8">
+            {/* Feature 1 */}
+            <div className="opacity-0 animate-fade-up stagger-1">
+              <div className="text-5xl font-display font-semibold text-accent/30">01</div>
+              <h3 className="mt-4 text-xl font-display font-semibold">Connetti i tuoi canali</h3>
+              <p className="mt-2 text-ink-light">
+                Collega Facebook, Instagram e gli altri social in pochi click.
+              </p>
+            </div>
+
+            {/* Feature 2 */}
+            <div className="opacity-0 animate-fade-up stagger-2">
+              <div className="text-5xl font-display font-semibold text-accent/30">02</div>
+              <h3 className="mt-4 text-xl font-display font-semibold">Chatta con l&apos;AI</h3>
+              <p className="mt-2 text-ink-light">
+                Descrivi cosa vuoi comunicare. L&apos;AI crea contenuti su misura per te.
+              </p>
+            </div>
+
+            {/* Feature 3 */}
+            <div className="opacity-0 animate-fade-up stagger-3">
+              <div className="text-5xl font-display font-semibold text-accent/30">03</div>
+              <h3 className="mt-4 text-xl font-display font-semibold">Rilassati</h3>
+              <p className="mt-2 text-ink-light">
+                Leopost pubblica automaticamente. Tu pensa al tuo business.
+              </p>
+            </div>
+          </div>
+        </div>
+      </section>
+
+      {/* CTA Section */}
+      <section className="py-20 px-6">
+        <div className="max-w-3xl mx-auto text-center opacity-0 animate-fade-up">
+          <h2 className="text-4xl md:text-5xl font-display font-semibold">
+            Pronto a trasformare
+            <br />
+            la tua presenza social?
+          </h2>
+          <div className="editorial-line mx-auto mt-8"></div>
+          <p className="mt-8 text-xl text-ink-light">
+            Inizia oggi con il piano gratuito. Nessun vincolo.
+          </p>
+          <div className="mt-10">
+            <Link href="/register/" className="btn-primary inline-block">
+              Crea il tuo account
+            </Link>
+          </div>
+        </div>
+      </section>
+
+      {/* Footer */}
+      <footer className="py-8 px-6 border-t border-editorial">
+        <div className="max-w-6xl mx-auto flex flex-col md:flex-row items-center justify-between gap-4">
+          <div className="font-display text-lg font-semibold">Leopost</div>
+          <p className="text-sm text-muted">
+            © 2026 Leopost. Tutti i diritti riservati.
+          </p>
+        </div>
+      </footer>
+    </main>
+  )
+}

src/components/auth/google-button.tsx

@@ -0,0 +1,71 @@
+'use client'
+
+import { createClient } from '@/lib/supabase/client'
+import { Button } from '@/components/ui/button'
+import { useState } from 'react'
+
+// Simple Google icon SVG
+function GoogleIcon({ className }: { className?: string }) {
+  return (
+    <svg className={className} viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+      <path
+        d="M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09z"
+        fill="#4285F4"
+      />
+      <path
+        d="M12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23z"
+        fill="#34A853"
+      />
+      <path
+        d="M5.84 14.09c-.22-.66-.35-1.36-.35-2.09s.13-1.43.35-2.09V7.07H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.93l2.85-2.22.81-.62z"
+        fill="#FBBC05"
+      />
+      <path
+        d="M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.07l3.66 2.84c.87-2.6 3.3-4.53 6.16-4.53z"
+        fill="#EA4335"
+      />
+    </svg>
+  )
+}
+
+export function GoogleSignInButton() {
+  const [loading, setLoading] = useState(false)
+  const supabase = createClient()
+
+  // Use configured APP_URL for OAuth callback
+  const appUrl = process.env.NEXT_PUBLIC_APP_URL || window.location.origin
+
+  async function handleGoogleSignIn() {
+    setLoading(true)
+
+    const { error } = await supabase.auth.signInWithOAuth({
+      provider: 'google',
+      options: {
+        redirectTo: `${appUrl}/auth/callback/`,
+        queryParams: {
+          access_type: 'offline',
+          prompt: 'consent',
+        },
+      },
+    })
+
+    if (error) {
+      console.error('Google sign-in error:', error)
+      setLoading(false)
+    }
+    // Note: No need to handle success - user is redirected to Google
+  }
+
+  return (
+    <Button
+      type="button"
+      variant="outline"
+      onClick={handleGoogleSignIn}
+      disabled={loading}
+      className="w-full flex items-center justify-center gap-3 h-12 text-base"
+    >
+      <GoogleIcon className="w-5 h-5" />
+      {loading ? 'Reindirizzamento...' : 'Continua con Google'}
+    </Button>
+  )
+}

src/components/auth/login-form.tsx

@@ -0,0 +1,96 @@
+'use client'
+
+import { Button } from '@/components/ui/button'
+import { Input } from '@/components/ui/input'
+import Link from 'next/link'
+import { useState } from 'react'
+import { createClient } from '@/lib/supabase/client'
+import { useRouter } from 'next/navigation'
+
+export function LoginForm() {
+  const [email, setEmail] = useState('')
+  const [password, setPassword] = useState('')
+  const [error, setError] = useState<string | null>(null)
+  const [loading, setLoading] = useState(false)
+  const router = useRouter()
+  const supabase = createClient()
+
+  async function handleSubmit(e: React.FormEvent) {
+    e.preventDefault()
+    setError(null)
+    setLoading(true)
+
+    const { error: signInError } = await supabase.auth.signInWithPassword({
+      email,
+      password,
+    })
+
+    if (signInError) {
+      // SPECIFIC error messages per user requirement
+      if (signInError.message.includes('Invalid login credentials')) {
+        setError('Email o password errata')
+      } else if (signInError.message.includes('Email not confirmed')) {
+        setError('Devi confermare la tua email prima di accedere')
+      } else {
+        setError(signInError.message)
+      }
+      setLoading(false)
+      return
+    }
+
+    router.push('/dashboard')
+    router.refresh()
+  }
+
+  return (
+    <form onSubmit={handleSubmit} className="space-y-5">
+      {error && (
+        <div className="p-4 bg-error-light border-l-4 border-error">
+          <p className="text-error text-sm">{error}</p>
+        </div>
+      )}
+
+      <div>
+        <label htmlFor="email" className="block text-sm font-medium text-ink mb-2">
+          Email
+        </label>
+        <Input
+          id="email"
+          name="email"
+          type="email"
+          autoComplete="email"
+          required
+          placeholder="tu@esempio.com"
+          value={email}
+          onChange={(e) => setEmail(e.target.value)}
+        />
+      </div>
+
+      <div>
+        <label htmlFor="password" className="block text-sm font-medium text-ink mb-2">
+          Password
+        </label>
+        <Input
+          id="password"
+          name="password"
+          type="password"
+          autoComplete="current-password"
+          required
+          placeholder="La tua password"
+          value={password}
+          onChange={(e) => setPassword(e.target.value)}
+        />
+      </div>
+
+      <div className="flex items-center justify-end">
+        <Link href="/reset-password/" className="text-sm text-accent hover:underline">
+          Password dimenticata?
+        </Link>
+      </div>
+
+      <Button type="submit" className="w-full h-12 text-base" disabled={loading}>
+        {loading ? 'Accesso in corso...' : 'Accedi'}
+      </Button>
+    </form>
+  )
+}

src/components/auth/register-form.tsx

@@ -0,0 +1,171 @@
+'use client'
+
+import { Button } from '@/components/ui/button'
+import { Input } from '@/components/ui/input'
+import Link from 'next/link'
+import { useState } from 'react'
+import { createClient } from '@/lib/supabase/client'
+
+export function RegisterForm() {
+  const [email, setEmail] = useState('')
+  const [password, setPassword] = useState('')
+  const [confirmPassword, setConfirmPassword] = useState('')
+  const [error, setError] = useState<string | null>(null)
+  const [fieldErrors, setFieldErrors] = useState<Record<string, string>>({})
+  const [loading, setLoading] = useState(false)
+  const [success, setSuccess] = useState(false)
+  const supabase = createClient()
+
+  function validatePassword(pwd: string): string | null {
+    if (pwd.length < 8) {
+      return 'La password deve contenere almeno 8 caratteri'
+    }
+    if (!/[0-9]/.test(pwd)) {
+      return 'La password deve contenere almeno un numero'
+    }
+    if (!/[A-Z]/.test(pwd)) {
+      return 'La password deve contenere almeno una lettera maiuscola'
+    }
+    return null
+  }
+
+  async function handleSubmit(e: React.FormEvent) {
+    e.preventDefault()
+    setError(null)
+    setFieldErrors({})
+    setLoading(true)
+
+    // Validate password
+    const passwordError = validatePassword(password)
+    if (passwordError) {
+      setFieldErrors({ password: passwordError })
+      setLoading(false)
+      return
+    }
+
+    // Validate confirm password
+    if (password !== confirmPassword) {
+      setFieldErrors({ confirmPassword: 'Le password non coincidono' })
+      setLoading(false)
+      return
+    }
+
+    // Use configured APP_URL to include basePath in redirect
+    const appUrl = process.env.NEXT_PUBLIC_APP_URL || window.location.origin
+
+    const { error: signUpError } = await supabase.auth.signUp({
+      email,
+      password,
+      options: {
+        emailRedirectTo: `${appUrl}/auth/callback/`,
+      }
+    })
+
+    if (signUpError) {
+      // SPECIFIC error messages per user requirement
+      if (signUpError.message.includes('already registered')) {
+        setError('Questa email e gia registrata')
+      } else if (signUpError.message.includes('invalid')) {
+        setError('Email non valida')
+      } else {
+        setError(signUpError.message)
+      }
+      setLoading(false)
+      return
+    }
+
+    setSuccess(true)
+    setLoading(false)
+  }
+
+  if (success) {
+    return (
+      <div className="text-center">
+        <div className="mb-6 p-6 bg-success-light border-l-4 border-success">
+          <p className="text-success font-medium">
+            Registrazione completata!
+          </p>
+          <p className="mt-2 text-ink-light text-sm">
+            Controlla la tua email per confermare l&apos;account.
+          </p>
+        </div>
+        <Link href="/login/" className="text-accent hover:underline font-medium">
+          Torna al login
+        </Link>
+      </div>
+    )
+  }
+
+  return (
+    <form onSubmit={handleSubmit} className="space-y-5">
+      {error && (
+        <div className="p-4 bg-error-light border-l-4 border-error">
+          <p className="text-error text-sm">{error}</p>
+        </div>
+      )}
+
+      <div>
+        <label htmlFor="email" className="block text-sm font-medium text-ink mb-2">
+          Email
+        </label>
+        <Input
+          id="email"
+          name="email"
+          type="email"
+          autoComplete="email"
+          required
+          placeholder="tu@esempio.com"
+          value={email}
+          onChange={(e) => setEmail(e.target.value)}
+        />
+      </div>
+
+      <div>
+        <label htmlFor="password" className="block text-sm font-medium text-ink mb-2">
+          Password
+        </label>
+        <Input
+          id="password"
+          name="password"
+          type="password"
+          autoComplete="new-password"
+          required
+          placeholder="Minimo 8 caratteri"
+          value={password}
+          onChange={(e) => setPassword(e.target.value)}
+          error={!!fieldErrors.password}
+        />
+        {fieldErrors.password && (
+          <p className="mt-2 text-sm text-error">{fieldErrors.password}</p>
+        )}
+        <p className="mt-2 text-xs text-muted">
+          Almeno 8 caratteri, 1 numero, 1 maiuscola
+        </p>
+      </div>
+
+      <div>
+        <label htmlFor="confirmPassword" className="block text-sm font-medium text-ink mb-2">
+          Conferma Password
+        </label>
+        <Input
+          id="confirmPassword"
+          name="confirmPassword"
+          type="password"
+          autoComplete="new-password"
+          required
+          placeholder="Ripeti la password"
+          value={confirmPassword}
+          onChange={(e) => setConfirmPassword(e.target.value)}
+          error={!!fieldErrors.confirmPassword}
+        />
+        {fieldErrors.confirmPassword && (
+          <p className="mt-2 text-sm text-error">{fieldErrors.confirmPassword}</p>
+        )}
+      </div>
+
+      <Button type="submit" className="w-full h-12 text-base" disabled={loading}>
+        {loading ? 'Registrazione...' : 'Crea account'}
+      </Button>
+    </form>
+  )
+}

src/components/layout/user-nav.tsx

@@ -0,0 +1,60 @@
+'use client'
+
+import { createClient } from '@/lib/supabase/client'
+import { useRouter } from 'next/navigation'
+import { Button } from '@/components/ui/button'
+import { useState } from 'react'
+
+interface UserNavProps {
+  email: string
+  planName?: string
+}
+
+export function UserNav({ email, planName }: UserNavProps) {
+  const [loading, setLoading] = useState(false)
+  const router = useRouter()
+  const supabase = createClient()
+
+  async function handleSignOut() {
+    setLoading(true)
+    await supabase.auth.signOut()
+    router.push('/login')
+    router.refresh()
+  }
+
+  // Get initials from email
+  const initials = email
+    .split('@')[0]
+    .split(/[._-]/)
+    .slice(0, 2)
+    .map(part => part.charAt(0).toUpperCase())
+    .join('')
+
+  return (
+    <div className="flex items-center gap-4">
+      {/* Avatar */}
+      <div className="w-9 h-9 bg-ink flex items-center justify-center">
+        <span className="text-cream text-sm font-medium">{initials}</span>
+      </div>
+
+      {/* Info */}
+      <div className="hidden sm:block text-sm text-right">
+        <p className="font-medium text-ink">{email}</p>
+        {planName && (
+          <p className="text-ink-muted text-xs">Piano {planName}</p>
+        )}
+      </div>
+
+      {/* Logout button */}
+      <Button
+        variant="ghost"
+        size="sm"
+        onClick={handleSignOut}
+        disabled={loading}
+        className="text-ink-light hover:text-ink"
+      >
+        {loading ? 'Uscita...' : 'Esci'}
+      </Button>
+    </div>
+  )
+}

src/components/subscription/plan-card.tsx

@@ -0,0 +1,124 @@
+'use client'
+
+import { Plan, PlanFeatures } from '@/types/database'
+import { formatFeatureValue, formatPrice, FEATURE_LABELS } from '@/lib/plans'
+import { Button } from '@/components/ui/button'
+import { switchPlan } from '@/app/actions/subscription'
+import { useTransition } from 'react'
+import { useRouter } from 'next/navigation'
+
+interface PlanCardProps {
+  plan: Plan
+  isCurrentPlan: boolean
+  onPlanChange?: () => void
+}
+
+export function PlanCard({ plan, isCurrentPlan, onPlanChange }: PlanCardProps) {
+  const [isPending, startTransition] = useTransition()
+  const router = useRouter()
+
+  const features = plan.features as PlanFeatures
+
+  function handleSwitchPlan() {
+    startTransition(async () => {
+      const result = await switchPlan(plan.id)
+      if (result.success) {
+        router.refresh()
+        if (onPlanChange) {
+          onPlanChange()
+        }
+      }
+    })
+  }
+
+  // Highlight features to show
+  const displayFeatures: (keyof PlanFeatures)[] = [
+    'posts_per_month',
+    'social_accounts',
+    'ai_models',
+    'image_generation',
+    'automation',
+  ]
+
+  const isPro = plan.name === 'pro'
+
+  return (
+    <div className={`relative bg-white border ${isCurrentPlan ? 'border-accent' : 'border-editorial'} ${isPro ? 'ring-2 ring-ink' : ''}`}>
+      {/* Top accent bar */}
+      <div className={`h-1 ${isPro ? 'bg-ink' : isCurrentPlan ? 'bg-accent' : 'bg-cream-dark'}`}></div>
+
+      {/* Current plan badge */}
+      {isCurrentPlan && (
+        <div className="absolute -top-3 left-1/2 -translate-x-1/2">
+          <span className="bg-accent text-white text-xs font-medium px-3 py-1">
+            Piano attuale
+          </span>
+        </div>
+      )}
+
+      {/* Header */}
+      <div className="p-6 text-center border-b border-editorial">
+        <span className="editorial-tag">
+          {plan.display_name_it}
+        </span>
+        <div className="mt-4 font-display text-4xl font-semibold text-ink">
+          {formatPrice(plan.price_monthly)}
+        </div>
+        <p className="mt-2 text-sm text-ink-light">
+          {plan.name === 'free' && 'Perfetto per iniziare'}
+          {plan.name === 'creator' && 'Per creator seri'}
+          {plan.name === 'pro' && 'Per professionisti'}
+        </p>
+      </div>
+
+      {/* Features */}
+      <div className="p-6">
+        <ul className="space-y-4">
+          {displayFeatures.map((featureKey) => {
+            const value = features[featureKey]
+            const isIncluded = value !== false
+
+            return (
+              <li key={featureKey} className="flex items-center gap-3">
+                <span className={`w-5 h-5 flex items-center justify-center text-xs font-medium ${
+                  isIncluded ? 'bg-success text-white' : 'bg-cream-dark text-ink-muted'
+                }`}>
+                  {isIncluded ? '✓' : '—'}
+                </span>
+                <span className="text-sm">
+                  <span className="font-medium text-ink">
+                    {formatFeatureValue(featureKey, value)}
+                  </span>
+                  {' '}
+                  <span className="text-ink-light">
+                    {FEATURE_LABELS[featureKey].toLowerCase()}
+                  </span>
+                </span>
+              </li>
+            )
+          })}
+        </ul>
+      </div>
+
+      {/* Footer */}
+      <div className="p-6 pt-0">
+        {isCurrentPlan ? (
+          <Button variant="outline" className="w-full" disabled>
+            Piano attuale
+          </Button>
+        ) : (
+          <Button
+            className="w-full"
+            onClick={handleSwitchPlan}
+            disabled={isPending}
+            variant={isPro ? 'default' : 'outline'}
+          >
+            {isPending ? 'Cambio in corso...' : (
+              plan.price_monthly === 0 ? 'Passa a Gratuito' : `Passa a ${plan.display_name_it}`
+            )}
+          </Button>
+        )}
+      </div>
+    </div>
+  )
+}

src/components/ui/button.tsx

@@ -0,0 +1,44 @@
+import { forwardRef, ButtonHTMLAttributes } from 'react'
+import { cn } from '@/lib/utils'
+
+export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+  variant?: 'default' | 'outline' | 'ghost' | 'accent'
+  size?: 'default' | 'sm' | 'lg'
+}
+
+const Button = forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant = 'default', size = 'default', ...props }, ref) => {
+    return (
+      <button
+        className={cn(
+          'inline-flex items-center justify-center font-medium transition-all duration-200',
+          'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-accent focus-visible:ring-offset-2',
+          'disabled:pointer-events-none disabled:opacity-50',
+          // Variants
+          {
+            // Primary - Black button
+            'btn-primary': variant === 'default',
+            // Outline - Border button (uses CSS class for reliable hover)
+            'btn-outline': variant === 'outline',
+            // Ghost - No background
+            'text-ink hover:bg-cream-dark': variant === 'ghost',
+            // Accent - Coral button
+            'bg-accent text-white hover:bg-accent-hover': variant === 'accent',
+          },
+          // Sizes - No border radius for editorial style
+          {
+            'h-11 px-5 py-2': size === 'default',
+            'h-9 px-4 text-sm': size === 'sm',
+            'h-13 px-8 text-lg': size === 'lg',
+          },
+          className
+        )}
+        ref={ref}
+        {...props}
+      />
+    )
+  }
+)
+Button.displayName = 'Button'
+
+export { Button }

src/components/ui/card.tsx

@@ -0,0 +1,69 @@
+import { HTMLAttributes, forwardRef } from 'react'
+import { cn } from '@/lib/utils'
+
+const Card = forwardRef<HTMLDivElement, HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      className={cn(
+        'rounded-lg border border-gray-200 bg-white shadow-sm',
+        className
+      )}
+      {...props}
+    />
+  )
+)
+Card.displayName = 'Card'
+
+const CardHeader = forwardRef<HTMLDivElement, HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      className={cn('flex flex-col space-y-1.5 p-6', className)}
+      {...props}
+    />
+  )
+)
+CardHeader.displayName = 'CardHeader'
+
+const CardTitle = forwardRef<HTMLParagraphElement, HTMLAttributes<HTMLHeadingElement>>(
+  ({ className, ...props }, ref) => (
+    <h3
+      ref={ref}
+      className={cn('text-2xl font-semibold leading-none tracking-tight', className)}
+      {...props}
+    />
+  )
+)
+CardTitle.displayName = 'CardTitle'
+
+const CardDescription = forwardRef<HTMLParagraphElement, HTMLAttributes<HTMLParagraphElement>>(
+  ({ className, ...props }, ref) => (
+    <p
+      ref={ref}
+      className={cn('text-sm text-gray-500', className)}
+      {...props}
+    />
+  )
+)
+CardDescription.displayName = 'CardDescription'
+
+const CardContent = forwardRef<HTMLDivElement, HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div ref={ref} className={cn('p-6 pt-0', className)} {...props} />
+  )
+)
+CardContent.displayName = 'CardContent'
+
+const CardFooter = forwardRef<HTMLDivElement, HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      className={cn('flex items-center p-6 pt-0', className)}
+      {...props}
+    />
+  )
+)
+CardFooter.displayName = 'CardFooter'
+
+export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent }

src/components/ui/input.tsx

@@ -0,0 +1,29 @@
+import { forwardRef, InputHTMLAttributes } from 'react'
+import { cn } from '@/lib/utils'
+
+export interface InputProps extends InputHTMLAttributes<HTMLInputElement> {
+  error?: boolean
+}
+
+const Input = forwardRef<HTMLInputElement, InputProps>(
+  ({ className, error, ...props }, ref) => {
+    return (
+      <input
+        className={cn(
+          'flex h-11 w-full border bg-white px-4 py-2 text-base',
+          'placeholder:text-ink-muted',
+          'focus:outline-none focus:border-ink',
+          'disabled:cursor-not-allowed disabled:opacity-50',
+          'transition-colors duration-200',
+          error ? 'border-error' : 'border-editorial',
+          className
+        )}
+        ref={ref}
+        {...props}
+      />
+    )
+  }
+)
+Input.displayName = 'Input'
+
+export { Input }

src/lib/plans.ts

@@ -0,0 +1,49 @@
+import { PlanFeatures } from '@/types/database'
+
+export const PLAN_DISPLAY_ORDER = ['free', 'creator', 'pro'] as const
+
+// Feature display names in Italian
+export const FEATURE_LABELS: Record<keyof PlanFeatures, string> = {
+  posts_per_month: 'Post al mese',
+  ai_models: 'Modelli AI',
+  social_accounts: 'Account social',
+  image_generation: 'Generazione immagini',
+  automation: 'Automazione',
+}
+
+export function formatFeatureValue(
+  key: keyof PlanFeatures,
+  value: PlanFeatures[keyof PlanFeatures]
+): string {
+  if (typeof value === 'boolean') {
+    return value ? 'Incluso' : 'Non incluso'
+  }
+
+  if (Array.isArray(value)) {
+    return value.length.toString()
+  }
+
+  if (key === 'automation') {
+    if (value === 'manual') return 'Solo manuale'
+    if (value === 'full') return 'Completa'
+    return 'Non inclusa'
+  }
+
+  return value.toString()
+}
+
+export function formatPrice(cents: number): string {
+  if (cents === 0) return 'Gratis'
+  return `${(cents / 100).toFixed(0)}/mese`
+}
+
+export function getPlanBadgeColor(planName: string): string {
+  switch (planName) {
+    case 'pro':
+      return 'bg-purple-100 text-purple-800 border-purple-200'
+    case 'creator':
+      return 'bg-blue-100 text-blue-800 border-blue-200'
+    default:
+      return 'bg-gray-100 text-gray-800 border-gray-200'
+  }
+}

src/lib/schemas/auth.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod'
+
+export const registerSchema = z.object({
+  email: z.string()
+    .email('Email non valida'),
+  password: z.string()
+    .min(8, 'La password deve contenere almeno 8 caratteri')
+    .regex(/[0-9]/, 'La password deve contenere almeno un numero')
+    .regex(/[A-Z]/, 'La password deve contenere almeno una lettera maiuscola'),
+  confirmPassword: z.string()
+}).refine((data) => data.password === data.confirmPassword, {
+  message: 'Le password non coincidono',
+  path: ['confirmPassword'],
+})
+
+export const loginSchema = z.object({
+  email: z.string().email('Email non valida'),
+  password: z.string().min(1, 'Password richiesta'),
+})
+
+export const resetPasswordSchema = z.object({
+  email: z.string().email('Email non valida'),
+})
+
+export const updatePasswordSchema = z.object({
+  password: z.string()
+    .min(8, 'La password deve contenere almeno 8 caratteri')
+    .regex(/[0-9]/, 'La password deve contenere almeno un numero')
+    .regex(/[A-Z]/, 'La password deve contenere almeno una lettera maiuscola'),
+  confirmPassword: z.string()
+}).refine((data) => data.password === data.confirmPassword, {
+  message: 'Le password non coincidono',
+  path: ['confirmPassword'],
+})
+
+export type RegisterInput = z.infer<typeof registerSchema>
+export type LoginInput = z.infer<typeof loginSchema>
+export type ResetPasswordInput = z.infer<typeof resetPasswordSchema>
+export type UpdatePasswordInput = z.infer<typeof updatePasswordSchema>

src/lib/supabase/client.ts

@@ -0,0 +1,8 @@
+import { createBrowserClient } from '@supabase/ssr'
+
+export function createClient() {
+  return createBrowserClient(
+    process.env.NEXT_PUBLIC_SUPABASE_URL!,
+    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
+  )
+}

src/lib/supabase/middleware.ts

@@ -0,0 +1,37 @@
+import { createServerClient } from '@supabase/ssr'
+import { NextResponse, type NextRequest } from 'next/server'
+
+export async function updateSession(request: NextRequest) {
+  let supabaseResponse = NextResponse.next({
+    request,
+  })
+
+  const supabase = createServerClient(
+    process.env.NEXT_PUBLIC_SUPABASE_URL!,
+    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
+    {
+      cookies: {
+        getAll() {
+          return request.cookies.getAll()
+        },
+        setAll(cookiesToSet) {
+          cookiesToSet.forEach(({ name, value }) =>
+            request.cookies.set(name, value)
+          )
+          supabaseResponse = NextResponse.next({
+            request,
+          })
+          cookiesToSet.forEach(({ name, value, options }) =>
+            supabaseResponse.cookies.set(name, value, options)
+          )
+        },
+      },
+    }
+  )
+
+  // IMPORTANT: Do not remove this line
+  // Refreshing the auth token is crucial for keeping the session alive
+  const { data: { user } } = await supabase.auth.getUser()
+
+  return { supabaseResponse, user }
+}

src/lib/supabase/server.ts

@@ -0,0 +1,28 @@
+import { createServerClient } from '@supabase/ssr'
+import { cookies } from 'next/headers'
+
+export async function createClient() {
+  const cookieStore = await cookies()
+
+  return createServerClient(
+    process.env.NEXT_PUBLIC_SUPABASE_URL!,
+    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
+    {
+      cookies: {
+        getAll() {
+          return cookieStore.getAll()
+        },
+        setAll(cookiesToSet) {
+          try {
+            cookiesToSet.forEach(({ name, value, options }) =>
+              cookieStore.set(name, value, options)
+            )
+          } catch {
+            // The `setAll` method was called from a Server Component.
+            // This can be ignored if you have middleware refreshing user sessions.
+          }
+        },
+      },
+    }
+  )
+}

src/lib/utils.ts

@@ -0,0 +1,6 @@
+import { type ClassValue, clsx } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

src/types/database.ts

@@ -0,0 +1,29 @@
+export interface Plan {
+  id: string
+  name: 'free' | 'creator' | 'pro'
+  display_name: string
+  display_name_it: string
+  price_monthly: number
+  features: PlanFeatures
+  created_at: string
+}
+
+export interface PlanFeatures {
+  posts_per_month: number
+  ai_models: string[]
+  social_accounts: number
+  image_generation: boolean
+  automation: boolean | 'manual' | 'full'
+}
+
+export interface Profile {
+  id: string
+  tenant_id: string
+  plan_id: string
+  email: string
+  full_name: string | null
+  avatar_url: string | null
+  created_at: string
+  updated_at: string
+  plans?: Plan
+}

supabase/migrations/001_initial_auth_setup.sql

@@ -0,0 +1,176 @@
+-- Migration: 001_initial_auth_setup.sql
+-- Purpose: Create plans, profiles tables with RLS for multi-tenant auth
+-- Created: 2026-01-31
+-- Phase: 01-foundation-auth, Plan: 02
+
+-- ============================================
+-- PLANS TABLE
+-- ============================================
+
+CREATE TABLE public.plans (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name TEXT NOT NULL UNIQUE CHECK (name IN ('free', 'creator', 'pro')),
+  display_name TEXT NOT NULL,
+  display_name_it TEXT NOT NULL,  -- Italian display name
+  price_monthly INTEGER NOT NULL CHECK (price_monthly >= 0),  -- cents
+  features JSONB NOT NULL DEFAULT '{}',
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Insert default plans
+INSERT INTO public.plans (name, display_name, display_name_it, price_monthly, features) VALUES
+('free', 'Free', 'Gratuito', 0, '{
+  "posts_per_month": 10,
+  "ai_models": ["gpt-4o-mini"],
+  "social_accounts": 1,
+  "image_generation": false,
+  "automation": false
+}'),
+('creator', 'Creator', 'Creator', 1900, '{
+  "posts_per_month": 50,
+  "ai_models": ["gpt-4o-mini", "gpt-4o", "claude-3-5-sonnet"],
+  "social_accounts": 3,
+  "image_generation": true,
+  "automation": "manual"
+}'),
+('pro', 'Pro', 'Pro', 4900, '{
+  "posts_per_month": 200,
+  "ai_models": ["gpt-4o-mini", "gpt-4o", "claude-3-5-sonnet", "claude-opus-4"],
+  "social_accounts": 10,
+  "image_generation": true,
+  "automation": "full"
+}');
+
+-- ============================================
+-- PROFILES TABLE
+-- ============================================
+
+CREATE TABLE public.profiles (
+  id UUID PRIMARY KEY REFERENCES auth.users(id) ON DELETE CASCADE,
+  tenant_id UUID NOT NULL DEFAULT gen_random_uuid(),
+  plan_id UUID REFERENCES public.plans(id) NOT NULL DEFAULT (SELECT id FROM public.plans WHERE name = 'free'),
+  email TEXT NOT NULL,
+  full_name TEXT,
+  avatar_url TEXT,
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Performance indexes
+CREATE INDEX idx_profiles_tenant_id ON public.profiles(tenant_id);
+CREATE INDEX idx_profiles_plan_id ON public.profiles(plan_id);
+CREATE INDEX idx_profiles_email ON public.profiles(email);
+
+-- ============================================
+-- ROW LEVEL SECURITY
+-- ============================================
+
+-- Enable RLS on all tables (CRITICAL - never skip this)
+ALTER TABLE public.plans ENABLE ROW LEVEL SECURITY;
+ALTER TABLE public.profiles ENABLE ROW LEVEL SECURITY;
+
+-- Plans: Everyone can read (public info)
+CREATE POLICY "Plans are viewable by everyone"
+ON public.plans FOR SELECT
+TO authenticated, anon
+USING (true);
+
+-- Profiles: Users can only read their own profile
+-- IMPORTANT: Use (SELECT auth.uid()) for 99% performance improvement
+CREATE POLICY "Users can read own profile"
+ON public.profiles FOR SELECT
+TO authenticated
+USING ((SELECT auth.uid()) = id);
+
+-- Profiles: Users can update their own profile
+CREATE POLICY "Users can update own profile"
+ON public.profiles FOR UPDATE
+TO authenticated
+USING ((SELECT auth.uid()) = id)
+WITH CHECK ((SELECT auth.uid()) = id);
+
+-- Profiles: System can insert (via trigger)
+-- Note: INSERT policy needed because trigger runs as SECURITY DEFINER
+CREATE POLICY "System can insert profiles"
+ON public.profiles FOR INSERT
+TO authenticated
+WITH CHECK ((SELECT auth.uid()) = id);
+
+-- ============================================
+-- AUTO-CREATE PROFILE TRIGGER
+-- ============================================
+
+-- Function to create profile on user signup
+CREATE OR REPLACE FUNCTION public.handle_new_user()
+RETURNS TRIGGER AS $$
+BEGIN
+  INSERT INTO public.profiles (id, email, tenant_id, full_name, avatar_url)
+  VALUES (
+    NEW.id,
+    NEW.email,
+    gen_random_uuid(),  -- Each user gets unique tenant_id
+    COALESCE(NEW.raw_user_meta_data->>'full_name', NEW.raw_user_meta_data->>'name'),
+    NEW.raw_user_meta_data->>'avatar_url'
+  );
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql SECURITY DEFINER;
+
+-- Trigger on auth.users insert
+CREATE TRIGGER on_auth_user_created
+  AFTER INSERT ON auth.users
+  FOR EACH ROW
+  EXECUTE FUNCTION public.handle_new_user();
+
+-- ============================================
+-- HELPER FUNCTIONS
+-- ============================================
+
+-- Function to get current user's plan features (for API limit checking)
+CREATE OR REPLACE FUNCTION public.get_user_plan_features()
+RETURNS JSONB
+LANGUAGE SQL STABLE
+SECURITY DEFINER
+AS $$
+  SELECT p.features
+  FROM public.plans p
+  INNER JOIN public.profiles pr ON pr.plan_id = p.id
+  WHERE pr.id = (SELECT auth.uid());
+$$;
+
+-- Function to get current user's plan name
+CREATE OR REPLACE FUNCTION public.get_user_plan_name()
+RETURNS TEXT
+LANGUAGE SQL STABLE
+SECURITY DEFINER
+AS $$
+  SELECT p.name
+  FROM public.plans p
+  INNER JOIN public.profiles pr ON pr.plan_id = p.id
+  WHERE pr.id = (SELECT auth.uid());
+$$;
+
+-- Function to update profile's updated_at timestamp
+CREATE OR REPLACE FUNCTION public.update_updated_at()
+RETURNS TRIGGER AS $$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER profiles_updated_at
+  BEFORE UPDATE ON public.profiles
+  FOR EACH ROW
+  EXECUTE FUNCTION public.update_updated_at();
+
+-- ============================================
+-- GRANTS
+-- ============================================
+
+-- Grant usage to authenticated users
+GRANT USAGE ON SCHEMA public TO authenticated;
+GRANT SELECT ON public.plans TO authenticated;
+GRANT SELECT, UPDATE ON public.profiles TO authenticated;
+GRANT EXECUTE ON FUNCTION public.get_user_plan_features() TO authenticated;
+GRANT EXECUTE ON FUNCTION public.get_user_plan_name() TO authenticated;

supabase/seed.sql

@@ -0,0 +1,20 @@
+-- Seed file for development
+-- Note: Plans are already seeded in migration
+-- This file is for additional test data if needed
+--
+-- Phase: 01-foundation-auth, Plan: 02
+-- Created: 2026-01-31
+
+-- Verify plans exist
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM public.plans WHERE name = 'free') THEN
+    RAISE EXCEPTION 'Plans not found - run migration first';
+  END IF;
+END $$;
+
+-- Log seed completion
+DO $$
+BEGIN
+  RAISE NOTICE 'Seed completed. Plans available: free, creator, pro';
+END $$;

tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}