chore: isolate deferred Web3 browser & CalorieDB behind feature flags

Author: CalorieApp Maintainer

README.md

@@ -74,8 +74,9 @@ If you disagree with any clause, do not use, clone, build, or distribute this so
 | Social Assets | ✅ | Dynamic image generator (edge‑to‑edge typography) |
 | Accessibility | 🚧 | Contrast audit scheduled |
 | Performance Profiling | 🚧 | Planned instrumentation |
-| CalorieDB Sync | 🔜 | Deferred indexing & storage phase |
+| CalorieDB Sync | 🔜 | Deferred (isolated) |
 | WalletConnect | 🔜 | Phase 1 design queued |
+| Web3 Browser | 🔜 | Deferred (flagged) |
 
 Legend: ✅ Complete · ⏳ Partial · 🚧 In Progress · 🔜 Planned
 
@@ -156,6 +157,15 @@ Robust connectivity with automatic failover:
 Lightweight in-memory caching for select XRPL requests (e.g. `ServerInfo`) reduces redundant network calls and stabilizes performance under intermittent connectivity. Cache entries automatically expire after a short TTL.
 
 ## 🚀 Getting Started (Pre-Release Notice)
+## ⏳ Deferred Components (Isolated)
+
+The following planned features are isolated under feature flags and excluded from the active beta build:
+
+- **Web3 Browser Screen** (`ENABLE_WEB3_BROWSER=False`): Future in-app browsing / WalletConnect surface.
+- **CalorieDB Sync Layer** (`ENABLE_CALORIE_DB=False`): Planned decentralized product scan indexing (IPFS + BigchainDB).
+
+They reside in `src/_deferred/` and can be re-enabled via flags once scoped for a release milestone.
+
 
 Runtime/build commands have been deliberately removed (v1.1.2) to prevent distribution of unfinished work. Request internal access: info@calorietoken.net.
 

src/_deferred/Web3BrowserScreen.py

@@ -0,0 +1,17 @@
+from kivy.uix.screenmanager import Screen
+from src.core.feature_flags import ENABLE_WEB3_BROWSER
+from src.utils.ui_feedback import info as ui_info
+
+
+class Web3BrowserScreen(Screen):  # DEFERRED
+    """Deferred Web3 browser screen.
+
+    Currently disabled (ENABLE_WEB3_BROWSER=False). When enabled this will
+    provide in-app browsing / WalletConnect session handling.
+    """
+
+    def open_url(self, url: str):  # Guarded no-op when disabled
+        if not ENABLE_WEB3_BROWSER:
+            ui_info("Web3 browser feature deferred")
+            return
+        ui_info("Web3 browser not yet implemented")

src/_deferred/__init__.py

@@ -0,0 +1,5 @@
+"""Deferred / experimental modules.
+
+Modules in this package are excluded from active beta functionality.
+They may be incomplete, un-audited, and subject to removal.
+"""

src/_deferred/caloriedb.py

@@ -0,0 +1,20 @@
+"""Deferred CalorieDB integration layer. DEFERRED.
+
+Original prototype handled decentralized storage (IPFS + BigchainDB).
+Extracted from active code path until indexing & sync phase is scheduled.
+"""
+
+from typing import Dict, Any
+from src.core.feature_flags import ENABLE_CALORIE_DB
+from src.utils.ui_feedback import info as ui_info
+
+
+def record_scan(product: Dict[str, Any], barcode: str):  # DEFERRED stub
+    if not ENABLE_CALORIE_DB:
+        ui_info("CalorieDB sync deferred")
+        return {"status": "deferred", "barcode": barcode}
+    # Future: implement full decentralized ingest
+    ui_info("CalorieDB ingest not implemented")
+    return {"status": "pending", "barcode": barcode}
+
+__all__ = ["record_scan"]

src/core/app.py

@@ -36,7 +36,9 @@
 from src.screens.NFTMintScreen import NFTMintScreen
 from src.screens.SendXRPScreen import SendXRPScreen
 from src.screens.SettingsScreen import SettingsScreen
-from src.screens.Web3BrowserScreen import Web3BrowserScreen
+from src.core.feature_flags import ENABLE_WEB3_BROWSER
+if ENABLE_WEB3_BROWSER:
+    from src._deferred.Web3BrowserScreen import Web3BrowserScreen  # type: ignore
 from src.screens.WebViewScreen import WebViewScreen
 from src.utils.wallet_connect.xaman_connector import XamanConnector
 from src.utils.responsive import init_responsive, get_size_class, scale_dp, scale_font, ResponsiveDebugOverlay
@@ -246,7 +248,9 @@ def build(self):
         self.barcode_scan_screen = BarcodeScanScreen(name="barcode_scan_screen")
         self.camera_scan_screen = CameraScanScreen(name="camera_scan_screen")
         self.settings_screen = SettingsScreen(name="settings_screen")
-        self.web3_browser_screen = Web3BrowserScreen(name="web3_browser_screen")
+        if ENABLE_WEB3_BROWSER:
+            self.web3_browser_screen = Web3BrowserScreen(name="web3_browser_screen")
+            self.manager.add_widget(self.web3_browser_screen)
         self.webview_screen = WebViewScreen(name="webview_screen")
 
         # Add all screens to manager
@@ -276,7 +280,9 @@ def build(self):
         self.manager.add_widget(self.barcode_scan_screen)
         self.manager.add_widget(self.camera_scan_screen)
         self.manager.add_widget(self.settings_screen)
-        self.manager.add_widget(self.web3_browser_screen)
+        if ENABLE_WEB3_BROWSER:
+            # Already added above when created
+            pass
         self.manager.add_widget(self.webview_screen)
 
         # Determine initial screen based on wallet data - optimized for speed
@@ -415,8 +421,11 @@ def navigate_to_settings(self):
         self.manager.current = "settings_screen"
 
     def navigate_to_web3_browser(self):
-        """Navigate to Web3 Browser screen"""
-        self.manager.current = "web3_browser_screen"
+        """Navigate to Web3 Browser screen (deferred)"""
+        if ENABLE_WEB3_BROWSER:
+            self.manager.current = "web3_browser_screen"
+        else:
+            print("Web3 browser feature deferred (flag disabled)")
 
     def navigate_to_webview(self):
         """Navigate to in-app WebView screen (feature flagged)"""

src/core/feature_flags.py

@@ -0,0 +1,20 @@
+"""Centralized feature flags for deferred/experimental components.
+
+Flags gate visibility and import of modules that are not part of the
+current beta production surface. Each flag MUST default to False.
+
+Contributing:
+ - Add new flags here for any feature not ready for release.
+ - Guard screen registration, menu items, and actions using these flags.
+ - Do not perform side effects at import time.
+"""
+
+# Deferred screens / modules
+ENABLE_WEB3_BROWSER = False  # Web3BrowserScreen (Android WebView pending)
+ENABLE_CALORIE_DB = False    # CalorieDB decentralized scan recording pipeline
+
+def is_enabled(name: str) -> bool:
+    return {
+        "web3_browser": ENABLE_WEB3_BROWSER,
+        "calorie_db": ENABLE_CALORIE_DB,
+    }.get(name, False)