feature/framework (#1)

Reviewed-on: #1

README.md

@@ -31,7 +31,13 @@ spore-ui/
 ├── public/                 # Frontend files
 │   ├── index.html         # Main HTML page
 │   ├── styles.css         # All CSS styles
-│   ├── script.js          # All JavaScript functionality
+│   ├── framework.js       # Enhanced component framework with state preservation
+│   ├── components.js      # UI components with partial update support
+│   ├── view-models.js     # Data models with UI state management
+│   ├── app.js             # Main application logic
+│   └── test-state-preservation.html  # Test interface for state preservation
+├── docs/
+│   └── STATE_PRESERVATION.md  # Detailed documentation of state preservation system
 └── README.md              # This file
 ```
 
@@ -40,6 +46,7 @@ spore-ui/
 1. **Install dependencies**: `npm install`
 2. **Start the server**: `npm start`
 3. **Open in browser**: `http://localhost:3001`
+4. **Test state preservation**: `http://localhost:3001/test-state-preservation.html`
 
 ## API Endpoints
 
@@ -53,6 +60,7 @@ spore-ui/
 
 - **Backend**: Express.js, Node.js
 - **Frontend**: Vanilla JavaScript, CSS3, HTML5
+- **Framework**: Custom component-based architecture with state preservation
 - **API**: SPORE Embedded System API
 - **Design**: Glassmorphism, CSS Grid, Flexbox