# Installation

## Requirements

- **WordPress:** 5.3 or higher
- **PHP:** 5.6 or higher
- **Browser:** Any modern browser with JavaScript enabled

## Installation Methods

### From WordPress Admin

1. Go to **Plugins > Add New**
2. Search for "AjaxPress"
3. Click **Install Now**, then **Activate**

### Manual Upload

1. Download the `ajaxpress.zip` file
2. Go to **Plugins > Add New > Upload Plugin**
3. Choose the zip file and click **Install Now**
4. Activate the plugin

### Via FTP/SFTP

1. Extract `ajaxpress.zip`
2. Upload the `ajaxpress` folder to `/wp-content/plugins/`
3. Go to **Plugins** in WordPress admin and activate AjaxPress

## First Run

After activation, AjaxPress immediately enables SPA navigation with sensible defaults:

- SPA navigation: **enabled**
- Loader: **progress bar** (blue, top position)
- Fade animation: **enabled** (0.3s)
- Scroll to top: **enabled**

Navigate to **Settings > AjaxPress** to customize. The onboarding tour will guide you through the key settings on first visit.

## Verifying It Works

1. Open your site in a browser
2. Click any internal link
3. You should see:
   - The progress bar animating at the top of the page
   - The page content updating without a full browser reload
   - The browser URL changing via the address bar
4. Check the browser's Network tab -- you should see fetch requests instead of full page loads

## Uninstallation

1. Go to **Plugins** in WordPress admin
2. Deactivate AjaxPress (optional feedback form appears)
3. Click **Delete**

If Cloudflare edge caching was enabled, run **Teardown** from the Cache settings page before uninstalling to remove the deployed worker.