diff --git a/CPA_Map_App.md b/CPA_Map_App.md
index 36b49dd..3cd74a1 100644
--- a/CPA_Map_App.md
+++ b/CPA_Map_App.md
@@ -1,5 +1,8 @@
# CPA Animated Map — Application Documentation
+**GitHub Repository:** [https://github.com/vlenchik/CPA-Air](https://github.com/vlenchik/CPA-Air)
+**Live Site:** [https://vlenchik.github.io/CPA-Air/](https://vlenchik.github.io/CPA-Air/)
+
## Purpose
This is a single-file, browser-based playback tool for visualizing a **Closest Point of Approach (CPA)** event between two aircraft. It replays a ±60-second window around the CPA moment, animating both aircraft positions on a map while synchronizing optional ATC audio recorded during the event.
@@ -97,6 +100,15 @@ The script reads the audio file, base64-encodes it, and replaces the placeholder
### Step 4 — Open in a Browser
+**Option A: View the Live Site**
+
+The application is hosted on GitHub Pages at:
+**[https://vlenchik.github.io/CPA-Air/CPA_map_with_audio_embedded.html](https://vlenchik.github.io/CPA-Air/CPA_map_with_audio_embedded.html)**
+
+This is the easiest way to view the visualization without downloading anything.
+
+**Option B: Run Locally**
+
Open `CPA_map_with_audio_embedded.html` in any modern browser (Chrome, Firefox, Safari, Edge). No server is needed — just double-click or drag into the browser.
The map will load, the tracks will draw, and the animation will initialize at frame 0. Press **Play** to start. Audio will begin playing synchronized to the animation.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ce1b882
--- /dev/null
+++ b/README.md
@@ -0,0 +1,70 @@
+# CPA-Air
+
+**Repository:** [https://github.com/vlenchik/CPA-Air](https://github.com/vlenchik/CPA-Air)
+**Live Site:** [https://vlenchik.github.io/CPA-Air/](https://vlenchik.github.io/CPA-Air/)
+
+## Overview
+
+CPA-Air is a browser-based visualization tool for analyzing Closest Point of Approach (CPA) events between aircraft. The application provides an animated map playback synchronized with ATC audio recordings to help pilots, controllers, and investigators review close encounter geometry and communications.
+
+## Features
+
+- **Interactive Map Visualization**: Animated aircraft tracks with real-time position updates
+- **Synchronized ATC Audio**: Embedded audio playback aligned with the visual timeline
+- **Detailed Flight Data**: Altitude, ground speed, vertical speed, and separation distances
+- **Playback Controls**: Variable speed playback (0.25× to 6×), scrubbing, and step-by-step navigation
+- **Self-Contained**: Single HTML file deployment with no server requirements
+
+## Current Event
+
+This repository contains analysis of a CPA event between:
+- **N748PK** (RV-series aircraft) and **N89WD**
+- Location: Near KLVK (San Jose, CA)
+- Date/Time: 2026-01-26 at 21:38:48 UTC
+- Duration: 120-second window (±60 seconds around CPA)
+
+## Quick Start
+
+### Option 1: View Online (Recommended)
+
+Visit the live site at: **[https://vlenchik.github.io/CPA-Air/](https://vlenchik.github.io/CPA-Air/)**
+
+Available pages:
+- [Main Visualization](https://vlenchik.github.io/CPA-Air/CPA_map_with_audio_embedded.html) - Interactive map with embedded audio
+- [Event Analysis](https://vlenchik.github.io/CPA-Air/KLVK%20CPA%20250ft%2020260126.html) - Specific CPA event visualization
+- [Home Page](https://vlenchik.github.io/CPA-Air/) - Project overview and navigation
+
+### Option 2: Run Locally
+
+1. Clone or download the repository
+2. Open `CPA_map_with_audio_embedded.html` in any modern web browser
+3. Press **Play** to start the animation and audio
+4. Use the controls to adjust playback speed or scrub to specific moments
+
+For detailed documentation on how to build and customize the application, see [CPA_Map_App.md](CPA_Map_App.md).
+
+## Project Structure
+
+- `CPA_map_with_audio.html` - Base HTML file with audio placeholder
+- `CPA_map_with_audio_embedded.html` - Final version with embedded audio
+- `CPA_map_with_audio_fixed.html` - Fixed version of the map
+- `CPA_Map_App.md` - Comprehensive application documentation
+- `recording.mp3` / `KLVK2-Jan-26-2026-2130Z.mp3` - ATC audio recordings
+- `track_*.csv` / `track_*.json` - Flight track data
+- `separation_*.png` - Separation analysis charts
+- `trim_atc.sh` - Script for trimming ATC audio
+
+## Dependencies
+
+- **Leaflet 1.9.4** - Interactive mapping library (loaded from CDN)
+- **OpenStreetMap** - Map background tiles
+
+Both dependencies require internet connectivity for initial load. Once loaded, the application works offline.
+
+## License
+
+Please refer to the repository for license information.
+
+## Contributing
+
+Contributions are welcome! Please visit the [GitHub repository](https://github.com/vlenchik/CPA-Air) to open issues or submit pull requests.
diff --git a/index.html b/index.html
index 64102ef..8a9806f 100644
--- a/index.html
+++ b/index.html
@@ -3,11 +3,96 @@
- Index Page
+ CPA-Air - Aircraft Closest Point of Approach Visualization
+
-
- Welcome to the Index Page
- This is the content copied from the original file.
+ CPA-Air
+ Browser-based visualization tool for analyzing Closest Point of Approach (CPA) events between aircraft.
+
+
+
+ View on GitHub
+
+ About This Project
+ This project provides an animated map playback synchronized with ATC audio recordings to help pilots, controllers, and investigators review close encounter geometry and communications.
+
+ Current Event
+ Analysis of a CPA event between N748PK (RV-series aircraft) and N89WD near KLVK (San Jose, CA) on January 26, 2026.
+
+
+
+ Quick Start
+
+ - Click on one of the HTML visualization files above
+ - Press Play to start the animation and audio
+ - Use the controls to adjust playback speed or scrub to specific moments
+
+
+ Repository
+ For more information, issues, or contributions, visit: https://github.com/vlenchik/CPA-Air