# Test Mode - Preview Before Going Live

Giveaway Gator gives you two ways to see how your storefront will look before a real giveaway is running:

- **Preview mode** — a simple toggle in the theme editor. Best for checking how entry tags and countdowns look while you design your theme. No code required.
- **Storefront test mode** — an advanced, console-based tool for simulating a live promotion on your real storefront.

## Preview Mode (Theme Editor)

Preview mode lets you style your Giveaway Gator blocks in the Shopify theme editor even when no giveaway is currently active. It fills the entry tags and countdown with sample data so you can see and adjust their appearance.

**It only affects the theme editor preview — it has no effect on your live storefront.**

### How to Turn It On

1. Go to **Online Store > Themes > Customize**.
2. Click the **App embeds** tab (the puzzle piece icon) in the left sidebar.
3. Open **Giveaway Gator**.
4. Check **Preview mode**.
5. The entry tags and countdown timer now show sample values so you can adjust colors, fonts, and spacing.

When you're done styling, uncheck **Preview mode**. Leaving it on never affects shoppers — it's ignored everywhere except the theme editor — but turning it off keeps your settings clean.

### What You'll See

With Preview mode on, your blocks render with a sample active giveaway: an entry tag with a sample entry count and multiplier badge, and a countdown timer with time remaining. A small orange **TEST MODE** badge appears so you know the data isn't real.

---

## Storefront Test Mode (Advanced)

For a deeper test, you can simulate an active promotion directly on your live storefront from the browser console. This is aimed at developers or anyone comfortable opening the browser's developer tools. It's useful for verifying a specific bonus setup end-to-end before launch.

The `window.GiveawayGator.test()` tool simulates active promotions on your storefront without configuring real promotions.

### Basic Usage

```javascript
// Enter test mode with defaults
window.GiveawayGator.test()

// Enter test mode with custom config
window.GiveawayGator.test({
  dollarPerEntry: 10,
  entryCalculation: {
    bonusPeriod: {
      multiplier: 5,
      endTime: "2026-07-07T12:00:00"
    }
  }
})

// Exit test mode
window.GiveawayGator.test(false)
```

### Default Test Configuration
- Active promotion ending in 7 days
- Bonus period ending in 2 days with 3x multiplier
- $5 per entry conversion rate
- Sample product bonus on the current product (15 bonus entries, 2x multiplier)

### Features
- Orange "TEST MODE" badge in top-right corner
- Persists across page navigation (via sessionStorage)
- Auto-expires after 2 hours
- All components (entry tags, countdown timers) update immediately
- Original configuration is preserved and restored on exit

### Configuration Options

| Property | Type | Description |
|----------|------|-------------|
| `dollarPerEntry` | Number | How much money = 1 entry |
| `entryCalculation.bonusPeriod.multiplier` | Number | Entry multiplier during bonus period |
| `entryCalculation.bonusPeriod.endTime` | String (ISO) | When bonus period ends |
| `entryCalculation.defaultMultiplier` | Number | Default entry multiplier |
| `entryCalculation.productBonuses` | Object | Product-specific bonuses |