feat: comprehensive project backup - UX improvements, new features, legal hardening

COMPREHENSIVE BACKUP COMMIT - November 18, 2025

This commit secures all completed work and establishes legal/privacy protections
for the CalorieApp project as we prepare for public release.

═══════════════════════════════════════════════════════════════════════════════
🎨 UX/UI IMPROVEMENTS (24 screens updated)
═══════════════════════════════════════════════════════════════════════════════

✅ Text Overflow Fixes
- Applied `text_size: self.width, None` to all MDLabels across 24 KV files
- Fixed wrapping on intro, wallet, onboarding, and transaction screens
- Responsive text sizing for all screen sizes

✅ Layout Consistency
- Standardized spacing and sizing across all screens
- Improved back button placement and sizing
- Enhanced visual hierarchy in complex screens (DEX, NFT, Settings)

✅ New Screens Added
- BarcodeScanScreen + camera_scan_screen.kv (food scanning)
- CameraScanScreen (QR code wallet integration)
- Web3BrowserScreen + webview_screen.kv (future dApp support)

✅ Enhanced Screens
- WalletScreen: Improved balance display and transaction history
- MnemonicVerifyScreen: Better word selection UX
- Settings: Added new feature toggles and pro account options

═══════════════════════════════════════════════════════════════════════════════
🔧 NEW FEATURES & UTILITIES (26 new files)
═══════════════════════════════════════════════════════════════════════════════

🔐 Security Enhancements
- clipboard_utils.py: Auto-clear clipboard after 30s (security)
- caloriedb_encryption.py: Database encryption layer
- Enhanced password fields with proper masking

📊 CalorieDB System (Decentralized Food Database)
- caloriedb.py, caloriedb_manager.py, caloriedb_config.py
- calorie_linking.py: Link food data to XRPL
- xrpl_caloriedb_sync.py: Sync mechanism
- decentralized/: BigchainDB, IPFS integration (future)

🍕 FoodRepo Integration
- foodrepo_client.py, foodrepo_integration.py
- Open food database connectivity

💎 Pro Account System
- pro_account.py, pro_issuer.py
- Premium features framework

🔗 Wallet Connect (Future)
- wallet_connect/connector.py
- wallet_connect/xaman_connector.py
- Cross-wallet integration groundwork

⚡ Performance Optimizations
- performance/: data_cache, debouncer, resource_guard
- Enhanced resource management

🎯 UX Enhancements
- accessibility.py: Screen reader support framework
- responsive.py: Adaptive layouts
- enhanced_dialogs.py: Better user feedback
- ui_feedback.py: Visual feedback system

═══════════════════════════════════════════════════════════════════════════════
📚 DOCUMENTATION & LEGAL HARDENING
═══════════════════════════════════════════════════════════════════════════════

✅ Legal Protection
- TRADEMARK.md: Official CalorieToken® usage guidelines (EUIPO registered)
- LICENSE: Enhanced with trademark notices
- .gitignore: Updated to protect competitive implementation details

✅ Project Documentation
- CHANGELOG.md: Full version history ([1.0.0], [1.1.0], [1.1.1])
- OFFICIAL_PROJECT_DOCS.md: Public-safe documentation index
- STATUS_UPDATE_2025-11-18.md: Public progress snapshot
- ITERATIONS_6_7_8_9_COMPLETE.md: Development milestone tracker

✅ UX Tour System
- UX_TOUR_GUIDE.md: Interactive app tour documentation (updated)
- UX_TOUR_V2_UPDATES.md: Latest tour improvements
- UX_TOUR_QUICK_REF.md: Quick reference for developers
- scripts/ux_tour.py: Tour automation script (updated)

✅ Social Media Automation
- tools/generate_social_posts.ps1: Platform-specific post generator
- tools/copy_social_post.ps1: Clipboard helper
- tools/README_SOCIAL_TOOLS.md: Complete workflow guide
- docs/posts/: All platform posts + visual concepts
  - Platform-specific text files (Twitter, Telegram, Discord, LinkedIn, etc.)
  - VISUAL_CONCEPTS_2025-11-18.md: Design specs + AI prompts
  - POSTING_GUIDE_WITH_VISUALS.md: Integrated workflow

✅ GitHub Enhancements
- .github/FUNDING.yml: XRPL donation support

═══════════════════════════════════════════════════════════════════════════════
🔄 CONFIGURATION UPDATES
═══════════════════════════════════════════════════════════════════════════════

- pyproject.toml: Updated metadata and CalorieToken branding
- setup.py: Enhanced with official URLs and descriptions
- requirements.txt: Dependencies for new features
- README.md: Privacy-protected links, official docs index
- docs/README.md: Public-safe documentation index

═══════════════════════════════════════════════════════════════════════════════
🗂️ DATA FILES
═══════════════════════════════════════════════════════════════════════════════

- config/test_accounts.json: Test account configurations
- data/calorie_links.json: Food-to-token linking data

═══════════════════════════════════════════════════════════════════════════════
📊 FILES CHANGED SUMMARY
═══════════════════════════════════════════════════════════════════════════════

Modified (M):  51 files (screens, KV files, configs)
Added (A):     66 files (utilities, docs, tools, screens)
Total:         117 files changed

Modified Breakdown:
- 24 KV files (UI layouts)
- 15 Python screen files
- 5 config files
- 4 documentation files
- 3 core app files

Added Breakdown:
- 26 utility Python files
- 20 documentation files
- 7 social media post files
- 5 PowerShell automation tools
- 4 new screen files (Barcode, Camera, Web3, WebView)
- 4 KV layout files

═══════════════════════════════════════════════════════════════════════════════
🔒 PRIVACY & SECURITY NOTES
═══════════════════════════════════════════════════════════════════════════════

EXCLUDED from this commit (via .gitignore):
- Test outputs and debugging artifacts
- Internal status/analysis documents
- Competitive implementation architecture docs
- Unfinished feature roadmaps
- Development helper scripts

REASON: Protect competitive advantage and avoid revealing incomplete features
that could be copied before launch.

═══════════════════════════════════════════════════════════════════════════════
🎯 COMMIT PURPOSE
═══════════════════════════════════════════════════════════════════════════════

1. **Legal Protection**: Secure trademark and license status
2. **Complete Backup**: Preserve all working code and features
3. **Public Readiness**: Establish public-safe documentation
4. **Community Engagement**: Enable social media announcements

═══════════════════════════════════════════════════════════════════════════════
🚀 NEXT STEPS
═══════════════════════════════════════════════════════════════════════════════

- Generate social media visuals using VISUAL_CONCEPTS_2025-11-18.md
- Post announcements across platforms using tools/copy_social_post.ps1
- Continue UX testing and refinement
- Prepare for beta release

═══════════════════════════════════════════════════════════════════════════════

[date: 2025-11-18]
[version: 1.1.1]
[branch: chore/repo-hardening]

Author: CalorieApp Maintainer

.github/FUNDING.yml

@@ -0,0 +1,36 @@
+# Funding & Sponsorship Information for CalorieAppTestnet
+#
+# Support CalorieToken development via XRPL or traditional channels
+#
+# See: https://docs.github.com/articles/displaying-a-sponsor-button-in-your-repository
+
+# GitHub Sponsors
+github: # Add GitHub username if CalorieToken sets up GitHub Sponsors
+
+# Open Collective
+open_collective: # Add Open Collective username if applicable
+
+# Community Bridge
+community_bridge: # project-name
+
+# Patreon
+patreon: # Add Patreon username if applicable
+
+# Tidelift
+tidelift: # Add if package is on Tidelift
+
+# Ko-fi
+ko_fi: # Add Ko-fi username if applicable
+
+# Liberapay
+liberapay: # Add Liberapay username if applicable
+
+# IssueHunt
+issuehunt: # Add IssueHunt username if applicable
+
+# Custom donation links
+custom:
+  - "https://calorietoken.net/index.php/donate/"
+  - "XRPL Address: rNqGa93B8ewQP9mUwpwqA19SApbf62U7PY (CAL Token Issuer)"
+  - "Send XRP or Calorie tokens to support development"
+  - "Telegram: https://t.me/joinchat/8jIusxwzMVI0NGVk"

.gitignore

@@ -176,6 +176,67 @@ crash*.txt
 docs/ui_tour/*/
 !docs/ui_tour/latest/
 
+# Analysis reports (INTERNAL - contain competitive implementation details)
+analysis/
+scripts/complete_ux_tour.py
+scripts/best_practice_validator.py
+docs/BEST_PRACTICE_INTEGRATION.md
+docs/CALORIETOKEN_INTEGRATION_SUMMARY.md
+docs/UX_TOUR_*.md
+# Public-safe UX tour docs (allowlist)
+!docs/UX_TOUR_GUIDE.md
+!docs/UX_TOUR_QUICK_REF.md
+!docs/UX_TOUR_V2_UPDATES.md
+docs/development-progress/
+temp_*.py
+temp_*.txt
+
+# Reference documentation (INTERNAL - competitive analysis)
+docs/reference/**
+
+# Internal analysis & automation docs (keep public docs minimal)
+docs/ux_tours/**
+docs/interactive_test/**
+docs/automated_improvements/**
+docs/flow_analysis/**
+docs/test_iterations/**
+docs/ux_optimization/**
+docs/visual_audit/**
+docs/COMPREHENSIVE_*.md
+docs/SESSION_PROGRESS_*.md
+docs/AUTOMATION_*.md
+docs/ITERATION_*.md
+docs/LAYOUT_FIXES_*.md
+docs/*ANALYSIS*.md
+docs/ACTUAL_STATUS_*.md
+docs/COMMUNITY_TEASER_*.md
+docs/ENHANCED_*.md
+
+# Internal architecture docs (competitive implementation details)
+docs/CALORIEDB_*.md
+docs/CALORIE_LEDGER_LINKING.md
+docs/DECENTRALIZED_DATA_ARCHITECTURE.md
+docs/BACKEND_SIGNING_SPEC.md
+docs/FOODREPO_*.md
+docs/WALLET_CONNECT_ROADMAP.md
+docs/XRPL_SAFE_MODE_GUIDE.md
+docs/RESOURCE_USAGE_POLICY.md
+docs/RESPONSIVE_SYSTEM_GUIDE.md
+docs/UI_STYLE_GUIDE.md
+docs/UX_OPTIMIZER_SUMMARY.md
+
+# Internal git/commit helpers
+GIT_COMMIT_GUIDE.md
+COMMIT_QUICK_REFERENCE.md
+COMPREHENSIVE_TODO_LIST.md
+RELEASE_STRATEGY_SUMMARY.md
+SOCIAL_MEDIA_ANNOUNCEMENT_KIT.md
+
+# Test outputs and artifacts
+test_*.py
+test_*.txt
+*_output.txt
+
 # Test artifacts
 .pytest_cache/
 htmlcov/
@@ -186,4 +247,12 @@ coverage.xml
 __pycache__/
 *.pyc
 *.pyo
-*.pyd
+*.pyd
+
+# Internal tooling (whitelist only runnable helpers)
+scripts/**
+!scripts/run.py
+!scripts/run.bat
+!scripts/run.sh
+!build_apk.bat
+!build_apk.sh

CHANGELOG.md

@@ -0,0 +1,140 @@
+## [1.1.1] - 2025-11-18
+
+### Repository Hardening & Public-Safe Docs
+
+#### Added
+- OFFICIAL_PROJECT_DOCS.md: Canonical, public-safe documentation index
+- STATUS_UPDATE_2025-11-18.md: Public snapshot of progress
+
+#### Changed
+- README.md: Removed links to private reference files; added official docs index
+- docs/README.md: Switched to external references; added official docs index
+- .gitignore: Allowlisted public UX tour guides while keeping internal files private
+
+#### Privacy
+- Reaffirmed separation between public documentation and private implementation/testing artifacts
+
+---
+# Changelog
+
+All notable changes to CalorieApp will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.1.0] - 2025-11-18
+
+### 🎉 Official CalorieToken Branding Integration
+
+**Major Update:** This release officially integrates CalorieToken® branding, legal compliance, and trademark protections as we move toward public launch.
+
+### Added
+
+#### Legal & Compliance
+- ✅ **Custom Dual License** - Clarified licensing terms for personal vs. commercial use
+- ✅ **Trademark Guidelines** - Official CalorieToken® trademark usage policies (EUIPO registered)
+- ✅ **Legal Entity Information** - Chamber of Commerce KVK: 84216352 (Netherlands)
+- ✅ **Official Project Links** - Comprehensive links to CalorieToken resources
+
+#### CalorieToken Integration
+- ✅ **Official XRPL Token Details**
+  - Mainnet Issuer: `rNqGa93B8ewQP9mUwpwqA19SApbf62U7PY`
+  - Currency: Calorie ($CAL)
+  - Network: XRP Ledger Mainnet + Testnet support
+- ✅ **Project Reference Documentation** - Complete token specifications
+- ✅ **Community Links** - Twitter, Telegram, Discord, and more
+- ✅ **Trading Platform Integration** - Links to Sologenic, XPMarket, LiveCoinWatch
+
+#### Developer Resources
+- ✅ **GitHub Funding Configuration** - Support development via XRPL
+- ✅ **Enhanced Metadata** - Updated `pyproject.toml` and `setup.py`
+- ✅ **Official Website Badge** - Direct link to calorietoken.net
+
+### Changed
+
+#### Documentation
+- 🔄 **README.md** - Added CalorieToken integration section and corrected license badge
+- 🔄 **LICENSE** - Enhanced with trademark notices and official contact information
+- 🔄 **Project Metadata** - Aligned all package information with CalorieToken branding
+
+#### Branding
+- 🎨 **Badge Updates** - Fixed license badge from MIT to Custom Dual
+- 🎨 **Footer Information** - Added CalorieToken trademark notice
+- 🎨 **Contact Details** - Official info@calorietoken.net throughout
+
+### Security
+- 🔒 **Issuer Verification** - Documented official XRPL issuer address to prevent fake tokens
+- 🔒 **Legal Protection** - Trademark registration information for brand protection
+
+---
+
+## [1.0.0] - 2025-11-01
+
+### 🚀 Initial Public Release (Testnet)
+
+**First official release** of CalorieApp featuring multi-wallet XRPL support and food tracking capabilities.
+
+### Features
+
+#### Wallet Functionality
+- Multi-wallet support on XRPL Testnet
+- 12-word BIP39 mnemonic recovery phrases
+- Secure encrypted wallet storage
+- Real-time balance tracking
+
+#### Transactions
+- XRP send/receive capabilities
+- Custom token support framework
+- Transaction history tracking
+- Multi-server failover (testnet)
+
+#### Additional Features
+- NFT minting interface
+- DEX trading screens
+- Food tracking integration
+- Modern KivyMD 2.0 UI
+
+#### Technical
+- Python 3.12 support
+- KivyMD 2.0 framework
+- Conditional navigation system
+- Responsive design (phone-first)
+
+---
+
+## Release Notes
+
+### Versioning Strategy
+
+We follow [Semantic Versioning](https://semver.org/):
+- **MAJOR** version: Incompatible API changes
+- **MINOR** version: Backwards-compatible functionality additions
+- **PATCH** version: Backwards-compatible bug fixes
+
+### Development Status
+
+**Current Phase:** Beta Development (Testnet)
+
+🚧 **Note:** This application is under active development. Features and functionality are subject to change. Always verify XRPL issuer addresses to avoid fake tokens.
+
+### Trademark Notice
+
+CalorieToken® and "$CAL" are registered trademarks of CalorieToken (KVK: 84216352). See [TRADEMARK.md](docs/TRADEMARK.md) for usage guidelines.
+
+### License
+
+This project uses a **Custom Dual License**:
+- ✅ Personal/Educational use: Permitted
+- ⚠️ Commercial/Public use: Requires written permission
+
+Contact: info@calorietoken.net
+
+---
+
+**For complete version history, see individual release notes in the repository.**
+
+**Official Resources:**
+- 🌐 Website: https://calorietoken.net
+- 📄 Whitepaper: https://calorietoken.net/index.php/whitepaper/
+- 🐦 Twitter: [@CalorieToken](https://twitter.com/CalorieToken)
+- 💬 Telegram: [Community](https://t.me/joinchat/8jIusxwzMVI0NGVk)

LICENSE

@@ -1,6 +1,16 @@
-CUSTOM (dual) License (!)
+CalorieAppTestnet - CUSTOM DUAL LICENSE
 
-Copyright (c) 2023 CalorieToken / Chamber of Commerce KVK: 84216352
+Copyright (c) 2023-2025 CalorieToken
+Chamber of Commerce (KVK): 84216352
+Website: https://calorietoken.net
+Email: info@calorietoken.net
+
+CalorieToken® is a registered trademark (EUIPO) of CalorieToken.
+Unauthorized use of the CalorieToken name, logo, or branding is prohibited.
+
+================================================================================
+LICENSE TERMS
+================================================================================
 
 > If in doubt about / questions regarding CalorieToken licenses: please contact CalorieToken : info@calorietoken.net
 
@@ -29,3 +39,40 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+================================================================================
+TRADEMARK NOTICE
+================================================================================
+
+"CalorieToken," the CalorieToken logo, "$CAL," and related branding are 
+trademarks owned by CalorieToken (KVK: 84216352), registered with the 
+European Union Intellectual Property Office (EUIPO).
+
+Permitted Use:
+- Technical documentation and integration guides
+- Stating compatibility with CalorieToken services
+- Educational and research purposes
+
+Prohibited Without Permission:
+- Using "CalorieToken" in product/service names
+- Reproducing logos for commercial purposes
+- Implying official endorsement or partnership
+
+For trademark usage permissions, contact: info@calorietoken.net
+
+================================================================================
+OFFICIAL PROJECT LINKS
+================================================================================
+
+Website:       https://calorietoken.net
+GitHub:        https://github.com/CalorieToken/CalorieAppTestnet
+Whitepaper:    https://calorietoken.net/index.php/whitepaper/
+Twitter/X:     https://twitter.com/CalorieToken
+Telegram:      https://t.me/joinchat/8jIusxwzMVI0NGVk
+Discord:       https://discord.gg/hcjJgdyDGd
+
+XRPL Token Details:
+Currency:      Calorie
+Issuer:        rNqGa93B8ewQP9mUwpwqA19SApbf62U7PY
+Network:       XRP Ledger Mainnet
+