deployment

README.md

@@ -57,12 +57,12 @@ A modern Blender addon that generates image textures from text with extensive cu
 
 - **Preset Management System**:
 
-  - Three-tier storage: Blend File, Persistent, Local presets
-  - All preset types now display properly in the interface
-  - Presets travel with .blend files (Blend File type)
+  - Simplified two-tier storage: Persistent File (default) + Blend File (optional)
+  - Unified preset list with clear storage indicators (🏠/📄)
+  - Presets travel with .blend files when "Save with .blend file" is checked
   - Import/export functionality for backup and sharing
-  - Automatic migration system for addon updates
-  - Conflict resolution for preset imports
+  - Automatic migration from legacy three-tier system
+  - Conflict resolution with blend file presets taking priority
 
 - **Preview System**:
 
@@ -254,33 +254,39 @@ The addon automatically installs required dependencies:
 
 ## Preset System
 
-The addon features a sophisticated three-tier preset system:
+The addon features a streamlined two-tier preset system designed for simplicity and reliability:
 
 ### Storage Locations (Priority Order)
 
-1. **Blend File Storage** (Highest Priority)
+1. **Blend File Storage** (Higher Priority)
 
    - Presets stored in scene custom properties
-   - Travel with your .blend file
+   - Travel with your .blend file automatically
    - Perfect for project-specific presets
+   - Display with 📄 indicator in UI
 
-2. **Persistent File Storage** (Medium Priority)
+2. **Persistent File Storage** (Default Storage)
 
    - Survives addon updates and Blender upgrades
-   - Stored in Blender's user config directory
+   - Stored in Blender's user config directory (`~/.config/blender/text_texture_generator/presets/`)
    - Shared across all blend files
+   - Display with 🏠 indicator in UI
 
-3. **Local File Storage** (Lowest Priority)
-   - Local addon-specific presets
-   - Automatically migrated to persistent storage when needed
+### Key Features
 
-### Preset Features
-
-- **Improved UI Display**: Recent bug fix ensures all three preset types (Blend File, Persistent, Local) display properly in the interface
-- **Auto-Migration**: Seamlessly upgrades presets during addon updates
+- **Simplified UI**: Single unified preset list with clear storage indicators
+- **Easy Storage Selection**: Simple "Save with .blend file" checkbox controls destination
+- **Priority System**: Blend file presets automatically override persistent ones with same name
+- **Auto-Migration**: Seamlessly migrates old three-tier presets to new system
 - **Import/Export**: Backup and share presets across installations
-- **Conflict Resolution**: Smart handling of duplicate preset names
-- **Migration Reports**: Detailed logs of preset migration operations
+- **User-Friendly Messages**: Clear, non-technical confirmation messages
+
+### How to Use
+
+- **Default Behavior**: Presets save to persistent storage (🏠) - survives addon updates
+- **Project-Specific**: Check "Save with .blend file" to save with your project (📄)
+- **Loading**: All presets appear in one list, blend file presets take priority
+- **Migration**: Old presets are automatically migrated on first use
 
 ## Build System
 
@@ -393,7 +399,7 @@ Marc Mintel <marc@mintel.me>
 - Normal map generation from text alpha channels with strength/blur controls
 - Advanced shader generation with Principled BSDF, Emission, and Transparent types
 - Light path controls for shadows, reflections, and backfacing geometry
-- Three-tier preset system (blend file → persistent → legacy) with auto-migration
+- Simplified two-tier preset system (persistent + blend file) with priority handling
 - Live preview with zoomable Image Editor integration and multiple backgrounds
 - Prepend/append text support with horizontal/vertical layouts
 - Custom font support with mixed-case validation and fallback systems
@@ -416,7 +422,7 @@ Marc Mintel <marc@mintel.me>
 #### Full Version Features (Additional):
 
 - Normal map generation from text alpha channels
-- Complete preset management system with import/export
+- Complete preset management system with simplified two-tier storage
 - Advanced utility operations and batch processing
 - Extended UI components and advanced styling options
 - **File Count**: 23 files (60.1 KB package size)
@@ -433,6 +439,6 @@ Marc Mintel <marc@mintel.me>
 - `core/normal_maps.py` - Normal map generation algorithms
 - `operators/preset_ops.py` - Preset management operations
 - `operators/utility_ops.py` - Batch processing and utility functions
-- `presets/` - Entire preset storage and migration system
+- `presets/` - Entire simplified preset storage and migration system
 
 This approach ensures the free version provides genuine value while the full version offers substantially more capabilities through additional source code modules.