# Quick Start Testing Guide

> **Purpose**: Get started testing Phase 1 functionality in 5 minutes  
> **For**: Manual testing with real Filevine account

## Step 1: Load Extension (2 minutes)

1. **Open Chrome Extensions**
   - Navigate to `chrome://extensions`
   - Enable **"Developer mode"** (top-right toggle)

2. **Load Extension**
   - Click **"Load unpacked"**
   - Select the `filevine-plugin` directory
   - Extension should appear in list ✅

3. **Verify Load**
   - Extension icon appears in toolbar
   - No red errors on extensions page
   - Click "service worker" link → Should see console with initialization messages

## Step 2: Test Authentication (3 minutes)

1. **Check Disconnected State**
   - Click extension icon
   - Should see "Disconnected" status
   - Message: "Open Filevine to connect"

2. **Navigate to Filevine**
   - Go to `https://app.filevineapp.com` (or your Filevine URL)
   - Log in if needed
   - Open DevTools → Console tab

3. **Check Token Detection**
   - Look for: `[Filevine Plugin] Content script loaded`
   - Look for: `[Filevine Plugin] Network interception active`
   - If logged in, should see token extraction attempts

4. **Verify Connection**
   - Click extension icon again
   - Should now show "Connected" status
   - Projects should start loading

## Step 3: Test Basic Functionality (5 minutes)

1. **View Projects**
   - Projects should appear in popup
   - Try searching for a project
   - Verify search filters results

2. **View Documents**
   - Click on a project
   - Documents should load
   - Verify file list displays

3. **Test Download** (optional)
   - Click "Download" on a document
   - Check background console for download progress
   - Verify file stored in IndexedDB

## Quick Debug Commands

**In Background Service Worker Console:**
```javascript
// Check auth state
chrome.runtime.sendMessage({ type: 'get_auth_state' }, console.log);

// Check download state
chrome.runtime.sendMessage({ type: 'get_download_state' }, console.log);
```

**On Filevine Page Console:**
```javascript
// Check for tokens
localStorage.getItem('fv_access_token');
```

## Common Issues

### Extension Not Loading
- Check `manifest.json` syntax
- Verify all files exist
- Check browser console for errors

### Content Script Not Injecting
- Verify URL matches `*.filevineapp.com`
- Check manifest permissions
- Reload Filevine page

### Authentication Not Working
- Check content script console for errors
- Verify token extraction is attempting
- Check background service worker for API errors
- See `.ai/TROUBLESHOOTING.md` for detailed solutions

### Projects Not Loading
- Verify authentication succeeded
- Check network tab for API calls
- Verify API endpoint uses PascalCase: `/Projects`
- Check for 401/404 errors

## Full Testing Plan

For comprehensive testing, see `TESTING_PLAN.md` which includes:
- 7 test suites
- 20+ individual tests
- Detailed expected results
- Debugging steps

## Next Steps

After quick testing:
1. Document any issues found
2. Run full test suite from `TESTING_PLAN.md`
3. Fix critical bugs
4. Move to Phase 2 development
