viewlogic 1.1.2 → 1.2.0

package/README.md

@@ -1,4 +1,4 @@
-# ViewLogic Router v1.1.1
+# ViewLogic Router
 
 <p align="center">
   <a href="https://github.com/hopegiver/viewlogic">
@@ -14,14 +14,6 @@
 
 > A revolutionary Vue 3 routing system with View-Logic separation and Zero Build Development
 
-## 🆕 Latest Updates (v1.1.1)
-
-- ✨ **Automatic Form Handling** - Revolutionary form submission with `{paramName}` variable parameters
-- 🔄 **Multiple API Support** - Parallel data fetching from multiple APIs with named data storage
-- 🛡️ **Enhanced Validation** - HTML5 + custom function validation with graceful error handling
-- 🚀 **Component Loading Resilience** - Router continues to work even if components fail to load
-- 📝 **Comprehensive Documentation** - Extensive real-world examples and usage patterns
-
 ## 🎯 Core Philosophy: Simplicity Through Design
 
 ViewLogic Router revolutionizes Vue development with two fundamental core principles:
@@ -260,6 +252,75 @@ const config = {
 };
 ```
 
+### 🏗️ Subfolder Deployment Support
+
+ViewLogic Router supports deployment in subfolders with smart path resolution:
+
+```javascript
+// Root deployment: https://example.com/
+ViewLogicRouter({
+    basePath: '/src',           // → https://example.com/src
+    routesPath: '/routes',      // → https://example.com/routes
+    i18nPath: '/i18n'          // → https://example.com/i18n
+});
+
+// Subfolder deployment: https://example.com/myapp/
+ViewLogicRouter({
+    basePath: 'src',            // → https://example.com/myapp/src (relative)
+    routesPath: 'routes',       // → https://example.com/myapp/routes (relative)
+    i18nPath: 'i18n',          // → https://example.com/myapp/i18n (relative)
+});
+
+// Mixed paths: https://example.com/projects/myapp/
+ViewLogicRouter({
+    basePath: './src',          // → https://example.com/projects/myapp/src
+    routesPath: '../shared/routes', // → https://example.com/projects/shared/routes  
+    i18nPath: '/global/i18n'    // → https://example.com/global/i18n (absolute)
+});
+```
+
+**Path Resolution Rules:**
+- **Absolute paths** (`/path`) → `https://domain.com/path`
+- **Relative paths** (`path`, `./path`) → Resolved from current page location
+- **Parent paths** (`../path`) → Navigate up directory levels
+- **HTTP URLs** → Used as-is (no processing)
+
+### 🔄 Hash vs History Mode in Subfolders
+
+Both routing modes work seamlessly in subfolder deployments:
+
+```javascript
+// Hash Mode (recommended for subfolders)
+// URL: https://example.com/myapp/#/products?id=123
+ViewLogicRouter({ 
+    mode: 'hash'           // Works anywhere, no server config needed
+});
+
+// History Mode (requires server configuration)
+// URL: https://example.com/myapp/products?id=123  
+ViewLogicRouter({ 
+    mode: 'history'        // Cleaner URLs, needs server setup
+});
+```
+
+**History Mode Server Configuration:**
+```nginx
+# Nginx - redirect all subfolder requests to index.html
+location /myapp/ {
+    try_files $uri $uri/ /myapp/index.html;
+}
+```
+
+```apache
+# Apache .htaccess in /myapp/ folder
+RewriteEngine On
+RewriteBase /myapp/
+RewriteRule ^index\.html$ - [L]
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteRule . /myapp/index.html [L]
+```
+
 ## 📖 Complete API Documentation
 
 For comprehensive API documentation including all methods, configuration options, and detailed examples, see: