feat: Universal App Builder Phase 1 implementation

Core Features:
- Project management system (create, list, export)
- Template engine with variable substitution
- Dependency manager with venv isolation
- 3 production templates (blank_kivy, material_kivymd, crypto_wallet)

Templates:
- Blank Kivy: Minimal starter with extensive Copilot comments
- Material KivyMD: Navigation drawer + bottom nav + 3 screens
- Crypto Wallet: XRPL-like wallet with balance/send/history

Copilot Integration:
- 70+ categorized prompts in prompt library
- COPILOT_GUIDE.md per template
- .copilot/instructions.md for workspace context
- Strategic inline comments throughout code

GUI:
- KivyMD wizard for project creation
- Template selector dialog
- Progress tracking with callbacks
- Export/import functionality

Testing:
- Test harness for validating project creation
- Validates file structure and variable substitution

Documentation:
- Comprehensive README with quick start
- Template usage guides
- CLI and GUI usage examples

Next: Phase 2 - Enhanced Copilot integration (2 weeks)

Author: CalorieApp Maintainer

universal_app_builder/README.md

@@ -1,56 +1,298 @@
-# Universal App Builder (Reconstructed)
-
-This directory is a **reconstruction scaffold** for the former Universal App Builder (UAB) specifications. All original implementation source files were removed earlier and were never committed to version control, so they cannot be restored via git.
-
-## Current Status
-- Implementation: **Missing** (no builder/ modules, no code generation)
-- Test suite: Placeholder only (adjusted to report missing implementation)
-- Documentation: Being rebuilt from memory/spec outlines
-- Purpose: Preserve intent; enable phased future rebuild if desired
-
-## What Was Lost (High-Level Intent)
-- Feature DSL parser & generators
-- Multi-platform profile-driven project scaffolder
-- Self-modification safety utilities (syntax, security, sandbox, rollback)
-- Decentralized integration stubs (IPFS, BigchainDB, DID)
-- Hosting/provider plugin interfaces
-
-## What Exists Now
-- `__init__.py` (stub)
-- `test_self_modification.py` (relocated; emits missing implementation notice)
-- `docs/` placeholders:
-  - `INDEX.md`
-  - `ARCHITECTURE.md`
-  - `FEATURE_DSL_SPEC.md`
-  - `ETHICAL_USAGE.md`
-  - `TESTING_SELF_MODIFICATION.md`
-  - `RECOVERY_PLAN.md`
-
-## Recovery Principles
-1. **Truthful State** – We start from zero implementation.
-2. **Phased Rebuild** – Define minimal viable core before advanced features.
-3. **Isolation** – Keep UAB separate from CalorieApp to avoid coupling.
-4. **Safety First** – Re‑implement test harness before allowing code mutation.
-5. **Auditability** – Every recovered module must include rationale & provenance notes.
-
-## Suggested Rebuild Phases (See `RECOVERY_PLAN.md` for detail)
-1. Core package skeleton & config loader
-2. Profile schema & validation
-3. Feature DSL minimal grammar (components + layout)
-4. Single-platform generator (Kivy) MVP
-5. Safety harness (syntax + rollback)
-6. DSL expansion (styling, navigation, data bindings)
-7. Multi-platform adapters (CLI placeholder)
-8. Optional decentralized integrations (deferred)
-
-## Important Disclaimer
-This reconstructed directory does **not** represent working software. It is an organized placeholder to prevent further confusion, document intended architecture, and enable an intentional rebuild if prioritized.
-
-## Next Decisions
-Please indicate:
-- Proceed with Phase 1 rebuild? (Yes/No)
-- Link this directory from root `README.md`? (Default: No until implementation begins)
-- Prioritize which advanced areas (DSL vs Safety vs Hosting) after MVP?
-
----
-*Reconstruction version:* `0.0.0-recovery`
+# Universal App Builder
+
+**Version:** 1.0.0-alpha  
+**Target Audience:** GitHub Copilot subscribers  
+**Author:** ICTHendrikse
+
+---
+
+## 🚀 Overview
+
+Universal App Builder is a project scaffolding tool designed specifically for developers with GitHub Copilot subscriptions. It provides:
+
+- **Pre-built Templates** - Professional Kivy/KivyMD project starters
+- **Copilot Integration** - Strategic comments and prompts throughout code
+- **Prompt Library** - 70+ categorized prompts for common development tasks
+- **Build Automation** - Buildozer configuration for Android APK generation
+- **GUI Wizard** - Visual interface for project creation
+
+**Create a production-ready Kivy project in under 2 minutes!**
+
+---
+
+## 📋 Features
+
+### ✅ Phase 1 Complete (Current)
+
+- ✅ **3 Professional Templates**
+  - Blank Kivy App (minimal starter)
+  - Material KivyMD App (navigation + Material Design)
+  - Crypto Wallet Starter (XRPL-like blockchain app)
+
+- ✅ **Project Management Core**
+  - Create, list, export projects
+  - JSON profile storage
+  - Template rendering with variable substitution
+  - Virtual environment per project
+
+- ✅ **Copilot Optimization**
+  - Strategic comments throughout templates
+  - Dedicated COPILOT_GUIDE.md per template
+  - .copilot/instructions.md workspace context
+  - 70+ categorized prompts in library
+
+- ✅ **GUI Application**
+  - KivyMD-based wizard interface
+  - Template selection dialog
+  - Progress tracking during creation
+  - Project listing and export
+
+### 🔮 Future Phases
+
+- **Phase 2:** Enhanced Copilot integration (2 weeks)
+- **Phase 3:** Build automation (APK/EXE generation) (2 weeks)
+- **Phase 4:** GUI polish + UX refinements (2 weeks)
+- **Phase 5:** Testing + public launch (2 weeks)
+
+---
+
+## 🎯 Quick Start
+
+### Prerequisites
+
+- **Python 3.12+**
+- **GitHub Copilot subscription** (essential for AI assistance)
+- **Git** (for version control)
+- **VS Code** (recommended editor)
+
+### Installation
+
+1. **Clone this repository:**
+   ```powershell
+   git clone https://github.com/XRPietBanks/CalorieAppTestnet.git
+   cd CalorieAppTestnet
+   git checkout feature/universal-app-builder
+   ```
+
+2. **Install dependencies:**
+   ```powershell
+   pip install kivy==2.3.0
+   pip install "kivymd @ git+https://github.com/kivymd/KivyMD.git@master"
+   ```
+
+3. **Launch the GUI:**
+   ```powershell
+   cd universal_app_builder/gui
+   python app.py
+   ```
+
+### Using the GUI
+
+1. **Create New Project** → Select template → Enter project details
+2. **View Projects** → See all created projects
+3. **Export Project** → Package project as ZIP for sharing
+
+---
+
+## 📁 Project Structure
+
+```
+universal_app_builder/
+├── core/                     # Core modules
+│   ├── project_manager.py    # CRUD for projects
+│   ├── template_engine.py    # Template rendering
+│   ├── dependency_manager.py # Virtual env + pip
+│   └── project_schema.py     # TypedDict schemas
+│
+├── templates/                # Project templates
+│   ├── blank_kivy/           # Minimal Kivy starter
+│   ├── material_kivymd/      # Material Design app
+│   └── crypto_wallet/        # Blockchain wallet starter
+│
+├── prompt_library/           # Copilot prompt collection
+│   └── prompts.md            # 70+ categorized prompts
+│
+├── gui/                      # GUI application
+│   └── app.py                # KivyMD wizard interface
+│
+├── tests/                    # Test harness
+│   └── test_project_creation.py
+│
+└── projects/                 # Your created projects appear here
+```
+
+---
+
+## 🎨 Available Templates
+
+### 1. Blank Kivy App
+
+**Best for:** Learning Kivy fundamentals, simple utilities
+
+**Features:**
+- Clean BoxLayout structure
+- Basic input/output widgets
+- Extensive Copilot prompt comments
+- Buildozer configuration
+
+**Use Cases:** Simple calculators, note-taking apps, personal utilities, learning projects
+
+---
+
+### 2. Material KivyMD App
+
+**Best for:** Professional apps with navigation and Material Design
+
+**Features:**
+- Navigation Drawer + Bottom Navigation
+- 3 example screens (Home, Settings, Profile)
+- Theme switching stub
+- Dialogs and forms
+
+**Use Cases:** Productivity apps, social platforms, e-commerce apps, dashboard applications
+
+---
+
+### 3. Crypto Wallet Starter
+
+**Best for:** Blockchain/cryptocurrency applications
+
+**Features:**
+- Mnemonic generation placeholder
+- Balance/Send/History screens
+- Transaction building stubs
+- XRPL-like architecture
+
+**Use Cases:** Cryptocurrency wallets, token management apps, blockchain explorers, DeFi interfaces
+
+---
+
+## 💡 Using the Prompt Library
+
+The prompt library contains **70+ categorized prompts** for rapid development with Copilot.
+
+### Access the Library
+
+**GUI:** Menu → Prompt Library (opens in browser)  
+**Manual:** `universal_app_builder/prompt_library/prompts.md`
+
+### Categories
+
+1. UI Components & Layouts (10 prompts)
+2. Navigation & Screens (8 prompts)
+3. Data Persistence (7 prompts)
+4. Networking & APIs (8 prompts)
+5. Android Integration (8 prompts)
+6. Forms & Validation (7 prompts)
+7. Performance Optimization (6 prompts)
+8. Testing & Debugging (6 prompts)
+9. Security & Encryption (5 prompts)
+10. Build & Deployment (5 prompts)
+
+### Example Usage
+
+1. Open your project in VS Code
+2. Copy a prompt from the library (e.g., `# Add MDDataTable with sortable columns`)
+3. Paste as a comment in your code
+4. Wait for Copilot suggestion (or press `Alt+\`)
+5. Review and accept with `Tab`
+
+---
+
+## 🛠️ Command-Line Usage
+
+For advanced users who prefer CLI over GUI:
+
+```python
+from universal_app_builder.core.project_manager import ProjectManager
+
+# Initialize
+pm = ProjectManager("./my_projects")
+
+# Create project
+project_path = pm.create_project(
+    name="MyApp",
+    template_name="blank_kivy",
+    variables={
+        "app_name": "My Awesome App",
+        "project_name": "myawesomeapp",
+        "author": "Your Name",
+        "description": "My first Kivy app",
+        "package_name": "com.yourname.myawesomeapp",
+    }
+)
+
+print(f"Project created: {project_path}")
+```
+
+---
+
+## 🧪 Testing
+
+Run the test harness to validate template creation:
+
+```powershell
+cd universal_app_builder/tests
+python test_project_creation.py
+```
+
+---
+
+## 📦 Building for Android
+
+Each template includes `buildozer.spec` for APK generation.
+
+```powershell
+cd projects/YourProjectName
+buildozer android debug
+```
+
+APK location: `bin/yourprojectname-0.1-arm64-v8a-debug.apk`
+
+**Note:** First build downloads Android SDK/NDK (~2GB). Be patient!
+
+---
+
+## 📄 License
+
+© 2025 ICTHendrikse - All rights reserved
+
+**Note:** This tool is for GitHub Copilot subscribers. You must have an active Copilot subscription to benefit from the AI integration features.
+
+---
+
+## 🔗 Resources
+
+- **Kivy Documentation:** https://kivy.org/doc/stable/
+- **KivyMD Documentation:** https://kivymd.readthedocs.io/
+- **GitHub Copilot:** https://github.com/features/copilot
+- **Buildozer:** https://buildozer.readthedocs.io/
+
+---
+
+## ❓ FAQ
+
+**Q: Do I need a Copilot subscription?**  
+A: Yes! This tool is designed specifically for Copilot users.
+
+**Q: Can I use this without the GUI?**  
+A: Yes! See the "Command-Line Usage" section above.
+
+**Q: Is this free?**  
+A: Phase 1 (current) is free during alpha testing. Future pricing: €29/year subscription (planned).
+
+---
+
+## 🗺️ Roadmap
+
+- **Phase 1:** Core (✅ Complete)
+- **Phase 2:** Copilot Integration (Next - 2 weeks)
+- **Phase 3:** Build Automation (4 weeks)
+- **Phase 4:** GUI Polish (6 weeks)
+- **Phase 5:** Launch (8 weeks)
+
+---
+
+**Built with ❤️ for the Kivy and GitHub Copilot communities**
+
+*Universal App Builder - Empowering Developers Since 2025*

universal_app_builder/core/__init__.py

@@ -0,0 +1,20 @@
+"""Universal App Builder - Core Module
+
+Provides project management, templating, and build automation
+for Kivy/KivyMD applications.
+
+Designed for developers with GitHub Copilot subscriptions.
+"""
+
+__version__ = "0.1.0-alpha"
+__author__ = "ICTHendrikse (Pieter Hendrikse Jr.)"
+
+from .project_manager import ProjectManager
+from .template_engine import TemplateEngine
+from .dependency_manager import DependencyManager
+
+__all__ = [
+    'ProjectManager',
+    'TemplateEngine', 
+    'DependencyManager',
+]