feat: Prepare for Hugging Face Spaces deployment

- Add HF Spaces YAML frontmatter to README (sdk: streamlit, app_file, python_version)
- Strip dev dependencies from requirements.txt for leaner cloud installs
- Add st.secrets → env var bridge in settings.py for platform portability
- Add runtime.txt pinning Python 3.12

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

README.md

@@ -1,3 +1,14 @@
+---
+title: Devil's Dozen
+emoji: 🎲
+colorFrom: red
+colorTo: yellow
+sdk: streamlit
+app_file: src/ui/app.py
+python_version: "3.12"
+pinned: false
+---
+
 # Devil's Dozen 🎲
 
 A medieval-themed multiplayer dice game supporting 2-4 players across two distinct game modes.

requirements.txt

@@ -1,5 +1,5 @@
-# Devil's Dozen - Dependencies
-# Python 3.11+ required
+# Devil's Dozen - Production Dependencies
+# Python 3.12+ required
 
 # Core Framework
 streamlit>=1.32.0
@@ -15,15 +15,3 @@ pydantic-settings>=2.2.0
 # UI Enhancements
 streamlit-lottie>=0.0.5
 Pillow>=10.2.0
-
-# Testing
-pytest>=8.0.0
-pytest-cov>=4.1.0
-pytest-asyncio>=0.23.0
-
-# Type Checking
-mypy>=1.8.0
-
-# Development
-black>=24.2.0
-isort>=5.13.0

runtime.txt

@@ -0,0 +1 @@
+python-3.12

src/config/settings.py

@@ -2,13 +2,27 @@
 Devil's Dozen - Application Settings
 
 Loads configuration from environment variables using Pydantic Settings.
+On Streamlit Cloud, bridges st.secrets into env vars so Pydantic can read them.
 """
 
+import os
 from functools import lru_cache
 
 from pydantic_settings import BaseSettings
 
 
+def _load_streamlit_secrets() -> None:
+    """Bridge Streamlit Cloud secrets into environment variables."""
+    try:
+        import streamlit as st
+
+        for key in ("SUPABASE_URL", "SUPABASE_ANON_KEY", "DEBUG", "LOG_LEVEL", "ENABLE_SOUNDS"):
+            if key not in os.environ and key in st.secrets:
+                os.environ[key] = str(st.secrets[key])
+    except Exception:
+        pass
+
+
 class Settings(BaseSettings):
     """Application settings loaded from environment variables."""
 
@@ -32,4 +46,5 @@ class Settings(BaseSettings):
 @lru_cache(maxsize=1)
 def get_settings() -> Settings:
     """Cached singleton settings instance."""
+    _load_streamlit_secrets()
     return Settings()