fix: PrimaryButton ref warning + research modal close race condition

.planning/PROJECT.md

@@ -0,0 +1,46 @@
+# ALwrity Project
+
+## What This Is
+ALwrity is an AI-powered content creation platform that helps users generate various types of content including podcasts, videos, blogs, and social media content. The platform features a React frontend and a FastAPI backend with onboarding workflows, API key management, and content generation capabilities.
+
+## Core Value
+To provide an all-in-one AI content creation suite that simplifies the content production process for creators, marketers, and businesses.
+
+## Current Focus
+Based on recent git commits, the team has been working on:
+- Podcast production features (voice cloning, avatar generation, B-roll integration)
+- Onboarding flow improvements
+- Backend stability and debugging
+- Frontend UI/UX enhancements
+
+## Requirements
+
+### Validated
+- User authentication (Clerk)
+- API key management for AI providers
+- Basic podcast generation workflow
+- File storage and media handling
+
+### Active
+- Podcast script generation and editing
+- Voice cloning and avatar creation
+- B-roll scene rendering and integration
+- Onboarding flow completion tracking
+- API endpoint stability and debugging
+
+### Out of Scope
+- Mobile applications (currently web-only)
+- Enterprise team collaboration features
+- Advanced analytics dashboard
+
+## Key Decisions
+- Using FastAPI for backend performance
+- React with Material-UI for frontend consistency
+- Modular API design for extensibility
+- Database-first approach for persistence
+
+## Constraints
+- Must maintain backward compatibility with existing API
+- Deployment targets include both development and production environments
+- Must support multiple AI providers (OpenAI, HuggingFace, etc.)
+- Budget-conscious resource usage for AI API calls

.planning/STATE.md

@@ -0,0 +1,40 @@
+# Project State
+
+## Project Reference
+**Core Value**: ALwrity is an AI-powered content creation platform that helps users generate various types of content including podcasts, videos, blogs, and social media content.
+
+**Current Focus**: Based on recent development activity, the team is implementing Phase 2 of the WaveSpeed AI integration roadmap - Hyper-Personalization features for the Persona system, including voice training and avatar creation.
+
+## Current Position
+**Phase**: 2 of 3 - Hyper-Personalization
+**Plan**: 3 of 5 - Persona Avatar Creation & Integration
+**Status**: In Progress - Working on avatar service implementation and frontend UI for avatar creation
+
+## Progress
+Progress: [███████░░] 70%
+
+## Recent Decisions
+1. **Avatar Service Architecture**: Decided to create a shared avatar service in backend/services/wavespeed/avatar/ for reuse across LinkedIn and Persona modules
+2. **UI Framework**: Continuing with Material-UI (MUI) for consistent avatar creation interface
+3. **Storage Strategy**: Using cloud storage for avatar assets with metadata tracking in PostgreSQL
+4. **Generation Queue**: Implementing asynchronous processing for avatar generation to prevent API timeouts
+
+## Pending Todos
+- [ ] Complete avatar generation API endpoints
+- [ ] Implement avatar library management UI
+- [ ] Add avatar preview functionality
+- [ ] Create avatar upload/download capabilities
+- [ ] Integrate avatar selection into Persona dashboard
+- [ ] Add usage tracking and cost estimation for avatar generation
+- [ ] Write comprehensive tests for avatar service
+- [ ] Update documentation for avatar feature
+
+## Blockers/Concerns
+- **WaveSpeed API Rate Limits**: Need to implement proper queuing and retry mechanisms
+- **Storage Costs**: Avatar storage could become expensive at scale - need to implement cleanup policies
+- **Generation Time**: Avatar generation can take 30-60 seconds - need to improve user experience during wait
+- **Quality Consistency**: Ensuring generated avatars maintain consistent quality across different inputs
+
+Last session: 2026-04-21 07:02:08
+Stopped at: Session resumed, proceeding to discuss Phase 2 context
+Resume file: [updated if applicable]