- Added proper error handling for missing voice models in preview endpoint
- Return 404 with helpful message when Piper models not found
- Added user-friendly alert in frontend when preview fails
- Added prominent warning in UI when Piper is selected about manual setup
- Check for empty audio before returning to prevent decode errors
Users now get clear feedback when Piper voice models are missing
instead of cryptic 'media could not be decoded' errors.
- Added engine selection buttons (Kokoro vs Piper) in VoiceAssignmentSection
- Implemented getEngines(), setEngine(), and getVoices() API client functions
- Engine selector dynamically loads available voices for selected engine
- Added visual feedback for active engine with descriptions
- Piper engine shows pitch control capability notice
- Voice dropdowns update automatically when switching engines
- Audio cache clears when switching engines for clean state
Users can now easily switch between Kokoro (high quality) and
Piper (fast with pitch control) directly from the UI.
- Clear all cached previews for a role when age changes
- Clear all cached previews for a role when voice changes
- Now preview correctly reflects the selected age speed modifier
Features:
- Voice preview button to test voices before generation
- Age category selection (young, teen, adult, old)
- Age categories adjust voice speed automatically:
- Young: 1.15x (faster, energetic)
- Teen: 1.08x (slightly faster)
- Adult: 1.0x (normal)
- Old: 0.85x (slower, measured)
- Preview caching to avoid regenerating same voice
- Backend /api/tts/preview endpoint for voice samples
- Frontend previewVoice API function
This allows users to hear how each voice sounds and adjust
character ages to make them sound younger or older.
- Move Google Fonts import before Tailwind directives
- Fix PostCSS build warning
- Ensure proper CSS compilation
NOTE: Dev server must be restarted for changes to take effect
- Add generous padding and spacing throughout (p-10, p-12)
- Constrain content width with max-w-4xl and max-w-5xl
- Increase font sizes for better hierarchy (text-3xl, text-lg)
- Add gradient backgrounds to cards and elements
- Implement smooth transitions and hover states
- Create professional progress stepper with labels
- Add shadow effects with color-matched glows
- Increase button padding and font sizes
- Add gradient borders on hover
- Implement proper visual breathing room
- Create polished, premium aesthetic
- Add smooth cubic-bezier transitions
- Improve form input styling with focus rings
- Create professional card hover effects
- Add animated gradient backgrounds with floating particles
- Implement advanced glass morphism with enhanced blur effects
- Add Google Fonts Inter for professional typography
- Create sophisticated button animations with ripple effects
- Add progress indicator dots showing current step
- Implement card hover effects with smooth transforms
- Add animated gradient text with shimmer effects
- Create premium loading spinners with dual rings
- Add character counter to textarea
- Implement numbered badges for roles and segments
- Add gradient backgrounds to all cards and sections
- Create pulsing glow animations for important elements
- Add emoji icons throughout for visual appeal
- Implement responsive grid layouts for settings
- Add detailed subtitles and descriptions to sections
- Create success celebration with bouncing animation
- Add shadow effects with color-matched glows
- Implement smooth transitions and cubic-bezier easing
- Add visual hierarchy with varied font weights
- Create immersive, modern user experience
- Add purple/indigo gradient background throughout app
- Implement glass morphism effects on all cards
- Add gradient buttons with smooth hover animations
- Integrate emoji icons for better visual communication
- Enhance typography with improved font stack
- Add loading spinners and smooth transitions
- Improve color scheme with modern purple/indigo palette
- Add glowing shadows and depth effects
- Maintain responsive design and touch-friendly interactions
- Changed 'Generate Audiobook' button to 'Next: Review Script'
- Added 'Skip Review & Generate' button as alternative
- Updated button handlers to call handleGenerateScript and handleSkipReview
- Updated button styling: primary button now blue for review, green for skip
- Maintains backward compatibility with optional onSkipReview prop
Requirements: 15.1, 15.8
- Add 'review' phase to application state
- Add scriptSegments state variable for storing AI-generated segments
- Add isGeneratingScript loading state for script generation
- Implement handleGenerateScript() to call API and transition to review phase
- Implement handleSkipReview() to bypass review and go directly to generation
- Implement handleSegmentChange() to update speaker assignments in segments
- Update handleGenerate() to use edited segments when available
- Wire up ScriptReviewSection component in review phase
- Update phase transitions: input → assignment → review → generated
- Add loading indicator for script generation
Validates Requirements: 15.1, 15.3, 15.6, 15.7, 15.8
Task: 22. Update App component for script review workflow
- Created ScriptReviewSection component with script segment display
- Added speaker dropdown for each segment to allow editing assignments
- Implemented Generate Audiobook and Skip Review buttons
- Styled for readability and mobile responsiveness with Tailwind CSS
- Text segments displayed as read-only (only speaker assignment is editable)
- Follows existing component patterns from VoiceAssignmentSection
- Validates Requirements 15.3, 15.4, 15.5, 15.6, 15.8
- Updated main README with detailed setup, Kokoro model configuration, and troubleshooting
- Enhanced backend README with API documentation, Docker setup, and testing instructions
- Improved frontend README with component details, deployment guide, and development tips
- Added workflow testing steps and common error solutions
- Documented all supported languages, voices, and configuration options
Implements task 14 from text-to-audiobook spec
Requirements: 13.1, 13.2, 13.3, 13.4, 13.5
- Applied Tailwind CSS responsive classes across all components
- Implemented mobile-first design approach with breakpoints (sm, md, lg)
- Added touch-friendly interactions with min-h-[44px] touch targets
- Enhanced App.tsx with responsive padding, headings, and alerts
- Updated TextInputSection with responsive textarea and full-width mobile button
- Improved VoiceAssignmentSection with flexible layouts and mobile-optimized controls
- Enhanced AudioPlayerSection with responsive sizing and touch support
- Added custom CSS for range slider with larger thumb for mobile
- Improved select dropdowns with visible arrows and proper padding
- Added touch-manipulation class to prevent double-tap zoom
- Added active states for better mobile feedback
- Updated index.html with proper title and meta description
- Created RESPONSIVE_IMPROVEMENTS.md documentation
Requirements: 12.1, 12.2, 12.3, 12.4
- Add complete state management for text, phases, roles, voice assignments
- Implement phase transitions: input → assignment → generated
- Wire up text input to role detection API
- Wire up voice assignment to audio generation API
- Add loading states for async operations (role detection and generation)
- Implement comprehensive error handling and display
- Add warning messages for long text (>5000 chars) in assignment and generation phases
- Ensure text persists across all workflow phases
- Validates Requirements: 1.5, 6.1, 8.1, 8.2, 8.3, 8.4
- Created VoiceAssignmentSection component with role-to-voice mapping
- Added language selector with American English, British English, French, Japanese
- Added speed slider (0.5x - 1.5x range)
- Implemented Generate Audiobook button with proper disabled state
- Integrated component into App.tsx with state management
- Added role detection API call on text submission
- Validates all roles have assigned voices before enabling generation
Requirements: 3.1, 3.2, 3.3, 3.4, 3.5, 3.6, 4.1, 4.2, 4.3, 4.4, 5.1, 5.2, 5.3
- Create TextInputSection component with large multiline textarea
- Add 'Next: Assign voices' button
- Implement text validation (non-empty)
- Show validation message for empty text
- Disable button when text is empty
- Update App.tsx to integrate TextInputSection
- Requirements: 1.1, 1.2, 1.3, 1.4
- Create TypeScript interfaces (Role, RoleWithVoice, RolesResponse, GenerateRequest)
- Implement detectRoles() function for role detection
- Implement generateAudiobook() function for audio generation
- Implement checkHealth() function for backend health checks
- Add comprehensive error handling for network failures
- Use VITE_API_BASE_URL environment variable for configuration
- Add ApiError class for structured error handling
Requirements: 9.6, 9.7
- Created backend directory with FastAPI project structure
- Created frontend directory with React + TypeScript + Vite
- Configured Python virtual environment and installed dependencies (fastapi, uvicorn, kokoro, soundfile, python-multipart)
- Verified espeak-ng system dependency is installed
- Configured Node.js project with TypeScript, React, and Vite
- Set up Tailwind CSS for styling
- Set up environment variable configuration for both projects
- Created comprehensive README documentation
Requirements: 9.6, 10.2, 11.1
