# Software Launch Theme

A high-converting WordPress theme for software product launches. Features dark theme, orange CTAs, countdown timer, and full ACF integration.

## Installation

1. **Upload Theme**
   - Upload the `software-launch-theme` folder to `/wp-content/themes/`
   - Or zip it and upload via Appearance → Themes → Add New → Upload

2. **Activate Theme**
   - Go to Appearance → Themes
   - Activate "Software Launch Theme"

3. **Install ACF Pro**
   - This theme requires [Advanced Custom Fields Pro](https://www.advancedcustomfields.com/pro/)
   - Install and activate the plugin

4. **Import ACF Fields**
   - Go to Custom Fields → Tools
   - Import the `acf-export.json` file included with this theme
   - All field groups will be automatically registered

## Usage

### Creating a Launch Page

1. Go to Pages → Add New
2. In the Page Attributes panel, select template: **Software Launch Page**
3. Fill in all the ACF fields in the sections below the editor
4. Publish the page

### ACF Field Groups

The theme includes 13 field groups organized by section:

| Field Group | Purpose |
|-------------|---------|
| Global Settings | Countdown timer, footer |
| Hero Section | Headline, video, CTA |
| Problem Section | Pain points |
| Solution Section | Product intro |
| Social Proof Stats | Statistics, authority |
| Features Grid | Feature cards |
| How It Works | Step-by-step process |
| Comparison Table | Us vs. them |
| Bonus Stack | Bonus offers |
| Pricing | Front-end + bundle |
| Testimonials | Customer quotes |
| FAQ | Accordion questions |
| Final CTA | Urgency section |

### Countdown Timer

The countdown supports two modes:

1. **Fixed Deadline**: Set a specific date/time in the ACF fields
2. **Cookie-based**: Set hours (default 24) - each visitor gets their own countdown starting from first visit

The countdown appears in two places:
- Sticky bar at top (appears after 30% scroll)
- Final CTA section

### Headless/API Usage

The theme includes a REST API endpoint for headless implementations:

```
GET /wp-json/slt/v1/page/{page_id}
```

Returns all ACF fields as JSON for frontend frameworks.

### CSS Customization

All design tokens are defined as CSS custom properties in `style.css`:

```css
:root {
    --color-background: #0A1628;
    --color-surface: #111827;
    --color-primary: #FF6B00;
    --color-secondary: #3B82F6;
    --color-success: #10B981;
    --color-danger: #EF4444;
    --color-text-primary: #FFFFFF;
    --color-text-secondary: #94A3B8;
}
```

### JavaScript API

The countdown timer exposes a global API:

```javascript
// Get deadline timestamp
sltCountdownAPI.getDeadline();

// Get current time remaining
sltCountdownAPI.getTimeRemaining();

// Reset countdown (new X hours)
sltCountdownAPI.reset(24);

// Force expiration
sltCountdownAPI.expire();
```

Listen for expiration:

```javascript
document.addEventListener('slt:countdown:expired', () => {
    // Handle expiration
});
```

## File Structure

```
software-launch-theme/
├── style.css                      # Theme styles + header
├── functions.php                  # ACF registration, enqueues
├── index.php                      # Default template
├── template-software-launch.php   # Main landing page template
├── acf-export.json               # Importable ACF field groups
├── assets/
│   └── js/
│       └── countdown.js          # Countdown timer script
└── README.md                     # This file
```

## Responsive Breakpoints

| Breakpoint | Width | Behavior |
|------------|-------|----------|
| Desktop | 1200px+ | Full layout |
| Tablet | 768-1199px | 2-col → 1-col |
| Mobile | <768px | Stacked, larger buttons |

## Browser Support

- Chrome (last 2 versions)
- Firefox (last 2 versions)
- Safari (last 2 versions)
- Edge (last 2 versions)

## License

GPL-2.0-or-later

## Credits

Built by Leonardo for Hermes Fleet.

---

**Perry's Notes**: This is a reusable template for software launches. Each new product launch:
1. Duplicate an existing page (or create new)
2. Update all ACF fields with new content
3. Upload new images (product mockups, testimonials)
4. Set checkout URLs
5. Configure countdown deadline
6. Publish!