added new features, fixed cdn bug

Author: georgekhananaev

MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+recursive-include fastapi_docshield/static *

README.md

@@ -34,6 +34,8 @@ pip install -e .
 
 ## Quick Usage
 
+### Single User
+
 ```python
 from fastapi import FastAPI
 from fastapi_docshield import DocShield
@@ -44,13 +46,145 @@ app = FastAPI()
 def read_root():
     return {"Hello": "World"}
 
-# Add protection to docs
+# Add protection to docs with a single user
 DocShield(
     app=app,
     credentials={"admin": "password123"}
 )
 ```
 
+### Multiple Users
+
+```python
+from fastapi import FastAPI
+from fastapi_docshield import DocShield
+
+app = FastAPI()
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+# Add protection to docs with multiple users
+DocShield(
+    app=app,
+    credentials={
+        "admin": "admin_password",
+        "developer": "dev_password",
+        "viewer": "viewer_password"
+    }
+)
+```
+
+### CDN Fallback Mode (Default)
+
+```python
+from fastapi import FastAPI
+from fastapi_docshield import DocShield
+
+app = FastAPI()
+
+# Default mode: Use CDN with automatic fallback to local files
+DocShield(
+    app=app,
+    credentials={"admin": "password123"},
+    use_cdn_fallback=True  # Default - automatically falls back to local if CDN fails
+)
+```
+
+### Prefer Local Files
+
+```python
+from fastapi import FastAPI
+from fastapi_docshield import DocShield
+
+app = FastAPI()
+
+# Always use local files instead of CDN
+DocShield(
+    app=app,
+    credentials={"admin": "password123"},
+    prefer_local=True  # Serve documentation from bundled static files
+)
+```
+
+### CDN Only (No Fallback)
+
+```python
+from fastapi import FastAPI
+from fastapi_docshield import DocShield
+
+app = FastAPI()
+
+# Use CDN without fallback (original behavior)
+DocShield(
+    app=app,
+    credentials={"admin": "password123"},
+    use_cdn_fallback=False  # Disable fallback, CDN only
+)
+```
+
+### Custom CSS and JavaScript
+
+```python
+from fastapi import FastAPI
+from fastapi_docshield import DocShield
+import requests
+
+app = FastAPI()
+
+# Load dark theme CSS from external source
+# You can use https://github.com/georgekhananaev/fastapi-swagger-dark
+dark_theme_url = "https://raw.githubusercontent.com/georgekhananaev/fastapi-swagger-dark/main/src/fastapi_swagger_dark/swagger_ui_dark.min.css"
+custom_css = requests.get(dark_theme_url).text
+
+# Custom JavaScript for analytics
+custom_js = """
+console.log('📊 Documentation accessed at:', new Date().toISOString());
+document.addEventListener('DOMContentLoaded', function() {
+    console.log('Dark theme loaded!');
+});
+"""
+
+# Apply with custom styling
+DocShield(
+    app=app,
+    credentials={"admin": "password123"},
+    custom_css=custom_css,
+    custom_js=custom_js
+)
+```
+
+#### Using with fastapi-swagger-dark
+
+For a complete dark theme solution, you can use the [fastapi-swagger-dark](https://github.com/georgekhananaev/fastapi-swagger-dark) package:
+
+```python
+from fastapi import FastAPI
+from fastapi_docshield import DocShield
+import requests
+
+app = FastAPI()
+
+# Fetch dark theme CSS
+response = requests.get(
+    "https://raw.githubusercontent.com/georgekhananaev/fastapi-swagger-dark/main/src/fastapi_swagger_dark/swagger_ui_dark.min.css"
+)
+dark_css = response.text
+
+DocShield(
+    app=app,
+    credentials={"admin": "password123"},
+    custom_css=dark_css  # Apply dark theme
+)
+```
+
+See [examples/custom_styling.py](examples/custom_styling.py) for more customization examples including:
+- ✨ Minimal clean theme
+- 🏢 Corporate theme with analytics
+- 📖 ReDoc customization
+- 🎨 Custom branding
+
 ## Running Demo
 
 ```bash
@@ -80,9 +214,36 @@ pytest --cov=fastapi_docshield
 - Protect Swagger UI, ReDoc, and OpenAPI JSON endpoints
 - Customizable endpoint URLs
 - Multiple username/password combinations
+- **Automatic CDN fallback** - Falls back to local files if CDN is unavailable
+- **Local file preference option** - Serve documentation from local files for better reliability
+- **Custom CSS and JavaScript injection** - Fully customize the look and behavior of documentation
+- **Resilient documentation** - Works even when CDN is down or blocked
 - Tested on Python 3.7-3.13
 - Compatible with uv package manager
 
+## Changelog
+
+### Version 0.2.0 (2025-08-17)
+- **Added**: Custom CSS and JavaScript injection support
+  - New `custom_css` parameter to inject custom styles into documentation pages
+  - New `custom_js` parameter to inject custom JavaScript for enhanced functionality
+  - Complete customization examples for dark theme, minimal theme, corporate branding, and analytics
+  - Support for both Swagger UI and ReDoc customization
+- **Added**: Automatic CDN fallback to local files for better reliability
+  - Documentation now automatically falls back to bundled static files if CDN is unavailable
+  - New `prefer_local` option to always serve from local files
+  - New `use_cdn_fallback` option to control fallback behavior
+  - Bundled Swagger UI and ReDoc static files for offline capability
+- **Fixed**: Static file URL bug that caused blank documentation pages
+  - Previously, when no custom CDN URLs were provided, the package would pass `None` values to FastAPI's documentation functions
+  - This resulted in HTML with `href="None"` and `src="None"`, causing white/blank pages
+  - Now properly handles default CDN URLs when custom URLs are not specified
+
+### Version 0.1.0 (2025-01-15)
+- Initial release
+- Basic HTTP authentication for FastAPI documentation endpoints
+- Support for multiple users
+
 ## License
 
 MIT License - Copyright (c) 2025 George Khananaev

examples/advanced_example.py

@@ -54,20 +54,35 @@ async def read_users_me(token: str = Depends(oauth2_scheme)):
     user = fake_users_db[token]
     return user
 
-# Protect the docs with DocShield - using custom URLs and UI resources
+# Protect the docs with DocShield - showcasing various features
 DocShield(
     app=app,
     credentials={
         "admin": "admin123",  # Credentials for accessing the docs
+        "dev": "dev456"       # Multiple users supported
     },
     docs_url="/api/docs",              # Custom docs URL 
     redoc_url="/api/redoc",            # Custom redoc URL
     openapi_url="/api/openapi.json",   # Custom OpenAPI JSON URL
 
-    # Optional: custom Swagger UI and ReDoc resources
-    swagger_js_url="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js",
-    swagger_css_url="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css",
-    redoc_js_url="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"
+    # New in v0.2.0: CDN fallback options
+    use_cdn_fallback=True,  # Automatically fallback to local files if CDN fails (default: True)
+    prefer_local=False,     # Set to True to always use local files instead of CDN
+    
+    # New in v0.2.0: Custom CSS and JavaScript injection
+    custom_css="""
+        /* Custom branding example */
+        .swagger-ui .topbar { 
+            background-color: #2c3e50; 
+        }
+        .swagger-ui .topbar .download-url-wrapper { 
+            display: none; 
+        }
+    """,
+    custom_js="""
+        console.log('Advanced API Documentation Loaded');
+        // Add custom functionality here
+    """
 )
 
 # Run with: uvicorn advanced_example:app --reload