update troubleshooting section with nested accordions

support_docs.py

@@ -237,31 +237,91 @@ def create_support_docs():
             gr.Markdown("""
             ### Common Issues and Solutions
             
-            **Build Errors**
-            - Check requirements.txt compatibility
-            - Ensure Gradio version ≥ 5.39.0
-            - Verify all dependencies are available
+            Find solutions to common problems organized by category.
+            """)
             
-            **API Errors**
-            - Verify API_KEY is set correctly
-            - Check API key starts with 'sk-or-'
-            - Ensure you have API credits
+            with gr.Accordion("Build Errors", open=False):
+                gr.Markdown("""
+                **Requirements Compatibility**
+                - Ensure Gradio version ≥ 5.39.0 in requirements.txt
+                - Check all dependencies are spelled correctly
+                - Verify version numbers are compatible
+                
+                **Common Build Failures**
+                - Missing dependencies: Add to requirements.txt
+                - Import errors: Check module names and casing
+                - Syntax errors: Review app.py for Python syntax issues
+                """)
             
-            **Access Issues**
-            - ACCESS_CODE must match exactly
-            - Check for extra spaces in password
-            - Verify secret is properly saved
+            with gr.Accordion("API Errors", open=False):
+                gr.Markdown("""
+                **API Key Issues**
+                - Verify API_KEY is set in HuggingFace Secrets
+                - Ensure key starts with 'sk-or-' for OpenRouter
+                - Check for extra spaces or quotes in the secret value
+                
+                **API Response Errors**
+                - 401 Unauthorized: Invalid API key
+                - 402 Payment Required: No API credits remaining
+                - 429 Rate Limited: Too many requests, wait and retry
+                - 500 Server Error: OpenRouter service issue
+                """)
             
-            **Preview Not Working**
-            - Set API_KEY in local environment
-            - Check browser console for errors
-            - Ensure configuration is saved
+            with gr.Accordion("Access Control Issues", open=False):
+                gr.Markdown("""
+                **ACCESS_CODE Problems**
+                - Code must match exactly (case-sensitive)
+                - Don't include quotes around the password
+                - Check for trailing spaces in the secret
+                - To disable: Delete the ACCESS_CODE secret entirely
+                
+                **Authentication Flow**
+                - Users enter code on first visit
+                - Code is stored in browser session
+                - Clear cookies to re-prompt for code
+                """)
             
-            **Configuration Status Shows Red X:**
-            - Verify API key secret name matches configuration
-            - Check OpenRouter account has credits
-            - Regenerate API key if needed
-            """)
+            with gr.Accordion("Preview Tab Not Working", open=False):
+                gr.Markdown("""
+                **Local Testing**
+                - Set API_KEY in your local .env file
+                - Format: `API_KEY=sk-or-your-key-here`
+                - Restart the app after adding environment variable
+                
+                **Preview Issues**
+                - Click "💬 Preview Configuration" first
+                - Check browser console (F12) for JavaScript errors
+                - Ensure all required fields are filled
+                - Try refreshing the page
+                """)
+            
+            with gr.Accordion("Configuration Status Shows ❌", open=False):
+                gr.Markdown("""
+                **Status Check Failures**
+                - Red X means configuration issue detected
+                - Usually indicates missing or invalid API key
+                
+                **Resolution Steps**
+                1. Verify secret name matches your configuration
+                2. Default is API_KEY, check if you changed it
+                3. Regenerate API key at openrouter.ai/keys
+                4. Update secret in HuggingFace Space settings
+                5. Wait 30 seconds and refresh
+                """)
+            
+            with gr.Accordion("Space Not Loading", open=False):
+                gr.Markdown("""
+                **Infinite Loading**
+                - Check Space logs for error messages
+                - Common cause: Missing required secrets
+                - Verify all files uploaded correctly
+                
+                **Gradio App Errors**
+                - Component version mismatches
+                - Update to latest Gradio version
+                - Check for deprecated components
+                - Review migration guides for Gradio 5.x
+                """)
         
         with gr.Accordion("📚 Additional Resources", open=False):
             gr.Markdown("""