Lovable Prompt Creator - AI Prompt Generator

## APPLICATION OVERVIEW
The project is a web application called "Review Pain-Point Copilot" that allows users to paste a Play Store app link and receive a detailed analysis of the app's top user pain points. The application employs a structured approach to gather, analyze, and present user feedback, focusing on the most critical issues highlighted in reviews.

## CORE FEATURES
1. **Input Layer**: A single text field for users to input the Play Store app URL. It includes basic validation to ensure the URL is valid and provides clear error messages when necessary.
   
2. **Scraping Layer**: Utilizes the google-play-scraper to extract the last 300-1000 reviews for the provided app, prioritizing 1-2 star reviews while maintaining context from other ratings.

3. **Clustering Layer**: Employs a language model to group reviews into specific themes, providing structured outputs that include review counts, percentages, example quotes, and a confidence tag based on review consistency.

4. **Output / Dashboard Layer**: Presents a ranked list of pain points, each card showing the theme name, mention count, confidence badge, and example quotes. Includes a note about potential noise in low-count clusters.

5. **User Feedback Loop**: Incorporates real user testing to refine the application based on actual user interactions and feedback, ensuring usability and relevance.

## DESIGN SPECIFICATIONS
- **Visual Style**: minimalist - Clean, simple design with plenty of white space, minimal color palette, and focus on typography.
- **Color Mode**: Light theme with dark text on light backgrounds.
- **Primary Color**: #1978E5 (accent for buttons, links, highlights).
- **Typography**: Use Inter from Google Fonts for headings, Inter for body text and UI elements.
- **Border Radius**: 8px (moderately rounded) for buttons, cards, and inputs.
- **Layout**: The main layout structure will be a single-column format with a prominent input field at the top, followed by the results section displaying the ranked pain points in a clean, scannable format.

## TECHNICAL REQUIREMENTS
- **Framework**: React with TypeScript
- **Styling**: Tailwind CSS
- **UI Components**: shadcn/ui
- **State Management**: React Context API or Zustand for state management as needed.

## IMPLEMENTATION STEPS
1. **Setup Project**: Initialize a new React project with TypeScript and install Tailwind CSS along with shadcn/ui.
2. **Create Input Component**: Develop the input layer with validation logic to ensure the URL is a valid Play Store link.
3. **Implement Scraper Logic**: Integrate the google-play-scraper to fetch reviews based on the provided package ID, focusing on review text, rating, and date.
4. **Develop Clustering Logic**: Use the Claude API to process the reviews, creating a structured JSON output that groups reviews into themes with confidence tags.
5. **Design the Output Dashboard**: Create a results display component that shows the ranked pain points, including necessary details like theme name, mention count, confidence, and example quotes.
6. **User Testing**: Conduct tests with real users to gather feedback, iterating on design and functionality based on their experiences.

## USER EXPERIENCE
The user experience focuses on simplicity and clarity. Users will interact with a single input field to enter the app URL, and upon submission, they will receive a clear, organized list of pain points. Each point will be easy to read, with a focus on the most critical feedback from users, ensuring that users can quickly grasp the main issues with the app. The light theme and minimalist design will contribute to an overall pleasant user interface, promoting ease of use and accessibility.