@kosmas10/portal 0.0.4 → 0.0.6

package/README.md

@@ -1,44 +1,40 @@
 # Portal
 
-**Version:** 0.0.4  
+**Version:** 0.0.5  
 **Package:** `@kosmas10/portal`
 
-A launcher portal for AI Chat Extensions applications. Provides a unified entry point to access Chat & Verify, Folder LLM Analyzer, and other AI-powered tools.
+A launcher portal for AI Chat Extensions applications. Provides a unified entry point to access Chat & Verify, Folder LLM Analyzer, and other AI-powered tools. Built with React and bundled for maximum reliability.
 
 ## 🎯 Key Features
 
 - **🚀 Unified Launcher**: Single entry point for all AI Chat Extensions apps
 - **📱 Responsive Design**: Works on desktop and mobile devices
-- **⚡ Fast Loading**: 3-stage architecture for reliable, efficient loading
+- **⚡ Fast Loading**: 2-stage architecture for reliable, efficient loading
 - **🔄 Auto-Updates**: Always loads the latest version of apps
 - **💻 No Installation Required**: Single HTML file that runs in any modern browser
+- **⚛️ Built with React**: Modern component-based architecture
 
-## 🏗️ Architecture: 3-Stage Loading System
+## 🏗️ Architecture: 2-Stage Loading System
 
-This application uses an innovative **3-stage loading architecture** designed for maximum reliability and flexibility:
+This application uses a **simplified 2-stage loading architecture** with bundled React:
 
 ### Stage 1: Bootstrap (User Installs This)
 - **File**: `portal-bootstrap.html`
-- **Purpose**: Ultra-minimal loader that NEVER changes
-- **Size**: ~2KB
-- **What it does**: Loads Stage 2 from npm/CDN
+- **Purpose**: Ultra-minimal loader (~25 lines)
+- **Size**: ~1KB
+- **What it does**: Fetches version from package.json and loads the bundled app
 
-### Stage 2: Loader (Auto-Updates)
-- **Package**: `@kosmas10/html-app-loader`
-- **Purpose**: Sophisticated HTML app loader
-- **What it does**: Handles complex loading logic, can be updated via npm
-
-### Stage 3: Application (Auto-Updates)
+### Stage 2: Bundled React Application (Auto-Updates)
+- **File**: `dist/portal.html`
 - **Package**: `@kosmas10/portal` (this package)
-- **Purpose**: The actual Portal application
-- **What it does**: Provides the launcher interface
+- **What it does**: Self-contained React app with all dependencies bundled
 
 ### Why This Architecture?
 
-1. **🛡️ Future-Proof**: Stage 1 never changes, so users never need to update their local file
-2. **🔄 Auto-Updates**: Stages 2 & 3 update automatically via npm/CDN
-3. **🐛 Bug Fixes**: Loader bugs can be fixed without user intervention
-4. **📦 Flexible**: Can adapt to new requirements without breaking existing installations
+1. **🛡️ Future-Proof**: Stage 1 is simple and never needs to change
+2. **🔄 Auto-Updates**: Stage 2 updates automatically via npm/CDN
+3. **📦 Zero External Dependencies**: All code bundled in single HTML file
+4. **🐛 Reliable**: No CDN dependency issues or script loading failures
 
 ## 🚀 Quick Start
 
@@ -62,13 +58,6 @@ Simply navigate to:
 https://cdn.jsdelivr.net/npm/@kosmas10/portal@latest/portal-bootstrap.html
 ```
 
-### Option C: Load Specific Version
-
-Use URL parameters to control versions:
-```
-https://cdn.jsdelivr.net/npm/@kosmas10/portal@latest/portal-bootstrap.html?appVersion=0.0.1
-```
-
 ## 📖 Available Applications
 
 The Portal provides access to:
@@ -79,35 +68,41 @@ A chatbot with citations and highlights in source documents for easy verificatio
 ### Folder LLM Analyzer
 Analyze entire folders of files using Large Language Models. Upload a folder, ask questions, and get AI-powered insights.
 
-## 🔧 Advanced Configuration
-
-### URL Parameters
-
-Control the loading behavior with URL parameters:
+## 📦 Package Structure
 
 ```
-?loader=@kosmas10/html-app-loader          # Use different Stage 2 loader
-?loaderVersion=1.0.0                        # Pin Stage 2 version
-?app=@kosmas10/portal                       # Load different app
-?appVersion=0.0.1                           # Pin app version
-?appFile=portal.html                        # Load specific file
+@kosmas10/portal/
+├── dist/
+│   └── portal.html           # Bundled React application
+├── portal-bootstrap.html     # Bootstrap loader (Stage 1)
+├── README.md                 # This file
+└── LICENSE                   # MIT License
 ```
 
-### Example: Pin All Versions
-```
-portal-bootstrap.html?loaderVersion=1.0.0&appVersion=0.0.1
-```
+## 🛠️ Development
 
-## 📦 Package Structure
+### Prerequisites
+- Node.js 18+
+- npm
 
+### Setup
+```bash
+cd portal
+npm install
 ```
-@kosmas10/portal/
-├── portal.html              # Main application (Stage 3)
-├── portal-bootstrap.html    # Bootstrap loader (Stage 1)
-├── README.md                # This file
-└── LICENSE                  # MIT License
+
+### Development Server
+```bash
+npm run dev
 ```
 
+### Build
+```bash
+npm run build
+```
+
+This produces `dist/portal.html` - a single self-contained HTML file.
+
 ## 🌐 Browser Compatibility
 
 - ✅ Chrome/Chromium 90+
@@ -132,17 +127,20 @@ portal-bootstrap.html?loaderVersion=1.0.0&appVersion=0.0.1
 
 ## 📝 Version History
 
-### 0.0.4 (Current)
+### 0.0.5 (Current)
+- **Migrated to bundled React architecture**: Complete rewrite using React + TypeScript + Tailwind
+- **Simplified 2-stage loading**: Bootstrap loads bundled app directly
+- **Zero external dependencies**: All code bundled in single HTML file
+- **Improved reliability**: No CDN script loading issues
+
+### 0.0.4
 - Removed all non-error console output to prevent console popups during normal operation
 - Cleaner console output - only shows errors when something goes wrong
 - Bootstrap file updated with cleaner code structure and version resolution
 
 ### 0.0.3
-- **Improved @latest handling**: Resolves `@latest` to specific version numbers by fetching package.json first
-- Avoids CDN cache issues by using specific version numbers instead of `@latest` tag
-- Fetches version from `package.json` with cache buster to ensure fresh data
-- Version caching to avoid multiple fetches for the same package
-- Falls back to `@latest` if version fetch fails for backward compatibility
+- Improved @latest handling: Resolves `@latest` to specific version numbers
+- Version caching to avoid multiple fetches
 
 ### 0.0.2
 - Bug fixes and improvements
@@ -150,7 +148,6 @@ portal-bootstrap.html?loaderVersion=1.0.0&appVersion=0.0.1
 ### 0.0.1
 - Initial release
 - Launcher interface for AI Chat Extensions apps
-- 3-stage loading architecture
 
 ## 🤝 Contributing
 
@@ -169,7 +166,6 @@ For issues, questions, or feature requests:
 
 ## 🔗 Related Packages
 
-- **Stage 2 Loader**: [@kosmas10/html-app-loader](https://www.npmjs.com/package/@kosmas10/html-app-loader)
 - **Chat & Verify**: [@kosmas10/chat-and-verify](https://www.npmjs.com/package/@kosmas10/chat-and-verify)
 - **Folder LLM Analyzer**: [@kosmas10/folder-llm-analyzer](https://www.npmjs.com/package/@kosmas10/folder-llm-analyzer)