diff --git a/README.md b/README.md
index 9bb7e46..a3f7f35 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,44 @@
-# repo1
+# Trending Keywords App with Opportunity Scoring
 
-repo for tracke
\ No newline at end of file
+A web application that identifies globally trending keywords with high search volume but low competition, and generates ChatGPT-friendly prompts for article creation based on those keywords.
+
+## Features
+
+- **Dynamic Keyword Opportunity Scoring**: Identifies keywords with high search volume but low result count, providing content creation opportunities
+- **Multiple Data Sources**: Fetches trending topics from Wikipedia, Google Trends (simulated), and emerging research topics
+- **Detailed Metrics Display**: Shows opportunity score, search volume, result count, and competition level for each keyword
+- **ChatGPT Prompt Generation**: Creates optimized article prompts based on selected keywords and their metrics
+- **Copy to Clipboard**: One-click copying of generated prompts for easy use with ChatGPT
+- **Responsive Design**: Works on desktop and mobile devices
+
+## Technical Implementation
+
+- **Frontend-Only Architecture**: Pure HTML, CSS, and JavaScript implementation that runs entirely in the browser
+- **Opportunity Scoring Algorithm**: Uses a weighted average of normalized search volume and inverse normalized result count
+- **API Integration**: Fetches real-time trending topics from the Wikipedia API with fallback options
+- **Asynchronous Data Processing**: Handles multiple data sources and enrichment processes efficiently
+
+## How to Use
+
+1. Open `index.html` in any modern web browser
+2. The app automatically loads trending keywords with opportunity scores
+3. Click the "Refresh Keywords" button to fetch new trending topics
+4. Select any keyword card to use it for prompt generation
+5. Click "Generate Article Prompt" to create a ChatGPT-friendly prompt
+6. Use the "Copy to Clipboard" button to copy the prompt for use with ChatGPT
+
+## Project Structure
+
+```
+trending-keywords-app/
+├── index.html          # Main HTML structure
+├── styles.css          # CSS styling
+└── app.js              # JavaScript functionality
+```
+
+## Future Enhancements
+
+- Integration with additional trending topic APIs
+- User accounts to save favorite keywords and prompts
+- Advanced filtering options for keyword discovery
+- Custom prompt templates for different content types
\ No newline at end of file