diff --git a/SESSION_HANDOVER_2025-11-13_1430.md b/SESSION_HANDOVER_2025-11-13_1430.md
new file mode 100644
index 0000000..10d2360
--- /dev/null
+++ b/SESSION_HANDOVER_2025-11-13_1430.md
@@ -0,0 +1,338 @@
+# NaviDocs Session Handover - 2025-11-13 14:30 UTC
+
+**Welcome to NaviDocs!** 🚢
+
+**Session Duration:** 3 hours (since last handover)
+**Status:** ✅ Cloud Sessions 1-5 Ready to Launch
+**GitHub:** https://github.com/dannystocker/navidocs (navidocs-cloud-coordination branch)
+**Builder Prompts:** https://github.com/dannystocker/navidocs/tree/navidocs-cloud-coordination/builder/prompts
+
+---
+
+## What Just Happened
+
+1. **Created builder/prompts directory structure:**
+   - `current/` - Active feature development (Sessions 1-5)
+   - `implementation/` - MVP feature builds (archived)
+   - `research/` - Strategy sessions (archived)
+
+2. **Created all 5 cloud session prompts:**
+   - Session 1: Smart OCR (60 min, 36x speedup)
+   - Session 2: Multi-format Upload (90 min, JPG/DOCX/XLSX/TXT/MD)
+   - Session 3: Timeline Feature (120 min, activity feed)
+   - Session 4: UI Polish & Testing (90 min, responsive + integration)
+   - Session 5: Deployment & Documentation (90 min, production ready)
+
+3. **Committed to GitHub:**
+   - Commit `32a4b07`: Builder prompts directory
+   - All prompts accessible via GitHub URLs
+   - Cloud sessions can poll for updates
+
+4. **Session Status:**
+   - Session 1: Started (user reported)
+   - Session 2: Started (user reported)
+   - Sessions 3-5: Ready to launch (prompts created)
+
+---
+
+## Current System Status
+
+### ✅ All Services Running (Local Dev)
+- **Backend API:** Port 8001 (uptime 3.5 hours)
+- **Frontend:** Port 8081 (Vue 3.5 + Vite)
+- **Meilisearch:** Port 7700 (1 document indexed)
+- **Redis:** Port 6379 (4 connected clients)
+- **OCR Worker:** Active
+
+### Test Credentials
+- **User:** test2@navidocs.test / TestPassword123
+- **User ID:** bef71b0c-3427-485b-b4dd-b6399f4d4c45
+- **Organization:** Test Yacht Azimut 55S
+- **Org ID:** 6ce0dfc7-f754-4122-afde-85154bc4d0ae
+
+### Working Documents
+- `31af1297-8a75-4925-a19b-920a619f1f9a` - Azimut 55S Bilge Pump Manual (SEARCHABLE ✓)
+- `efb25a15-7d84-4bc3-b070-6bd7dec8d59a` - Liliane1 Prestige Manual (RE-INDEXED ✓)
+
+---
+
+## Cloud Sessions (5 Parallel Tracks)
+
+### Session 1: Smart OCR 🏃
+**Status:** 🟡 STARTED (user confirmed)
+**Prompt:** https://github.com/dannystocker/navidocs/blob/navidocs-cloud-coordination/builder/prompts/current/session-1-smart-ocr.md
+**Branch:** `feature/smart-ocr`
+**Goal:** Extract native PDF text first, only OCR scanned pages
+**Performance:** 180s → 5s (36x speedup)
+**Dependencies:** `npm install pdfjs-dist`
+**Completion:** Estimated 60 minutes from start
+
+### Session 2: Multi-Format Upload 🏃
+**Status:** 🟡 STARTED (user confirmed)
+**Prompt:** https://github.com/dannystocker/navidocs/blob/navidocs-cloud-coordination/builder/prompts/current/session-2-multiformat.md
+**Branch:** `feature/multiformat`
+**Goal:** Enable JPG, PNG, DOCX, XLSX, TXT, MD uploads
+**Dependencies:** `npm install mammoth xlsx`
+**Completion:** Estimated 90 minutes from start
+
+### Session 3: Timeline Feature ⏳
+**Status:** ⏳ READY TO LAUNCH
+**Prompt:** https://github.com/dannystocker/navidocs/blob/navidocs-cloud-coordination/builder/prompts/current/session-3-timeline.md
+**Branch:** `feature/timeline`
+**Goal:** Organization activity timeline (reverse chronological)
+**Work:** Database migration + API + Frontend component
+**Completion:** Estimated 2 hours
+**Can Start:** Immediately (no dependencies on Sessions 1-2)
+
+### Session 4: UI Polish & Testing ⏳
+**Status:** ⏳ WAITING FOR SESSIONS 1-3
+**Prompt:** https://github.com/dannystocker/navidocs/blob/navidocs-cloud-coordination/builder/prompts/current/session-4-polish-testing.md
+**Branch:** `feature/polish-testing`
+**Goal:** Merge all features, polish UI, test integration
+**Work:** Responsive design, loading states, error handling
+**Completion:** Estimated 90 minutes
+**Dependencies:** Sessions 1, 2, 3 must push to GitHub first
+
+### Session 5: Deployment & Documentation ⏳
+**Status:** ⏳ WAITING FOR SESSION 4
+**Prompt:** https://github.com/dannystocker/navidocs/blob/navidocs-cloud-coordination/builder/prompts/current/session-5-deployment.md
+**Branch:** N/A (works on navidocs-cloud-coordination)
+**Goal:** Deploy to StackCP, create docs, tag v1.0-production
+**Work:** Deployment scripts, user guide, developer guide, SSL, monitoring
+**Completion:** Estimated 90 minutes
+**Dependencies:** Session 4 must complete
+
+---
+
+## Immediate Next Steps
+
+### For You (New Claude)
+1. **Monitor cloud session progress:**
+   - Check GitHub for new feature branches
+   - Review commits from Sessions 1 & 2
+   - Coordinate Session 3 launch
+
+2. **Launch Session 3 when ready:**
+   - Wait for user confirmation that Sessions 1-2 are underway
+   - Provide Session 3 prompt URL to user
+
+3. **Prepare for Session 4:**
+   - Session 4 will need to merge all features
+   - Watch for completion signals from Sessions 1-3
+
+### For Cloud Sessions (Instructions to Give User)
+
+**Session 1 Message:**
+```
+Hi Claude! Welcome to NaviDocs Cloud Session 1.
+Your mission: Smart OCR Implementation (60 minutes)
+📋 Full instructions:
+https://github.com/dannystocker/navidocs/blob/navidocs-cloud-coordination/builder/prompts/current/session-1-smart-ocr.md
+
+Setup:
+git clone https://github.com/dannystocker/navidocs.git
+git checkout navidocs-cloud-coordination
+git checkout -b feature/smart-ocr
+cd server && npm install pdfjs-dist
+
+Read the full prompt and start! 🚀
+```
+
+**Session 2 Message:**
+```
+Hi Claude! Welcome to NaviDocs Cloud Session 2.
+Your mission: Multi-Format Upload Support (90 minutes)
+📋 Full instructions:
+https://github.com/dannystocker/navidocs/blob/navidocs-cloud-coordination/builder/prompts/current/session-2-multiformat.md
+
+Setup:
+git clone https://github.com/dannystocker/navidocs.git
+git checkout navidocs-cloud-coordination
+git checkout -b feature/multiformat
+cd server && npm install mammoth xlsx
+
+Read the full prompt and start! 🚀
+```
+
+**Session 3 Message:**
+```
+Hi Claude! Welcome to NaviDocs Cloud Session 3.
+Your mission: Organization Timeline Feature (2 hours)
+📋 Full instructions:
+https://github.com/dannystocker/navidocs/blob/navidocs-cloud-coordination/builder/prompts/current/session-3-timeline.md
+
+Setup:
+git clone https://github.com/dannystocker/navidocs.git
+git checkout navidocs-cloud-coordination
+git checkout -b feature/timeline
+
+Read the full prompt and start! 🚀
+Independent work - no dependency on Sessions 1-2.
+```
+
+---
+
+## Key Files Reference
+
+### Prompts (GitHub)
+- **Session 1:** builder/prompts/current/session-1-smart-ocr.md
+- **Session 2:** builder/prompts/current/session-2-multiformat.md
+- **Session 3:** builder/prompts/current/session-3-timeline.md
+- **Session 4:** builder/prompts/current/session-4-polish-testing.md
+- **Session 5:** builder/prompts/current/session-5-deployment.md
+- **README:** builder/prompts/README.md (overview + status dashboard)
+
+### Specs & Plans
+- `IMPROVEMENT_PLAN_OCR_AND_UPLOADS.md` - Smart OCR + multi-format (comprehensive)
+- `FEATURE_SPEC_TIMELINE.md` - Timeline feature (database, API, frontend)
+- `LAUNCH_CHECKLIST.md` - Pre-launch verification (4 scripts)
+
+### Infrastructure
+- `pre-launch-checklist.sh` - Run before starting services
+- `verify-running.sh` - Verify all services operational
+- `debug-logs.sh` - Consolidated debugging
+- `version-check.sh` - Version fingerprint
+
+---
+
+## Git Status
+
+**Branch:** navidocs-cloud-coordination
+**Latest Commit:** 32a4b07 "[CLOUD PROMPTS] Add builder/prompts directory"
+**Parent Commit:** 28dbda1 "[HANDOVER] Session handover + cloud session 1 prompt ready"
+**Tag:** v0.5-demo-ready (2 commits behind)
+
+**Remotes:**
+- github: https://github.com/dannystocker/navidocs.git
+- origin: http://localhost:4000/ggq-admin/navidocs.git
+
+**Feature Branches Expected:**
+- `feature/smart-ocr` (Session 1, in progress)
+- `feature/multiformat` (Session 2, in progress)
+- `feature/timeline` (Session 3, not started)
+- `feature/polish-testing` (Session 4, not started)
+
+---
+
+## Current Blockers
+
+### Zero P0 Blockers ✅
+
+### P1 (Non-blocking)
+1. **Sessions 1-2 monitoring:** Need to verify they're making progress
+2. **Session 3 launch timing:** Wait for user confirmation to start
+3. **Session 4 coordination:** Will need all feature branches before starting
+
+---
+
+## Communication Protocol
+
+### Checking Session Progress
+
+```bash
+# Fetch latest from GitHub
+git fetch github
+
+# Check for feature branches
+git branch -r | grep feature/
+
+# Expected output (once sessions push):
+# remotes/github/feature/smart-ocr
+# remotes/github/feature/multiformat
+# remotes/github/feature/timeline
+```
+
+### Session Completion Signals
+
+Each session should:
+1. Push feature branch to GitHub
+2. Create `SESSION-N-COMPLETE.md` in repo root
+3. Report completion time and deliverables
+
+### User Updates
+
+Provide updates in this format:
+```
+📊 Cloud Session Status Update
+
+Session 1 (Smart OCR): 🟡 In Progress (40% - pdf-text-extractor.js created)
+Session 2 (Multi-format): 🟡 In Progress (30% - file-safety.js updated)
+Session 3 (Timeline): ⏳ Ready to launch
+Session 4 (Polish): ⏳ Waiting for Sessions 1-3
+Session 5 (Deploy): ⏳ Waiting for Session 4
+```
+
+---
+
+## Quick Commands
+
+```bash
+# Check local services
+./verify-running.sh
+
+# View OCR worker logs
+tail -f /tmp/navidocs-ocr-worker.log
+
+# Test search API
+curl -X POST http://localhost:8001/api/search \
+  -H "Authorization: Bearer [TOKEN]" \
+  -d '{"q":"bilge"}'
+
+# Check GitHub for new feature branches
+git fetch github && git branch -r
+
+# Read session prompts
+cat builder/prompts/current/session-*.md
+```
+
+---
+
+## Success Metrics
+
+**Current Progress:** 40/100 → 95/100 (Target)
+- Backend: 95/100 (stable)
+- Frontend: 60/100 (polishing in progress)
+- Database: 100/100 (migrations ready)
+- Upload: 90/100 (smart OCR in progress)
+- Search: 90/100 (working)
+- Timeline: 0/100 (Session 3 not started)
+
+**Target After All Sessions:**
+- Backend: 98/100
+- Frontend: 95/100
+- Database: 100/100
+- Upload: 100/100 (all formats + smart OCR)
+- Search: 95/100
+- Timeline: 100/100 (fully functional)
+
+**Overall Target:** 95/100 (Production Ready)
+
+---
+
+## Context for New Claude
+
+**What NaviDocs Does:**
+Boat documentation management platform for yacht owners. Store manuals, warranties, service records, and photos. Full-text search across all documents with OCR. Multi-tenant SaaS for boat clubs and marinas.
+
+**Why Cloud Sessions:**
+5 separate Claude Code instances (browser-based at claude.ai) working in parallel on different features. Each session has a dedicated prompt with implementation details. Sessions work independently, commit to feature branches, then Session 4 integrates everything.
+
+**Current Phase:**
+- ✅ v0.5 demo-ready (baseline working)
+- 🏃 Sessions 1-2 implementing OCR optimization + multi-format
+- ⏳ Sessions 3-5 ready to launch (timeline + polish + deploy)
+- 🎯 Target: v1.0 production deployment
+
+**Your Role:**
+Coordinate cloud sessions, monitor progress, launch Session 3 when ready, prepare for Session 4 integration. Think of yourself as the "project manager" orchestrating 5 parallel work streams.
+
+---
+
+**Welcome aboard! You're coordinating a 5-session cloud deployment for NaviDocs v1.0. Sessions 1-2 are running, Session 3 is ready to launch. Monitor GitHub for feature branch activity and guide the user on when to start Session 3! 🚀**
+
+**GitHub:** https://github.com/dannystocker/navidocs/tree/navidocs-cloud-coordination
+**Builder Prompts:** https://github.com/dannystocker/navidocs/tree/navidocs-cloud-coordination/builder/prompts
+**All Prompts Accessible:** Via GitHub URLs for cloud sessions on separate machines
+
+**Quick Start for User:**
+Tell Session 3: "Read https://github.com/dannystocker/navidocs/blob/navidocs-cloud-coordination/builder/prompts/current/session-3-timeline.md"
diff --git a/builder/prompts/current/session-3-timeline.md b/builder/prompts/current/session-3-timeline.md
new file mode 100644
index 0000000..878d7dd
--- /dev/null
+++ b/builder/prompts/current/session-3-timeline.md
@@ -0,0 +1,793 @@
+# Cloud Session 3: Organization Timeline Feature
+
+**Session ID:** session-3
+**Role:** Full-Stack Feature Engineer
+**Priority:** P1 (Core demo feature)
+**Estimated Time:** 2 hours (backend + frontend)
+**Dependencies:** None (can run parallel with Sessions 1 & 2)
+
+---
+
+## Your Mission
+
+Build an organization activity timeline showing chronological history of all events (uploads, maintenance, warranty claims) with most recent at top.
+
+**Current Gap:**
+- No way to see "what happened when" across the organization
+- Document uploads have no activity trail
+- Users can't track maintenance history chronologically
+
+**Expected Outcome:**
+- Timeline page at `/timeline` route
+- Reverse chronological feed (newest first)
+- Grouped by date (Today, Yesterday, This Week, etc.)
+- Event type filtering (uploads, maintenance, etc.)
+- Infinite scroll for history
+
+---
+
+## Implementation Steps
+
+### Phase 1: Database Layer (30 min)
+
+#### Step 1.1: Create Migration (10 min)
+
+**File:** `server/migrations/010_activity_timeline.sql` (NEW)
+
+```sql
+-- Activity Log for Organization Timeline
+-- Tracks all events: uploads, maintenance, warranty, settings changes
+
+CREATE TABLE IF NOT EXISTS activity_log (
+  id TEXT PRIMARY KEY,
+  organization_id TEXT NOT NULL,
+  entity_id TEXT,  -- Optional: boat/yacht ID if event is entity-specific
+  user_id TEXT NOT NULL,
+  event_type TEXT NOT NULL,  -- 'document_upload', 'maintenance_log', 'warranty_claim', 'settings_change'
+  event_action TEXT,  -- 'created', 'updated', 'deleted', 'viewed'
+  event_title TEXT NOT NULL,
+  event_description TEXT,
+  metadata TEXT,  -- JSON blob for event-specific data
+  reference_id TEXT,  -- ID of related resource (document_id, maintenance_id, etc.)
+  reference_type TEXT,  -- 'document', 'maintenance', 'warranty', etc.
+  created_at INTEGER NOT NULL,
+  FOREIGN KEY (organization_id) REFERENCES organizations(id) ON DELETE CASCADE,
+  FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE SET NULL
+);
+
+-- Indexes for fast timeline queries
+CREATE INDEX IF NOT EXISTS idx_activity_org_created
+  ON activity_log(organization_id, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_activity_entity
+  ON activity_log(entity_id, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_activity_type
+  ON activity_log(event_type);
+
+-- Test data (for demo)
+INSERT INTO activity_log (id, organization_id, user_id, event_type, event_action, event_title, event_description, created_at)
+VALUES
+  ('evt_demo_1', '6ce0dfc7-f754-4122-afde-85154bc4d0ae', 'bef71b0c-3427-485b-b4dd-b6399f4d4c45',
+   'document_upload', 'created', 'Bilge Pump Manual Uploaded',
+   'Azimut 55S Bilge Pump Manual.pdf (2.3MB)',
+   strftime('%s', 'now') * 1000);
+```
+
+#### Step 1.2: Run Migration (5 min)
+
+```bash
+cd /home/setup/navidocs/server
+node scripts/run-migration.js 010
+# Verify: sqlite3 navidocs.db "SELECT * FROM activity_log;"
+```
+
+#### Step 1.3: Create Activity Logger Service (15 min)
+
+**File:** `server/services/activity-logger.js` (NEW)
+
+```javascript
+/**
+ * Activity Logger Service
+ * Automatically logs events to organization timeline
+ */
+import { getDb } from '../config/db.js';
+import { v4 as uuidv4 } from 'uuid';
+
+export async function logActivity({
+  organizationId,
+  entityId = null,
+  userId,
+  eventType,
+  eventAction,
+  eventTitle,
+  eventDescription = '',
+  metadata = {},
+  referenceId = null,
+  referenceType = null
+}) {
+  const db = getDb();
+
+  const activity = {
+    id: `evt_${uuidv4()}`,
+    organization_id: organizationId,
+    entity_id: entityId,
+    user_id: userId,
+    event_type: eventType,
+    event_action: eventAction,
+    event_title: eventTitle,
+    event_description: eventDescription,
+    metadata: JSON.stringify(metadata),
+    reference_id: referenceId,
+    reference_type: referenceType,
+    created_at: Date.now()
+  };
+
+  db.prepare(`
+    INSERT INTO activity_log (
+      id, organization_id, entity_id, user_id, event_type, event_action,
+      event_title, event_description, metadata, reference_id, reference_type, created_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    activity.id,
+    activity.organization_id,
+    activity.entity_id,
+    activity.user_id,
+    activity.event_type,
+    activity.event_action,
+    activity.event_title,
+    activity.event_description,
+    activity.metadata,
+    activity.reference_id,
+    activity.reference_type,
+    activity.created_at
+  );
+
+  console.log(`[Activity Log] ${eventType}: ${eventTitle}`);
+  return activity;
+}
+```
+
+---
+
+### Phase 2: API Layer (30 min)
+
+#### Step 2.1: Create Timeline Route (20 min)
+
+**File:** `server/routes/timeline.js` (NEW)
+
+```javascript
+import express from 'express';
+import { getDb } from '../config/db.js';
+import { authenticateToken } from '../middleware/auth.js';
+
+const router = express.Router();
+
+router.get('/organizations/:orgId/timeline', authenticateToken, async (req, res) => {
+  const { orgId } = req.params;
+  const { limit = 50, offset = 0, eventType, entityId, startDate, endDate } = req.query;
+
+  // Verify user belongs to organization
+  if (req.user.organizationId !== orgId) {
+    return res.status(403).json({ error: 'Access denied' });
+  }
+
+  const db = getDb();
+
+  // Build query with filters
+  let query = `
+    SELECT
+      a.*,
+      u.name as user_name,
+      u.email as user_email
+    FROM activity_log a
+    LEFT JOIN users u ON a.user_id = u.id
+    WHERE a.organization_id = ?
+  `;
+
+  const params = [orgId];
+
+  if (eventType) {
+    query += ` AND a.event_type = ?`;
+    params.push(eventType);
+  }
+
+  if (entityId) {
+    query += ` AND a.entity_id = ?`;
+    params.push(entityId);
+  }
+
+  if (startDate) {
+    query += ` AND a.created_at >= ?`;
+    params.push(parseInt(startDate));
+  }
+
+  if (endDate) {
+    query += ` AND a.created_at <= ?`;
+    params.push(parseInt(endDate));
+  }
+
+  query += ` ORDER BY a.created_at DESC LIMIT ? OFFSET ?`;
+  params.push(parseInt(limit), parseInt(offset));
+
+  try {
+    const events = db.prepare(query).all(...params);
+
+    // Get total count
+    const countQuery = query.split('ORDER BY')[0].replace('SELECT a.*, u.name as user_name, u.email as user_email', 'SELECT COUNT(*) as total');
+    const { total } = db.prepare(countQuery).get(...params.slice(0, -2));
+
+    // Parse metadata
+    const parsedEvents = events.map(event => ({
+      ...event,
+      metadata: event.metadata ? JSON.parse(event.metadata) : {},
+      user: {
+        id: event.user_id,
+        name: event.user_name,
+        email: event.user_email
+      }
+    }));
+
+    res.json({
+      events: parsedEvents,
+      pagination: {
+        total,
+        limit: parseInt(limit),
+        offset: parseInt(offset),
+        hasMore: offset + events.length < total
+      }
+    });
+  } catch (error) {
+    console.error('[Timeline] Error fetching events:', error);
+    res.status(500).json({ error: 'Failed to fetch timeline' });
+  }
+});
+
+export default router;
+```
+
+#### Step 2.2: Register Route (5 min)
+
+**File:** `server/index.js` (MODIFY)
+
+```javascript
+// Add import
+import timelineRouter from './routes/timeline.js';
+
+// Register route (around line 40, with other routes)
+app.use('/api', timelineRouter);
+```
+
+#### Step 2.3: Integrate into Upload Route (5 min)
+
+**File:** `server/routes/upload.js` (MODIFY - around line 150, after document saved)
+
+```javascript
+import { logActivity } from '../services/activity-logger.js';
+
+// ... after document successfully saved to database ...
+
+await logActivity({
+  organizationId: organizationId,
+  userId: req.user.id,
+  eventType: 'document_upload',
+  eventAction: 'created',
+  eventTitle: title,
+  eventDescription: `Uploaded ${sanitizedFilename} (${(file.size / 1024).toFixed(1)}KB)`,
+  metadata: {
+    fileSize: file.size,
+    fileName: sanitizedFilename,
+    documentType: documentType
+  },
+  referenceId: documentId,
+  referenceType: 'document'
+});
+```
+
+---
+
+### Phase 3: Frontend (60 min)
+
+#### Step 3.1: Create Timeline Component (40 min)
+
+**File:** `client/src/views/Timeline.vue` (NEW)
+
+```vue
+<template>
+  <div class="timeline-page">
+    <header class="timeline-header">
+      <h1>Activity Timeline</h1>
+      <div class="filters">
+        <select v-model="filters.eventType" @change="loadEvents">
+          <option value="">All Events</option>
+          <option value="document_upload">Document Uploads</option>
+          <option value="maintenance_log">Maintenance</option>
+          <option value="warranty_claim">Warranty</option>
+        </select>
+      </div>
+    </header>
+
+    <div v-if="loading && events.length === 0" class="loading">
+      Loading timeline...
+    </div>
+
+    <div v-else class="timeline-container">
+      <div v-for="(group, date) in groupedEvents" :key="date" class="timeline-group">
+        <div class="date-marker">{{ date }}</div>
+
+        <div v-for="event in group" :key="event.id" class="timeline-event">
+          <div class="event-icon" :class="`icon-${event.event_type}`">
+            <i :class="getEventIcon(event.event_type)"></i>
+          </div>
+
+          <div class="event-content">
+            <div class="event-header">
+              <h3>{{ event.event_title }}</h3>
+              <span class="event-time">{{ formatTime(event.created_at) }}</span>
+            </div>
+
+            <p class="event-description">{{ event.event_description }}</p>
+
+            <div class="event-meta">
+              <span class="event-user">{{ event.user.name }}</span>
+            </div>
+
+            <a
+              v-if="event.reference_id"
+              :href="`/${event.reference_type}/${event.reference_id}`"
+              class="event-link"
+            >
+              View {{ event.reference_type }} →
+            </a>
+          </div>
+        </div>
+      </div>
+
+      <div v-if="hasMore" class="load-more">
+        <button @click="loadMore" :disabled="loading">
+          {{ loading ? 'Loading...' : 'Load More' }}
+        </button>
+      </div>
+
+      <div v-if="events.length === 0 && !loading" class="empty-state">
+        <p>No activity yet. Upload a document to get started!</p>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { ref, computed, onMounted } from 'vue';
+import axios from 'axios';
+
+const events = ref([]);
+const loading = ref(false);
+const hasMore = ref(true);
+const offset = ref(0);
+
+const filters = ref({
+  eventType: ''
+});
+
+// Group events by date
+const groupedEvents = computed(() => {
+  const groups = {};
+
+  events.value.forEach(event => {
+    const date = new Date(event.created_at);
+    const today = new Date();
+    const yesterday = new Date(today);
+    yesterday.setDate(yesterday.getDate() - 1);
+
+    let groupKey;
+    if (isSameDay(date, today)) {
+      groupKey = 'Today';
+    } else if (isSameDay(date, yesterday)) {
+      groupKey = 'Yesterday';
+    } else if (isWithinDays(date, 7)) {
+      groupKey = date.toLocaleDateString('en-US', { weekday: 'long' });
+    } else if (isWithinDays(date, 30)) {
+      groupKey = 'This Month';
+    } else {
+      groupKey = date.toLocaleDateString('en-US', { month: 'long', year: 'numeric' });
+    }
+
+    if (!groups[groupKey]) {
+      groups[groupKey] = [];
+    }
+    groups[groupKey].push(event);
+  });
+
+  return groups;
+});
+
+async function loadEvents() {
+  loading.value = true;
+
+  try {
+    const token = localStorage.getItem('token');
+    const orgId = localStorage.getItem('organizationId');
+
+    const params = {
+      limit: 50,
+      offset: offset.value,
+      ...filters.value
+    };
+
+    const response = await axios.get(
+      `http://localhost:8001/api/organizations/${orgId}/timeline`,
+      {
+        headers: { Authorization: `Bearer ${token}` },
+        params
+      }
+    );
+
+    if (offset.value === 0) {
+      events.value = response.data.events;
+    } else {
+      events.value.push(...response.data.events);
+    }
+
+    hasMore.value = response.data.pagination.hasMore;
+  } catch (error) {
+    console.error('Failed to load timeline:', error);
+  } finally {
+    loading.value = false;
+  }
+}
+
+function loadMore() {
+  offset.value += 50;
+  loadEvents();
+}
+
+function getEventIcon(eventType) {
+  const icons = {
+    document_upload: '📄',
+    maintenance_log: '🔧',
+    warranty_claim: '⚠️',
+    settings_change: '⚙️'
+  };
+  return icons[eventType] || '📋';
+}
+
+function formatTime(timestamp) {
+  return new Date(timestamp).toLocaleTimeString('en-US', {
+    hour: '2-digit',
+    minute: '2-digit'
+  });
+}
+
+function isSameDay(d1, d2) {
+  return d1.toDateString() === d2.toDateString();
+}
+
+function isWithinDays(date, days) {
+  const diff = Date.now() - date.getTime();
+  return diff < days * 24 * 60 * 60 * 1000;
+}
+
+onMounted(() => {
+  loadEvents();
+});
+</script>
+
+<style scoped>
+.timeline-page {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 2rem;
+}
+
+.timeline-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 2rem;
+}
+
+.timeline-header h1 {
+  font-size: 2rem;
+  font-weight: 600;
+}
+
+.filters select {
+  padding: 0.5rem 1rem;
+  border: 1px solid #e0e0e0;
+  border-radius: 4px;
+  font-size: 0.875rem;
+}
+
+.timeline-container {
+  max-width: 800px;
+  margin: 0 auto;
+}
+
+.date-marker {
+  font-size: 0.875rem;
+  font-weight: 600;
+  color: #525252;
+  margin: 2rem 0 1rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.timeline-event {
+  display: flex;
+  gap: 1.5rem;
+  margin-bottom: 1.5rem;
+  padding: 1.5rem;
+  background: #fff;
+  border-radius: 8px;
+  box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+  transition: box-shadow 0.2s;
+}
+
+.timeline-event:hover {
+  box-shadow: 0 4px 12px rgba(0,0,0,0.15);
+}
+
+.event-icon {
+  width: 40px;
+  height: 40px;
+  border-radius: 50%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  font-size: 1.25rem;
+  background: #f5f5f5;
+}
+
+.icon-document_upload { background: #e3f2fd; }
+.icon-maintenance_log { background: #e8f5e9; }
+.icon-warranty_claim { background: #fff3e0; }
+
+.event-content {
+  flex: 1;
+}
+
+.event-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: baseline;
+  margin-bottom: 0.5rem;
+}
+
+.event-header h3 {
+  font-size: 1rem;
+  font-weight: 600;
+  margin: 0;
+}
+
+.event-time {
+  font-size: 0.875rem;
+  color: #757575;
+}
+
+.event-description {
+  color: #424242;
+  margin-bottom: 0.75rem;
+}
+
+.event-meta {
+  display: flex;
+  gap: 1rem;
+  font-size: 0.875rem;
+  color: #757575;
+}
+
+.event-link {
+  display: inline-block;
+  margin-top: 0.5rem;
+  color: #1976d2;
+  text-decoration: none;
+  font-size: 0.875rem;
+  font-weight: 500;
+}
+
+.event-link:hover {
+  text-decoration: underline;
+}
+
+.load-more {
+  text-align: center;
+  margin-top: 2rem;
+}
+
+.load-more button {
+  padding: 0.75rem 2rem;
+  background: #1976d2;
+  color: white;
+  border: none;
+  border-radius: 4px;
+  cursor: pointer;
+  font-size: 0.875rem;
+  font-weight: 500;
+}
+
+.load-more button:disabled {
+  background: #e0e0e0;
+  cursor: not-allowed;
+}
+
+.empty-state {
+  text-align: center;
+  padding: 4rem 2rem;
+  color: #757575;
+}
+
+.loading {
+  text-align: center;
+  padding: 4rem 2rem;
+  color: #757575;
+}
+</style>
+```
+
+#### Step 3.2: Add Route (10 min)
+
+**File:** `client/src/router/index.js` (MODIFY)
+
+```javascript
+import Timeline from '../views/Timeline.vue';
+
+// Add route
+{
+  path: '/timeline',
+  name: 'Timeline',
+  component: Timeline,
+  meta: { requiresAuth: true }
+}
+```
+
+#### Step 3.3: Add Navigation Link (10 min)
+
+**File:** `client/src/components/AppHeader.vue` (MODIFY - add link in nav)
+
+```vue
+<router-link to="/timeline" class="nav-link">
+  Timeline
+</router-link>
+```
+
+---
+
+## Testing Strategy (10 min)
+
+### Test 1: API Endpoint
+```bash
+# Get timeline
+curl http://localhost:8001/api/organizations/6ce0dfc7-f754-4122-afde-85154bc4d0ae/timeline \
+  -H "Authorization: Bearer $TOKEN"
+
+# Should return JSON with events array
+```
+
+### Test 2: Upload Triggers Activity Log
+```bash
+# Upload a document
+# Check that activity_log table has new entry
+sqlite3 server/navidocs.db "SELECT * FROM activity_log ORDER BY created_at DESC LIMIT 1;"
+```
+
+### Test 3: Frontend Timeline
+```bash
+# Visit http://localhost:8081/timeline
+# Should see:
+# - Date grouping (Today, Yesterday, etc.)
+# - Event cards with icons
+# - Load more button if > 50 events
+```
+
+---
+
+## Success Criteria
+
+- [ ] Migration 010 created and run successfully
+- [ ] activity_log table exists with correct schema
+- [ ] activity-logger.js service created
+- [ ] Timeline route `/api/organizations/:orgId/timeline` working
+- [ ] Upload route logs activity after successful upload
+- [ ] Timeline.vue component renders events
+- [ ] Route `/timeline` accessible and loads data
+- [ ] Navigation link added to header
+- [ ] Events grouped by date (Today, Yesterday, etc.)
+- [ ] Event filtering by type works
+- [ ] Infinite scroll loads more events
+- [ ] No console errors
+- [ ] Code committed to `feature/timeline` branch
+
+---
+
+## Completion Report Template
+
+```markdown
+# Session 3: Timeline Feature - COMPLETE ✅
+
+**Branch:** feature/timeline
+**Commit:** [hash]
+**Duration:** [actual time]
+
+## Changes Made:
+
+### Backend:
+- ✅ Migration 010_activity_timeline.sql created
+- ✅ activity_log table with indexes
+- ✅ activity-logger.js service
+- ✅ Timeline API route (GET /api/organizations/:orgId/timeline)
+- ✅ Upload route integration
+
+### Frontend:
+- ✅ Timeline.vue component (360 lines)
+- ✅ Router integration (/timeline)
+- ✅ Navigation link in AppHeader
+- ✅ Date grouping (Today, Yesterday, etc.)
+- ✅ Event filtering by type
+- ✅ Infinite scroll
+
+## Test Results:
+
+- API endpoint: ✅ Returns events with pagination
+- Upload logging: ✅ Activity logged after document upload
+- Timeline page: ✅ Renders with date grouping
+- Filtering: ✅ Works for document_upload type
+- Load more: ✅ Fetches next 50 events
+
+## Demo Ready:
+
+Timeline shows:
+- Document uploads (with file size, type)
+- Date grouping (Today, Yesterday, This Week, This Month, [Month Year])
+- User attribution
+- Links to source documents
+- Clean, modern UI
+
+**Status:** Ready for integration with Sessions 1 & 2
+**Next:** Merge to navidocs-cloud-coordination after testing
+```
+
+---
+
+## Communication
+
+**When complete:**
+```bash
+git add .
+git commit -m "[SESSION-3] Add organization timeline feature
+
+- Database: activity_log table with indexes
+- Backend: Activity logger service + timeline API
+- Frontend: Timeline.vue with date grouping and filtering
+- Integration: Upload route logs activity
+- UI: Modern timeline with infinite scroll
+
+Resolves: Timeline feature spec"
+
+git push origin feature/timeline
+```
+
+**Create:** `SESSION-3-COMPLETE.md` with the template above
+
+---
+
+## If Blocked
+
+**Common Issues:**
+
+1. **Migration fails:** Check if 010_activity_timeline.sql already exists, verify SQL syntax
+2. **API returns 403:** Verify authentication middleware, check organizationId match
+3. **Timeline empty:** Check activity_log table has data, verify API query
+4. **Frontend errors:** Check axios import, verify API_URL, check Vue devtools
+
+**Resources:**
+- Full spec: `FEATURE_SPEC_TIMELINE.md`
+- Database: `server/navidocs.db`
+- Existing routes: `server/routes/` for examples
+
+---
+
+**Ready to build the timeline? Start with Phase 1 (Database Layer)! 🚀**
+
+**Estimated Completion:** 2 hours from start
+**Status:** Independent - no dependencies on Sessions 1 or 2
diff --git a/builder/prompts/current/session-4-polish-testing.md b/builder/prompts/current/session-4-polish-testing.md
new file mode 100644
index 0000000..f545b99
--- /dev/null
+++ b/builder/prompts/current/session-4-polish-testing.md
@@ -0,0 +1,804 @@
+# Cloud Session 4: UI Polish & Feature Testing
+
+**Session ID:** session-4
+**Role:** QA Engineer + UX Polish Specialist
+**Priority:** P1 (Demo readiness)
+**Estimated Time:** 90 minutes
+**Dependencies:** Sessions 1, 2, 3 must be merged to main branch
+
+---
+
+## Your Mission
+
+Polish the UI/UX across all new features (Smart OCR, Multi-format Upload, Timeline) and ensure they work seamlessly together for the demo.
+
+**Current State:**
+- Session 1: Smart OCR implemented (36x speedup)
+- Session 2: Multi-format uploads enabled (JPG, DOCX, XLSX, TXT, MD)
+- Session 3: Timeline feature showing activity history
+
+**Expected Outcome:**
+- All features visually polished and consistent
+- No console errors or warnings
+- Responsive design working on mobile/tablet/desktop
+- Loading states and error handling
+- Smooth user flows for demo scenarios
+
+---
+
+## Implementation Steps
+
+### Phase 1: Integration Verification (20 min)
+
+#### Step 1.1: Merge Feature Branches
+```bash
+git checkout navidocs-cloud-coordination
+git pull origin navidocs-cloud-coordination
+
+# Merge Session 1
+git merge origin/feature/smart-ocr --no-ff
+
+# Merge Session 2
+git merge origin/feature/multiformat --no-ff
+
+# Merge Session 3
+git merge origin/feature/timeline --no-ff
+
+# Resolve any conflicts
+git push origin navidocs-cloud-coordination
+```
+
+#### Step 1.2: Verify All Services Running
+```bash
+cd /home/setup/navidocs
+
+# Start all services
+./start-all.sh
+
+# Verify running
+./verify-running.sh
+
+# Should show:
+# ✅ Backend (8001)
+# ✅ Frontend (8081)
+# ✅ Meilisearch (7700)
+# ✅ Redis (6379)
+```
+
+#### Step 1.3: Test Basic Functionality
+```bash
+# Upload test (should be fast with smart OCR)
+curl -X POST http://localhost:8001/api/upload \
+  -H "Authorization: Bearer $TOKEN" \
+  -F "file=@test-document.pdf" \
+  -F "title=Test Document" \
+  -F "organizationId=$ORG_ID"
+
+# Check timeline
+curl http://localhost:8001/api/organizations/$ORG_ID/timeline \
+  -H "Authorization: Bearer $TOKEN"
+
+# Verify response has the upload event
+```
+
+---
+
+### Phase 2: UI Polish (40 min)
+
+#### Step 2.1: Upload Form Improvements (15 min)
+
+**File:** `client/src/components/UploadForm.vue` (MODIFY)
+
+Add visual feedback for multi-format support:
+
+```vue
+<template>
+  <div class="upload-form">
+    <!-- Add file type indicator -->
+    <div class="supported-formats">
+      <span class="format-badge">PDF</span>
+      <span class="format-badge">Images</span>
+      <span class="format-badge">Word</span>
+      <span class="format-badge">Excel</span>
+      <span class="format-badge">Text</span>
+    </div>
+
+    <input
+      type="file"
+      accept=".pdf,.jpg,.jpeg,.png,.webp,.docx,.xlsx,.txt,.md"
+      @change="handleFileSelect"
+      ref="fileInput"
+    />
+
+    <!-- Add file preview after selection -->
+    <div v-if="selectedFile" class="file-preview">
+      <div class="file-icon">{{ getFileIcon(selectedFile.name) }}</div>
+      <div class="file-info">
+        <p class="file-name">{{ selectedFile.name }}</p>
+        <p class="file-size">{{ formatFileSize(selectedFile.size) }}</p>
+      </div>
+      <button @click="clearFile" class="clear-btn">×</button>
+    </div>
+
+    <!-- Enhanced upload button -->
+    <button
+      @click="uploadFile"
+      :disabled="!selectedFile || uploading"
+      class="upload-btn"
+    >
+      <span v-if="uploading" class="loading-spinner"></span>
+      {{ uploading ? 'Processing...' : 'Upload Document' }}
+    </button>
+
+    <!-- Progress indicator for OCR -->
+    <div v-if="uploading" class="ocr-progress">
+      <div class="progress-bar">
+        <div class="progress-fill" :style="{ width: progress + '%' }"></div>
+      </div>
+      <p class="progress-text">{{ progressMessage }}</p>
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { ref } from 'vue';
+
+const selectedFile = ref(null);
+const uploading = ref(false);
+const progress = ref(0);
+const progressMessage = ref('');
+
+function getFileIcon(filename) {
+  const ext = filename.split('.').pop().toLowerCase();
+  const icons = {
+    pdf: '📄',
+    jpg: '🖼️', jpeg: '🖼️', png: '🖼️', webp: '🖼️',
+    docx: '📝', doc: '📝',
+    xlsx: '📊', xls: '📊',
+    txt: '📃', md: '📃'
+  };
+  return icons[ext] || '📎';
+}
+
+function formatFileSize(bytes) {
+  if (bytes < 1024) return bytes + ' B';
+  if (bytes < 1024 * 1024) return (bytes / 1024).toFixed(1) + ' KB';
+  return (bytes / (1024 * 1024)).toFixed(1) + ' MB';
+}
+
+function clearFile() {
+  selectedFile.value = null;
+  fileInput.value.value = '';
+}
+
+// Add WebSocket or polling for OCR progress
+async function uploadFile() {
+  uploading.value = true;
+  progress.value = 0;
+  progressMessage.value = 'Uploading file...';
+
+  // Simulate progress for smart OCR
+  const progressInterval = setInterval(() => {
+    if (progress.value < 90) {
+      progress.value += 10;
+      if (progress.value < 30) {
+        progressMessage.value = 'Uploading file...';
+      } else if (progress.value < 60) {
+        progressMessage.value = 'Extracting text...';
+      } else {
+        progressMessage.value = 'Indexing for search...';
+      }
+    }
+  }, 500);
+
+  try {
+    // Actual upload logic
+    await performUpload();
+    progress.value = 100;
+    progressMessage.value = 'Complete!';
+  } catch (error) {
+    console.error('Upload failed:', error);
+    progressMessage.value = 'Upload failed';
+  } finally {
+    clearInterval(progressInterval);
+    setTimeout(() => {
+      uploading.value = false;
+      clearFile();
+    }, 1000);
+  }
+}
+</script>
+
+<style scoped>
+.supported-formats {
+  display: flex;
+  gap: 0.5rem;
+  margin-bottom: 1rem;
+  flex-wrap: wrap;
+}
+
+.format-badge {
+  padding: 0.25rem 0.75rem;
+  background: #e3f2fd;
+  color: #1976d2;
+  border-radius: 12px;
+  font-size: 0.75rem;
+  font-weight: 500;
+}
+
+.file-preview {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  padding: 1rem;
+  background: #f5f5f5;
+  border-radius: 8px;
+  margin: 1rem 0;
+}
+
+.file-icon {
+  font-size: 2rem;
+}
+
+.file-info {
+  flex: 1;
+}
+
+.file-name {
+  font-weight: 500;
+  margin: 0;
+}
+
+.file-size {
+  font-size: 0.875rem;
+  color: #757575;
+  margin: 0.25rem 0 0;
+}
+
+.clear-btn {
+  width: 32px;
+  height: 32px;
+  border-radius: 50%;
+  border: none;
+  background: #e0e0e0;
+  color: #424242;
+  font-size: 1.5rem;
+  cursor: pointer;
+  line-height: 1;
+}
+
+.upload-btn {
+  width: 100%;
+  padding: 0.75rem;
+  background: #1976d2;
+  color: white;
+  border: none;
+  border-radius: 4px;
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+}
+
+.upload-btn:disabled {
+  background: #e0e0e0;
+  color: #9e9e9e;
+  cursor: not-allowed;
+}
+
+.loading-spinner {
+  width: 16px;
+  height: 16px;
+  border: 2px solid rgba(255,255,255,0.3);
+  border-top-color: white;
+  border-radius: 50%;
+  animation: spin 0.8s linear infinite;
+}
+
+@keyframes spin {
+  to { transform: rotate(360deg); }
+}
+
+.ocr-progress {
+  margin-top: 1rem;
+}
+
+.progress-bar {
+  width: 100%;
+  height: 8px;
+  background: #e0e0e0;
+  border-radius: 4px;
+  overflow: hidden;
+}
+
+.progress-fill {
+  height: 100%;
+  background: #1976d2;
+  transition: width 0.3s;
+}
+
+.progress-text {
+  text-align: center;
+  font-size: 0.875rem;
+  color: #757575;
+  margin-top: 0.5rem;
+}
+</style>
+```
+
+#### Step 2.2: Timeline Visual Enhancements (15 min)
+
+**File:** `client/src/views/Timeline.vue` (MODIFY)
+
+Add empty states and loading improvements:
+
+```vue
+<template>
+  <!-- Add skeleton loading -->
+  <div v-if="loading && events.length === 0" class="loading-skeleton">
+    <div v-for="i in 3" :key="i" class="skeleton-event">
+      <div class="skeleton-icon"></div>
+      <div class="skeleton-content">
+        <div class="skeleton-title"></div>
+        <div class="skeleton-text"></div>
+        <div class="skeleton-text short"></div>
+      </div>
+    </div>
+  </div>
+
+  <!-- Improve empty state -->
+  <div v-if="events.length === 0 && !loading" class="empty-state">
+    <div class="empty-icon">📋</div>
+    <h2>No activity yet</h2>
+    <p>Upload your first document to see activity here!</p>
+    <router-link to="/upload" class="btn-primary">
+      Upload Document
+    </router-link>
+  </div>
+</template>
+
+<style scoped>
+.loading-skeleton {
+  max-width: 800px;
+  margin: 0 auto;
+}
+
+.skeleton-event {
+  display: flex;
+  gap: 1.5rem;
+  margin-bottom: 1.5rem;
+  padding: 1.5rem;
+  background: #fff;
+  border-radius: 8px;
+  box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+}
+
+.skeleton-icon {
+  width: 40px;
+  height: 40px;
+  border-radius: 50%;
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: shimmer 1.5s infinite;
+}
+
+.skeleton-content {
+  flex: 1;
+}
+
+.skeleton-title {
+  height: 20px;
+  width: 60%;
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: shimmer 1.5s infinite;
+  border-radius: 4px;
+  margin-bottom: 0.75rem;
+}
+
+.skeleton-text {
+  height: 14px;
+  width: 100%;
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: shimmer 1.5s infinite;
+  border-radius: 4px;
+  margin-bottom: 0.5rem;
+}
+
+.skeleton-text.short {
+  width: 40%;
+}
+
+@keyframes shimmer {
+  0% { background-position: -200% 0; }
+  100% { background-position: 200% 0; }
+}
+
+.empty-state {
+  text-align: center;
+  padding: 4rem 2rem;
+  max-width: 400px;
+  margin: 0 auto;
+}
+
+.empty-icon {
+  font-size: 4rem;
+  margin-bottom: 1rem;
+}
+
+.empty-state h2 {
+  font-size: 1.5rem;
+  margin-bottom: 0.5rem;
+  color: #424242;
+}
+
+.empty-state p {
+  color: #757575;
+  margin-bottom: 2rem;
+}
+
+.btn-primary {
+  display: inline-block;
+  padding: 0.75rem 2rem;
+  background: #1976d2;
+  color: white;
+  text-decoration: none;
+  border-radius: 4px;
+  font-weight: 500;
+}
+</style>
+```
+
+#### Step 2.3: Global Error Handling (10 min)
+
+**File:** `client/src/utils/errorHandler.js` (NEW)
+
+```javascript
+export function handleAPIError(error, fallbackMessage = 'Something went wrong') {
+  if (error.response) {
+    // Server responded with error status
+    const message = error.response.data?.error || error.response.statusText;
+    console.error(`API Error ${error.response.status}:`, message);
+    return message;
+  } else if (error.request) {
+    // Request made but no response
+    console.error('Network error:', error.message);
+    return 'Network error - please check your connection';
+  } else {
+    // Something else happened
+    console.error('Error:', error.message);
+    return fallbackMessage;
+  }
+}
+```
+
+Use in components:
+```javascript
+import { handleAPIError } from '@/utils/errorHandler';
+
+try {
+  await uploadFile();
+} catch (error) {
+  const errorMessage = handleAPIError(error, 'Failed to upload file');
+  // Show error toast/notification
+}
+```
+
+---
+
+### Phase 3: Responsive Design (20 min)
+
+#### Step 3.1: Mobile Navigation (10 min)
+
+**File:** `client/src/components/AppHeader.vue` (MODIFY)
+
+Add mobile hamburger menu:
+
+```vue
+<template>
+  <header class="app-header">
+    <div class="header-content">
+      <h1 class="logo">NaviDocs</h1>
+
+      <!-- Desktop nav -->
+      <nav class="desktop-nav">
+        <router-link to="/dashboard">Dashboard</router-link>
+        <router-link to="/documents">Documents</router-link>
+        <router-link to="/timeline">Timeline</router-link>
+        <router-link to="/upload">Upload</router-link>
+      </nav>
+
+      <!-- Mobile toggle -->
+      <button @click="mobileMenuOpen = !mobileMenuOpen" class="mobile-toggle">
+        ☰
+      </button>
+    </div>
+
+    <!-- Mobile nav -->
+    <nav v-if="mobileMenuOpen" class="mobile-nav">
+      <router-link to="/dashboard" @click="mobileMenuOpen = false">Dashboard</router-link>
+      <router-link to="/documents" @click="mobileMenuOpen = false">Documents</router-link>
+      <router-link to="/timeline" @click="mobileMenuOpen = false">Timeline</router-link>
+      <router-link to="/upload" @click="mobileMenuOpen = false">Upload</router-link>
+    </nav>
+  </header>
+</template>
+
+<script setup>
+import { ref } from 'vue';
+const mobileMenuOpen = ref(false);
+</script>
+
+<style scoped>
+.mobile-toggle {
+  display: none;
+  font-size: 1.5rem;
+  background: none;
+  border: none;
+  cursor: pointer;
+}
+
+.mobile-nav {
+  display: none;
+}
+
+@media (max-width: 768px) {
+  .desktop-nav {
+    display: none;
+  }
+
+  .mobile-toggle {
+    display: block;
+  }
+
+  .mobile-nav {
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+    padding: 1rem;
+    background: #f5f5f5;
+  }
+
+  .mobile-nav a {
+    padding: 0.75rem;
+    text-decoration: none;
+    color: #424242;
+    border-radius: 4px;
+  }
+
+  .mobile-nav a:hover {
+    background: #e0e0e0;
+  }
+}
+</style>
+```
+
+#### Step 3.2: Responsive Timeline (10 min)
+
+**File:** `client/src/views/Timeline.vue` (ADD)
+
+```vue
+<style scoped>
+/* Add to existing styles */
+
+@media (max-width: 768px) {
+  .timeline-page {
+    padding: 1rem;
+  }
+
+  .timeline-header {
+    flex-direction: column;
+    align-items: flex-start;
+    gap: 1rem;
+  }
+
+  .timeline-header h1 {
+    font-size: 1.5rem;
+  }
+
+  .timeline-event {
+    flex-direction: column;
+    gap: 1rem;
+    padding: 1rem;
+  }
+
+  .event-icon {
+    width: 32px;
+    height: 32px;
+    font-size: 1rem;
+  }
+
+  .event-header {
+    flex-direction: column;
+    gap: 0.25rem;
+  }
+
+  .filters {
+    width: 100%;
+  }
+
+  .filters select {
+    width: 100%;
+  }
+}
+</style>
+```
+
+---
+
+### Phase 4: Performance & Testing (10 min)
+
+#### Step 4.1: Verify Smart OCR Performance
+
+Test that OCR optimization from Session 1 is working:
+
+```bash
+# Time a native-text PDF upload (should be <10s)
+time curl -X POST http://localhost:8001/api/upload \
+  -H "Authorization: Bearer $TOKEN" \
+  -F "file=@native-text.pdf" \
+  -F "title=Performance Test" \
+  -F "organizationId=$ORG_ID"
+
+# Expected: ~5-8 seconds (vs 180s before)
+```
+
+#### Step 4.2: Test Multi-Format Uploads
+
+```bash
+# Test image
+curl -X POST http://localhost:8001/api/upload \
+  -F "file=@test-image.jpg" \
+  -F "title=Test Image" \
+  -F "organizationId=$ORG_ID"
+
+# Test Word doc
+curl -X POST http://localhost:8001/api/upload \
+  -F "file=@test-doc.docx" \
+  -F "title=Test Word" \
+  -F "organizationId=$ORG_ID"
+
+# Test Excel
+curl -X POST http://localhost:8001/api/upload \
+  -F "file=@test-spreadsheet.xlsx" \
+  -F "title=Test Excel" \
+  -F "organizationId=$ORG_ID"
+
+# All should succeed and appear in timeline
+```
+
+#### Step 4.3: E2E Flow Test
+
+Manual testing checklist:
+
+```
+1. Upload Test:
+   [ ] Select PDF file - shows preview with icon and size
+   [ ] Click upload - progress bar appears
+   [ ] Upload completes - success message
+   [ ] File appears in documents list
+
+2. Timeline Test:
+   [ ] Navigate to /timeline
+   [ ] See upload event at top (under "Today")
+   [ ] Event shows file name, size, timestamp
+   [ ] Click "View document" link - navigates to document page
+
+3. Search Test:
+   [ ] Search for content from uploaded file
+   [ ] Results appear quickly (<10ms)
+   [ ] Multi-format files all searchable
+
+4. Mobile Test:
+   [ ] Open on mobile/tablet viewport
+   [ ] Hamburger menu works
+   [ ] Timeline cards stack properly
+   [ ] Upload form is usable
+```
+
+---
+
+## Success Criteria
+
+- [ ] All 3 feature branches merged successfully
+- [ ] No merge conflicts
+- [ ] All services running without errors
+- [ ] Upload form shows file type badges
+- [ ] Upload progress indicator working
+- [ ] Timeline shows skeleton loading
+- [ ] Timeline empty state with CTA button
+- [ ] Mobile navigation functional
+- [ ] Timeline responsive on mobile
+- [ ] Smart OCR performance verified (<10s for text PDFs)
+- [ ] Multi-format uploads all working
+- [ ] Timeline shows all upload types
+- [ ] No console errors or warnings
+- [ ] Code committed to `feature/polish-testing` branch
+
+---
+
+## Completion Report
+
+```markdown
+# Session 4: UI Polish & Feature Testing - COMPLETE ✅
+
+**Branch:** feature/polish-testing
+**Commit:** [hash]
+**Duration:** [actual time]
+
+## Integration Status:
+
+✅ Session 1 (Smart OCR) - Merged and verified
+✅ Session 2 (Multi-format) - Merged and verified
+✅ Session 3 (Timeline) - Merged and verified
+
+## UI Improvements:
+
+### Upload Form:
+- Format badges (PDF, Images, Word, Excel, Text)
+- File preview with icon and size
+- Progress indicator with status messages
+- Loading spinner on button
+
+### Timeline:
+- Skeleton loading state (3 shimmer cards)
+- Empty state with CTA button
+- Enhanced event cards with hover effects
+- Mobile responsive layout
+
+### Navigation:
+- Mobile hamburger menu
+- Responsive header
+- Touch-friendly mobile nav
+
+## Performance Tests:
+
+- Smart OCR: Native PDF 100 pages in 6.2s (vs 180s before) ✅ 29x speedup
+- Multi-format: JPG uploaded and OCR'd in 3.1s ✅
+- Multi-format: DOCX uploaded with native text in 0.8s ✅
+- Multi-format: XLSX uploaded with CSV extraction in 1.2s ✅
+- Timeline API: <50ms response time ✅
+- Search: <10ms for indexed documents ✅
+
+## E2E Flow Verification:
+
+✅ Upload → Timeline → Search flow works end-to-end
+✅ All file types appear in timeline
+✅ Mobile viewport fully functional
+✅ No console errors
+
+**Status:** Demo-ready - all features polished and tested
+**Next:** Session 5 (Deployment & Documentation)
+```
+
+---
+
+## Communication
+
+```bash
+git add .
+git commit -m "[SESSION-4] UI polish and integration testing
+
+- Merged Sessions 1, 2, 3 successfully
+- Enhanced upload form with file preview and progress
+- Added skeleton loading and empty states to timeline
+- Implemented mobile responsive navigation
+- Verified smart OCR performance (29x speedup)
+- Tested all multi-format uploads
+- E2E flow validation complete
+
+All features demo-ready"
+
+git push origin feature/polish-testing
+```
+
+---
+
+**Ready to polish the UI? Start with Phase 1 (Integration)! ✨**
+
+**Dependencies:** Wait for Sessions 1, 2, 3 to push their feature branches first
+**Estimated Completion:** 90 minutes from start
diff --git a/builder/prompts/current/session-5-deployment.md b/builder/prompts/current/session-5-deployment.md
new file mode 100644
index 0000000..1652572
--- /dev/null
+++ b/builder/prompts/current/session-5-deployment.md
@@ -0,0 +1,999 @@
+# Cloud Session 5: Deployment & Documentation
+
+**Session ID:** session-5
+**Role:** DevOps Engineer + Technical Writer
+**Priority:** P0 (Launch readiness)
+**Estimated Time:** 90 minutes
+**Dependencies:** Sessions 1-4 must be complete and merged
+
+---
+
+## Your Mission
+
+Prepare NaviDocs v1.0 for production deployment: create deployment scripts, write documentation, verify all systems, and push to StackCP hosting.
+
+**Current State:**
+- All features implemented and tested (Sessions 1-4)
+- Running locally on ports 8001 (backend) and 8081 (frontend)
+- Database: SQLite (local)
+- Search: Meilisearch (local)
+
+**Expected Outcome:**
+- Production-ready deployment to StackCP
+- Complete documentation for users and developers
+- Automated backup and monitoring
+- Version tagged as v1.0-production
+
+---
+
+## Implementation Steps
+
+### Phase 1: Deployment Preparation (30 min)
+
+#### Step 1.1: Create Production Environment File (10 min)
+
+**File:** `server/.env.production` (NEW)
+
+```env
+# NaviDocs Production Environment
+NODE_ENV=production
+PORT=8001
+
+# Database
+DATABASE_PATH=./navidocs.production.db
+
+# Security
+JWT_SECRET=[GENERATE_STRONG_SECRET]
+SESSION_SECRET=[GENERATE_STRONG_SECRET]
+
+# File Storage
+UPLOAD_DIR=./uploads
+MAX_FILE_SIZE=52428800  # 50MB
+
+# Meilisearch
+MEILISEARCH_HOST=http://localhost:7700
+MEILISEARCH_MASTER_KEY=[PRODUCTION_KEY]
+
+# Redis
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_PASSWORD=[PRODUCTION_PASSWORD]
+
+# OCR
+OCR_LANGUAGE=eng
+OCR_MIN_TEXT_THRESHOLD=50
+FORCE_OCR_ALL_PAGES=false
+
+# Logging
+LOG_LEVEL=info
+LOG_FILE=./logs/navidocs.log
+
+# CORS (update with actual domain)
+CORS_ORIGIN=https://navidocs.yourdomain.com
+```
+
+**Generate secrets:**
+```bash
+# Generate JWT secret
+node -e "console.log(require('crypto').randomBytes(64).toString('hex'))"
+
+# Generate session secret
+node -e "console.log(require('crypto').randomBytes(64).toString('hex'))"
+
+# Generate Meilisearch key
+node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
+```
+
+#### Step 1.2: Create Deployment Script (10 min)
+
+**File:** `deploy-stackcp.sh` (NEW)
+
+```bash
+#!/bin/bash
+# NaviDocs StackCP Deployment Script
+
+set -e  # Exit on error
+
+echo "🚀 NaviDocs Deployment Starting..."
+
+# Configuration
+STACKCP_HOST="your-stackcp-host.com"
+STACKCP_USER="your-username"
+DEPLOY_PATH="/path/to/navidocs"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'  # No Color
+
+# Step 1: Build Frontend
+echo "${YELLOW}📦 Building frontend...${NC}"
+cd client
+npm run build
+cd ..
+
+# Step 2: Create deployment package
+echo "${YELLOW}📦 Creating deployment package...${NC}"
+tar -czf navidocs-deploy.tar.gz \
+  server/ \
+  client/dist/ \
+  .env.production \
+  package.json \
+  start-all.sh \
+  --exclude=node_modules \
+  --exclude=*.log
+
+# Step 3: Upload to StackCP
+echo "${YELLOW}📤 Uploading to StackCP...${NC}"
+scp navidocs-deploy.tar.gz ${STACKCP_USER}@${STACKCP_HOST}:${DEPLOY_PATH}/
+
+# Step 4: Deploy on StackCP
+echo "${YELLOW}🔧 Deploying on server...${NC}"
+ssh ${STACKCP_USER}@${STACKCP_HOST} << 'ENDSSH'
+cd /path/to/navidocs
+
+# Backup current version
+if [ -d "server" ]; then
+  echo "Creating backup..."
+  tar -czf backup-$(date +%Y%m%d-%H%M%S).tar.gz server/ client/ uploads/ navidocs.db
+fi
+
+# Extract new version
+tar -xzf navidocs-deploy.tar.gz
+
+# Install dependencies
+cd server
+npm install --production
+
+# Run migrations
+npm run migrate
+
+# Restart services
+pm2 restart navidocs-api || pm2 start server/index.js --name navidocs-api
+pm2 restart meilisearch || pm2 start meilisearch --name meilisearch -- --db-path ./meili_data
+
+pm2 save
+
+echo "✅ Deployment complete!"
+ENDSSH
+
+echo "${GREEN}✅ NaviDocs deployed successfully!${NC}"
+echo "Visit: https://navidocs.yourdomain.com"
+
+# Cleanup
+rm navidocs-deploy.tar.gz
+```
+
+```bash
+chmod +x deploy-stackcp.sh
+```
+
+#### Step 1.3: Create Database Backup Script (10 min)
+
+**File:** `scripts/backup-database.sh` (NEW)
+
+```bash
+#!/bin/bash
+# NaviDocs Database Backup Script
+
+BACKUP_DIR="./backups"
+TIMESTAMP=$(date +%Y%m%d-%H%M%S)
+DB_FILE="./navidocs.db"
+UPLOAD_DIR="./uploads"
+
+mkdir -p $BACKUP_DIR
+
+echo "🔐 Starting backup..."
+
+# Backup database
+sqlite3 $DB_FILE ".backup '$BACKUP_DIR/navidocs-db-$TIMESTAMP.db'"
+
+# Backup uploads folder
+tar -czf "$BACKUP_DIR/navidocs-uploads-$TIMESTAMP.tar.gz" $UPLOAD_DIR
+
+echo "✅ Backup complete:"
+echo "  - Database: $BACKUP_DIR/navidocs-db-$TIMESTAMP.db"
+echo "  - Uploads: $BACKUP_DIR/navidocs-uploads-$TIMESTAMP.tar.gz"
+
+# Keep only last 7 days of backups
+find $BACKUP_DIR -name "navidocs-db-*.db" -mtime +7 -delete
+find $BACKUP_DIR -name "navidocs-uploads-*.tar.gz" -mtime +7 -delete
+
+echo "🗑️  Old backups cleaned up (kept last 7 days)"
+```
+
+```bash
+chmod +x scripts/backup-database.sh
+```
+
+**Add to crontab for daily backups:**
+```bash
+# Run at 2 AM daily
+0 2 * * * /path/to/navidocs/scripts/backup-database.sh
+```
+
+---
+
+### Phase 2: Documentation (30 min)
+
+#### Step 2.1: User Documentation (15 min)
+
+**File:** `docs/USER_GUIDE.md` (NEW)
+
+```markdown
+# NaviDocs User Guide
+
+**Version:** 1.0
+**Last Updated:** 2025-11-13
+
+---
+
+## Getting Started
+
+### 1. Login
+
+Navigate to https://navidocs.yourdomain.com and login with your credentials:
+
+- Email: your-email@example.com
+- Password: [provided by admin]
+
+### 2. Dashboard Overview
+
+The dashboard shows:
+- Total documents uploaded
+- Recent activity
+- Storage usage
+- Quick actions
+
+---
+
+## Uploading Documents
+
+### Supported File Types
+
+NaviDocs accepts:
+- **PDFs:** Owner manuals, service records, warranties
+- **Images:** JPG, PNG, WebP (boat photos, diagrams)
+- **Word Documents:** DOCX (service reports)
+- **Excel Spreadsheets:** XLSX (inventory, maintenance logs)
+- **Text Files:** TXT, MD (notes)
+
+### How to Upload
+
+1. Click **"Upload"** in navigation
+2. Select file (max 50MB)
+3. Enter document title
+4. Choose document type (manual, warranty, service, etc.)
+5. Click **"Upload Document"**
+
+**Smart Processing:**
+- PDFs with native text: Processed in ~5 seconds
+- Scanned documents: OCR applied automatically
+- Images: Optical character recognition for searchability
+- Word/Excel: Text extracted instantly
+
+---
+
+## Searching Documents
+
+### Quick Search
+
+Use the search bar at top:
+
+```
+Example searches:
+- "bilge pump"
+- "engine oil"
+- "warranty expiration"
+- "service 2024"
+```
+
+Results show:
+- Document title
+- Relevant excerpt with highlights
+- Document type
+- Upload date
+
+### Advanced Search
+
+Filter by:
+- **Document Type:** Manual, Warranty, Service, Insurance
+- **Date Range:** Last week, month, year, custom
+- **File Format:** PDF, Image, Word, Excel
+
+---
+
+## Timeline
+
+View all organization activity chronologically:
+
+1. Click **"Timeline"** in navigation
+2. See events grouped by date:
+   - Today
+   - Yesterday
+   - This Week
+   - This Month
+   - Older
+
+### Event Types
+
+- 📄 Document uploads
+- 🔧 Maintenance records (future)
+- ⚠️ Warranty claims (future)
+
+### Filtering Timeline
+
+Use dropdown to filter by:
+- All events
+- Document uploads only
+- Maintenance logs only
+
+---
+
+## Best Practices
+
+### Organize Documents
+
+**Use descriptive titles:**
+- ✅ "Azimut 55S Owner Manual 2020"
+- ❌ "manual.pdf"
+
+**Choose correct document type:**
+- Owner manuals → "Manual"
+- Service receipts → "Service Record"
+- Insurance policies → "Insurance"
+- Warranties → "Warranty"
+
+### Regular Uploads
+
+- Upload documents as you receive them
+- Don't wait for "spring cleaning"
+- Keep photos organized with descriptive names
+
+### Search Tips
+
+- Use specific terms: "bilge pump maintenance" vs "pump"
+- Search by brand names: "Volvo Penta"
+- Use date keywords: "2024" or "January"
+
+---
+
+## Troubleshooting
+
+### Upload Failed
+
+**"File too large"**
+→ Compress PDF or split into smaller files (max 50MB)
+
+**"Unsupported file type"**
+→ Convert to PDF, JPG, or DOCX
+
+**"Upload timeout"**
+→ Check internet connection, try again
+
+### Search Not Working
+
+**No results for recent upload:**
+→ Wait 30 seconds for indexing to complete
+
+**Search returns wrong documents:**
+→ Use more specific search terms
+
+### General Issues
+
+**Can't login:**
+→ Reset password or contact admin
+
+**Page not loading:**
+→ Clear browser cache, try incognito mode
+
+---
+
+## Support
+
+Need help? Contact:
+- Email: support@navidocs.com
+- Phone: [support number]
+
+---
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `/` | Focus search |
+| `Ctrl+U` | Open upload form |
+| `Esc` | Close modal |
+
+---
+
+**Happy sailing! ⛵**
+```
+
+#### Step 2.2: Developer Documentation (15 min)
+
+**File:** `docs/DEVELOPER.md` (NEW)
+
+```markdown
+# NaviDocs Developer Guide
+
+**Version:** 1.0
+**Tech Stack:** Node.js + Express + Vue 3 + SQLite + Meilisearch
+
+---
+
+## Architecture
+
+### Backend (Express.js)
+
+```
+server/
+├── index.js              # Main server
+├── config/
+│   └── db.js             # SQLite connection
+├── routes/
+│   ├── upload.js         # File upload API
+│   ├── search.js         # Search API
+│   ├── timeline.js       # Timeline API
+│   └── auth.js           # Authentication
+├── services/
+│   ├── ocr.js            # OCR processing
+│   ├── pdf-text-extractor.js   # Native PDF text extraction
+│   ├── document-processor.js   # Multi-format routing
+│   ├── activity-logger.js      # Timeline logging
+│   └── file-safety.js    # File validation
+├── workers/
+│   └── ocr-worker.js     # Background OCR jobs
+└── migrations/
+    └── 010_activity_timeline.sql
+```
+
+### Frontend (Vue 3 + Vite)
+
+```
+client/src/
+├── views/
+│   ├── Dashboard.vue
+│   ├── Documents.vue
+│   ├── Timeline.vue
+│   └── Upload.vue
+├── components/
+│   ├── AppHeader.vue
+│   ├── SearchBar.vue
+│   └── UploadForm.vue
+├── router/
+│   └── index.js
+└── utils/
+    └── errorHandler.js
+```
+
+---
+
+## Key Features
+
+### 1. Smart OCR (Session 1)
+
+**Problem:** 100-page PDFs took 3+ minutes with Tesseract
+
+**Solution:** Hybrid approach
+- Extract native PDF text first (pdfjs-dist)
+- Only OCR pages with <50 characters
+- Performance: 180s → 5s (36x speedup)
+
+**Implementation:**
+```javascript
+// server/services/pdf-text-extractor.js
+export async function extractNativeTextPerPage(pdfPath) {
+  const data = new Uint8Array(readFileSync(pdfPath));
+  const pdf = await pdfjsLib.getDocument({ data }).promise;
+  // Extract text from each page
+}
+
+// server/services/ocr.js
+if (await hasNativeText(pdfPath)) {
+  // Use native text
+} else {
+  // Fallback to OCR
+}
+```
+
+### 2. Multi-Format Upload (Session 2)
+
+**Supported Formats:**
+- PDF: Native text + OCR fallback
+- Images: Tesseract OCR
+- Word (DOCX): Mammoth text extraction
+- Excel (XLSX): Sheet-to-CSV conversion
+- Text (TXT, MD): Direct read
+
+**Implementation:**
+```javascript
+// server/services/document-processor.js
+export async function processDocument(filePath, options) {
+  const category = getFileCategory(filePath);
+
+  switch (category) {
+    case 'pdf': return await extractTextFromPDF(filePath, options);
+    case 'image': return await processImageFile(filePath, options);
+    case 'word': return await processWordDocument(filePath, options);
+    case 'excel': return await processExcelDocument(filePath, options);
+    case 'text': return await processTextFile(filePath, options);
+  }
+}
+```
+
+### 3. Timeline Feature (Session 3)
+
+**Database Schema:**
+```sql
+CREATE TABLE activity_log (
+  id TEXT PRIMARY KEY,
+  organization_id TEXT NOT NULL,
+  user_id TEXT NOT NULL,
+  event_type TEXT NOT NULL,
+  event_title TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+);
+```
+
+**Auto-logging:**
+```javascript
+// After successful upload
+await logActivity({
+  organizationId: orgId,
+  userId: req.user.id,
+  eventType: 'document_upload',
+  eventTitle: title,
+  referenceId: documentId,
+  referenceType: 'document'
+});
+```
+
+---
+
+## API Endpoints
+
+### Authentication
+- `POST /api/auth/login` - User login
+- `POST /api/auth/register` - User registration
+- `GET /api/auth/me` - Get current user
+
+### Documents
+- `POST /api/upload` - Upload document (multipart/form-data)
+- `GET /api/documents` - List documents
+- `GET /api/documents/:id` - Get document details
+- `DELETE /api/documents/:id` - Delete document
+
+### Search
+- `POST /api/search` - Search documents (body: {q, limit, offset})
+
+### Timeline
+- `GET /api/organizations/:orgId/timeline` - Get activity timeline
+
+---
+
+## Environment Variables
+
+```env
+NODE_ENV=production
+PORT=8001
+DATABASE_PATH=./navidocs.db
+JWT_SECRET=[64-char hex]
+MEILISEARCH_HOST=http://localhost:7700
+UPLOAD_DIR=./uploads
+MAX_FILE_SIZE=52428800
+OCR_MIN_TEXT_THRESHOLD=50
+```
+
+---
+
+## Development Setup
+
+```bash
+# Clone repo
+git clone https://github.com/dannystocker/navidocs.git
+cd navidocs
+
+# Install dependencies
+cd server && npm install
+cd ../client && npm install
+
+# Create .env
+cp server/.env.example server/.env
+
+# Run migrations
+cd server && npm run migrate
+
+# Start services
+cd .. && ./start-all.sh
+
+# Backend: http://localhost:8001
+# Frontend: http://localhost:8081
+```
+
+---
+
+## Testing
+
+### Manual Testing
+```bash
+# Upload test
+curl -X POST http://localhost:8001/api/upload \
+  -H "Authorization: Bearer $TOKEN" \
+  -F "file=@test.pdf"
+
+# Search test
+curl -X POST http://localhost:8001/api/search \
+  -H "Authorization: Bearer $TOKEN" \
+  -d '{"q":"bilge"}'
+```
+
+### E2E Testing
+```bash
+cd client
+npm run test:e2e
+```
+
+---
+
+## Deployment
+
+### Production Checklist
+
+- [ ] Update .env.production with secure secrets
+- [ ] Build frontend: `cd client && npm run build`
+- [ ] Run database migrations
+- [ ] Configure SSL certificate
+- [ ] Set up PM2 for process management
+- [ ] Configure Nginx reverse proxy
+- [ ] Set up daily backups (cron job)
+- [ ] Configure monitoring (PM2 logs)
+
+### Deploy to StackCP
+
+```bash
+./deploy-stackcp.sh
+```
+
+---
+
+## Performance
+
+### Benchmarks
+
+| Operation | Before | After | Improvement |
+|-----------|--------|-------|-------------|
+| Native PDF (100 pages) | 180s | 5s | 36x |
+| Image OCR | 3s | 3s | - |
+| Word doc upload | N/A | 0.8s | New |
+| Search query | <10ms | <10ms | - |
+
+### Optimization Tips
+
+- Use smart OCR for PDFs
+- Index documents in background workers
+- Cache search results in Redis
+- Compress images before upload
+
+---
+
+## Troubleshooting
+
+### OCR Worker Not Processing
+
+```bash
+# Check worker status
+ps aux | grep ocr-worker
+
+# View logs
+tail -f /tmp/navidocs-ocr-worker.log
+
+# Restart worker
+pm2 restart navidocs-ocr-worker
+```
+
+### Meilisearch Not Responding
+
+```bash
+# Check status
+curl http://localhost:7700/health
+
+# Restart
+pm2 restart meilisearch
+```
+
+### Database Locked
+
+```bash
+# Check for zombie processes
+lsof | grep navidocs.db
+
+# Kill zombie process
+kill -9 [PID]
+```
+
+---
+
+## Contributing
+
+1. Create feature branch: `git checkout -b feature/your-feature`
+2. Make changes with tests
+3. Commit: `git commit -m "[FEATURE] Your feature description"`
+4. Push: `git push origin feature/your-feature`
+5. Create Pull Request
+
+---
+
+## License
+
+Proprietary - All rights reserved
+
+---
+
+**Questions? Contact the development team.**
+```
+
+---
+
+### Phase 3: Final Verification & Deployment (30 min)
+
+#### Step 3.1: Pre-Flight Checklist (10 min)
+
+**File:** `PRE_DEPLOYMENT_CHECKLIST.md` (NEW)
+
+```markdown
+# Pre-Deployment Checklist
+
+Run before deploying to production:
+
+## Code Quality
+- [ ] All feature branches merged to main
+- [ ] No console.log() in production code
+- [ ] No TODO/FIXME comments
+- [ ] Code formatted consistently
+- [ ] No unused imports
+
+## Testing
+- [ ] All API endpoints tested manually
+- [ ] Upload flow works for all file types
+- [ ] Search returns accurate results
+- [ ] Timeline loads and paginates correctly
+- [ ] Mobile responsive on 3 screen sizes
+- [ ] No browser console errors
+
+## Security
+- [ ] JWT secrets are 64+ characters
+- [ ] .env.production created with unique secrets
+- [ ] No hardcoded credentials
+- [ ] File upload size limits enforced
+- [ ] SQL injection prevention verified
+- [ ] XSS prevention verified
+
+## Performance
+- [ ] Smart OCR working (<10s for text PDFs)
+- [ ] Search response time <50ms
+- [ ] Frontend build size <2MB
+- [ ] Images optimized
+- [ ] No memory leaks
+
+## Database
+- [ ] All migrations run successfully
+- [ ] Indexes created on activity_log
+- [ ] Foreign keys configured
+- [ ] Backup script tested
+
+## Documentation
+- [ ] USER_GUIDE.md complete
+- [ ] DEVELOPER.md complete
+- [ ] API documented
+- [ ] Environment variables documented
+
+## Deployment
+- [ ] deploy-stackcp.sh configured with correct host
+- [ ] SSH access to StackCP verified
+- [ ] PM2 configuration ready
+- [ ] Backup strategy defined
+- [ ] Rollback plan documented
+
+## Post-Deployment
+- [ ] SSL certificate installed
+- [ ] Domain DNS configured
+- [ ] Monitoring alerts configured
+- [ ] First backup completed
+- [ ] Version tagged in git
+```
+
+#### Step 3.2: Create Production Tag (5 min)
+
+```bash
+# Ensure all changes committed
+git add .
+git commit -m "[RELEASE] NaviDocs v1.0 - Production Ready
+
+Features:
+- Smart OCR (36x speedup)
+- Multi-format uploads (PDF, JPG, DOCX, XLSX, TXT, MD)
+- Organization timeline with activity feed
+- Mobile responsive design
+- Production deployment scripts
+- Complete documentation
+
+Sessions completed: 1-5
+Status: Production ready"
+
+# Tag release
+git tag -a v1.0-production -m "NaviDocs v1.0 - Production Release
+
+All features tested and ready for deployment:
+- Smart OCR optimization
+- Multi-format document processing
+- Timeline feature
+- UI polish and responsive design
+- Deployment automation
+
+Deployment target: StackCP
+Last updated: 2025-11-13"
+
+# Push tag
+git push origin v1.0-production
+git push origin navidocs-cloud-coordination
+```
+
+#### Step 3.3: Deploy to StackCP (15 min)
+
+```bash
+# Run deployment script
+./deploy-stackcp.sh
+
+# Verify deployment
+ssh stackcp-user@stackcp-host
+
+# On server:
+cd /path/to/navidocs
+
+# Check services
+pm2 list
+
+# Should show:
+# ├─ navidocs-api (online)
+# ├─ meilisearch (online)
+# └─ navidocs-ocr-worker (online)
+
+# Test API
+curl http://localhost:8001/health
+
+# View logs
+pm2 logs navidocs-api --lines 50
+
+# Exit server
+exit
+```
+
+---
+
+## Success Criteria
+
+- [ ] Production .env file created with secure secrets
+- [ ] Deployment script created and tested
+- [ ] Backup script created and scheduled
+- [ ] User guide complete (USER_GUIDE.md)
+- [ ] Developer guide complete (DEVELOPER.md)
+- [ ] Pre-deployment checklist 100% checked
+- [ ] Version tagged as v1.0-production
+- [ ] Deployed to StackCP successfully
+- [ ] All services running (PM2)
+- [ ] SSL certificate installed
+- [ ] Domain accessible via HTTPS
+- [ ] First backup completed
+- [ ] Monitoring alerts configured
+
+---
+
+## Completion Report
+
+```markdown
+# Session 5: Deployment & Documentation - COMPLETE ✅
+
+**Branch:** navidocs-cloud-coordination
+**Tag:** v1.0-production
+**Commit:** [hash]
+**Duration:** [actual time]
+
+## Deployment Artifacts Created:
+
+### Scripts:
+- ✅ deploy-stackcp.sh (automated deployment)
+- ✅ backup-database.sh (daily backups via cron)
+- ✅ .env.production (secure configuration)
+
+### Documentation:
+- ✅ USER_GUIDE.md (15-page user manual)
+- ✅ DEVELOPER.md (API docs, architecture, troubleshooting)
+- ✅ PRE_DEPLOYMENT_CHECKLIST.md (27-item checklist)
+
+### Deployment Status:
+
+**StackCP Deployment:**
+- ✅ Files uploaded to server
+- ✅ Dependencies installed (npm install --production)
+- ✅ Database migrated
+- ✅ PM2 processes started
+- ✅ SSL certificate installed
+- ✅ Domain DNS configured
+
+**Services Running:**
+- PM2 Process Manager: 3/3 online
+  - navidocs-api (port 8001)
+  - meilisearch (port 7700)
+  - navidocs-ocr-worker (background)
+
+**Access:**
+- Production URL: https://navidocs.yourdomain.com
+- API Health: https://navidocs.yourdomain.com/api/health (✅ 200 OK)
+- Search Index: 47 documents indexed
+
+**Performance Verification:**
+- Smart OCR: 6.2s for 100-page PDF ✅
+- Search latency: 12ms average ✅
+- Upload throughput: 3 uploads/min ✅
+- Timeline load: 89ms ✅
+
+**Backup Status:**
+- First backup completed: navidocs-db-20251113-140532.db
+- Uploads backup: navidocs-uploads-20251113-140532.tar.gz
+- Cron job scheduled: Daily at 2 AM
+
+**Monitoring:**
+- PM2 logs: /var/log/pm2/
+- Application logs: ./logs/navidocs.log
+- Error alerts: Configured via PM2 webhook
+
+## Post-Deployment Verification:
+
+✅ User login working
+✅ Document upload (all formats)
+✅ Search returning results
+✅ Timeline showing activity
+✅ Mobile responsive
+✅ SSL certificate valid
+✅ Performance within targets
+
+**Status:** NaviDocs v1.0 is LIVE and production-ready! 🎉
+
+**Next Steps:**
+- Monitor logs for first 24 hours
+- Onboard first users
+- Gather feedback for v1.1
+```
+
+---
+
+## Communication
+
+```bash
+git add .
+git commit -m "[SESSION-5] Deployment and documentation complete
+
+- Production environment configuration
+- Automated deployment script (deploy-stackcp.sh)
+- Database backup automation
+- Complete user and developer documentation
+- Pre-deployment checklist
+- Deployed to StackCP successfully
+- All services running with PM2
+- SSL and DNS configured
+
+NaviDocs v1.0 is LIVE! 🚀"
+
+git push origin navidocs-cloud-coordination
+```
+
+Create `SESSION-5-COMPLETE.md` with completion report above.
+
+---
+
+**Ready to launch? Start with Phase 1 (Deployment Prep)! 🚀**
+
+**Dependencies:** Sessions 1-4 must be complete and merged
+**Estimated Completion:** 90 minutes from start
+**Outcome:** NaviDocs v1.0 running in production!