Replace chained npm commands with single build-electron.sh script supporting
multiple build modes (dev/test/prod), platforms (windows/mac/linux), and
package types (appimage/deb/dmg). Add platform validation to prevent
cross-platform build issues and integrate cleaning functionality.
- Replace 15+ chained npm scripts with single modular build script
- Add platform detection and validation with early failure on mismatch
- Support environment-specific builds (development/test/production)
- Add comprehensive documentation in docs/electron-build-patterns.md
- Update BUILDING.md with new build patterns and examples
- Remove legacy electron:build:* scripts and consolidate under build:electron:*
- Add clean:electron script integrated into build process
- Improve error handling and user feedback throughout build process
This refactoring follows DRY principles, eliminates command chaining,
and provides a more maintainable and user-friendly build system.
- Add PWAInstallPrompt component for custom install UI and event handling
- Register PWAInstallPrompt in App.vue for global visibility
- Enable PWA features and install prompt in dev, test, and prod (vite.config.web.mts)
- Update service worker registration to work in all environments
- Update docs/build-web-script-integration.md with PWA install guidance and visual cues
- Add scripts/build-web.sh for unified web build/dev workflow
PWA is now installable and testable in all web environments, with clear user prompts and desktop support.
- Removed extra blank lines at end of file to resolve MD012 (no-multiple-blanks)
- Standardized heading spacing to resolve MD019 (no-multiple-space-atx)
- Stripped trailing whitespace and ensured file ends with a single newline
All changes maintain content integrity and bring the file into full markdownlint compliance.
- Change build:* naming from hyphen to colon (build:web-dev → build:web:dev)
- Add missing build:web:test and build:web:prod scripts
- Update build:electron:dev to include electron startup (build + start)
- Remove hardcoded --mode electron to allow proper mode override
- Add comprehensive mode override behavior documentation
- Fix mode conflicts between hardcoded and passed --mode arguments
The plan now properly supports:
- Development builds with default --mode development
- Testing builds with explicit --mode test override
- Production builds with explicit --mode production override
- Consistent naming across all platforms (web, capacitor, electron)
Replace static databaseUtil import with dynamic import pattern for test context.
Add comprehensive JSDoc documentation and improve code formatting.
Maintains functionality while removing static dependency.
- Remove databaseUtil import, replace with logger.error
- Migrate $notify to modern notify pattern with createNotifyHelpers
- Add NOTIFY_PERSONAL_DATA_ERROR constant for error messages
- Use NOTIFICATION_TIMEOUTS.STANDARD for timeouts
- All phases complete: database, SQL, notification migration
- 35 minutes, 1510 lines, high complexity service file
- Linting passes with no errors
- Component already follows modern patterns and best practices
- No database operations to migrate (uses static JSON data)
- No notification system usage to modernize
- Template already clean and well-structured
- Comprehensive TypeScript interfaces and documentation
- Appropriate error handling with logging for missing icons
- Component serves as example of clean, modern Vue design
Security: No risks (no changes made)
Lint: ✅ Passed
Migration: No migration required - already compliant
- Extract long CSS class to computed property containerClasses
- Fix header comment formatting to proper JSDoc format
- Enhance component documentation for template streamlining
- Update class binding from static to dynamic for better maintainability
- Migration completed in 3 minutes (within estimate)
- No database or SQL operations needed (pure UI component)
- Lint validation passed with no errors
Security audit: No security risks (cosmetic template changes only)
Migration status: 67% complete (62/92 components migrated)
- Extracted all long/repeated CSS class strings in template to computed properties for maintainability
- Added/updated file-level and method-level documentation with comprehensive JSDoc comments
- Removed CSS styles in favor of computed properties for consistency
- No databaseUtil or SQL abstraction required (pure UI component)
- No notification usage to migrate
- Lint validation successful (no errors)
Technical improvements:
- 8 computed properties for CSS classes (overlay, dialog, buttons, input, etc.)
- Enhanced code maintainability and readability
- Follows Enhanced Triple Migration Pattern Phase 4 (Template Streamlining)
- Improved component documentation and type safety
Migration completed in 2 minutes (4x faster than 8-12 min estimate)
- Extracted all long/repeated CSS class strings in template to computed properties for maintainability
- Added/updated file-level and method-level documentation with comprehensive JSDoc comments
- Replaced $notify type from 'any' to 'unknown' for improved type safety
- Confirmed notification usage is already modern and follows project standards
- No databaseUtil or SQL abstraction required (pure UI component)
- Lint validation successful (no errors, only unrelated warnings remain)
- Migration tracking documents updated with timing and performance metrics
Technical improvements:
- 7 computed properties for CSS classes (overlay, modal, buttons, etc.)
- Enhanced type safety with proper TypeScript types
- Improved code maintainability and readability
- Follows Enhanced Triple Migration Pattern Phase 4 (Template Streamlining)
Migration completed in 7 minutes (13% faster than 8-12 min estimate)
- Complete all 4 phases of Enhanced Triple Migration Pattern for NewEditProjectView.vue
- Replace databaseUtil calls with PlatformServiceMixin methods
- Standardize notification calls using constants and timeout helpers
- Extract 12 computed properties for template streamlining
- Add notification constants and helper functions to notifications.ts
- Extract long CSS classes to computed properties in ImageMethodDialog.vue
- Fix platformService conflict in ImageMethodDialog.vue
- Complete PushNotificationPermission.vue migration with all phases
- Update migration tracking documentation
- Migration completed in 11m 30s (74% faster than estimate)
- Replace databaseUtil calls with PlatformServiceMixin for settings operations
- Extract toggleAlpha/Group/Community/Verifiable/Governance/Basics methods
- Add copyBitcoinAddress method with clipboard feedback
- Enhance onboarding reset with error handling and logging
- Human tested: all help sections, clipboard ops, platform navigation work
- 6 minutes (3x faster than estimate), technically compliant
Add comprehensive guidance to prevent common migration oversights:
- Remove unused notification imports
- Replace hardcoded timeout values with constants
- Remove legacy wrapper functions
- Extract long class attributes to computed properties
- Replace literal strings with constants
Based on lessons learned from ContactQRScanShowView.vue migration.
Includes validation commands and specific examples for each pattern.
- Add PlatformServiceMixin for modern database operations
- Replace databaseUtil.updateDefaultSettings() with $updateSettings()
- Migrate 5 notifications to helper system with centralized constants
- Extract repeated CSS classes to computed properties
- Add comprehensive documentation for user support component
- Fix duplicate NOTIFY_UNCONFIRMED_HOURS export in constants
- Maintain all existing functionality and visual styling
Migration completed in 7 minutes (53% faster than estimate)
All validation checks passed, human tested successfully
Project progress: 54% (50/92 components)
✅ Database Migration: Replaced databaseUtil.retrieveSettingsForActiveAccount() with $accountSettings()
✅ SQL Abstraction: Replaced PlatformServiceFactory.getInstance() with mixin methods
✅ Notification Migration: Added comprehensive notification system with constants
✅ Error Handling: Enhanced with success/error notifications for user feedback
✅ Mixin Enhancement: Added $mapQueryResultToValues and $mapColumnsToValues methods
✅ Code Quality: Eliminated databaseUtil dependency completely
- Added NOTIFY_GIFTED_DETAILS_* constants for all user-facing messages
- Replaced all direct $notify calls with notification helpers and constants
- Enhanced PlatformServiceMixin with mapping utilities to eliminate legacy dependencies
- Updated interface definitions for new mixin methods
- All linting passed, validation shows technically compliant
- EXCELLENT execution: 50% faster than estimated (10 min vs 20 min)
Migration Status: 52% complete (48/92 components, 5 human tested)
Next: Human testing to verify gift recording workflow
- Replaced all databaseUtil and direct PlatformServiceFactory usage with PlatformServiceMixin methods
- Removed all raw SQL queries from the component
- Centralized notification message in src/constants/notifications.ts
- Replaced direct $notify call with notification helper and TIMEOUTS constant
- Updated migration documentation and security audit
- Ran lint-fix; no migration-specific errors remain
Ready for human testing and validation.
- Replaced all databaseUtil and direct PlatformServiceFactory usage with PlatformServiceMixin methods
- Removed all raw SQL queries from the component
- Centralized all notification messages in src/constants/notifications.ts
- Replaced direct $notify calls with notification helpers and TIMEOUTS constants
- Streamlined template logic (tab classes via computed properties)
- Updated migration documentation and security audit
- Ran lint-fix; no errors remain
Ready for human testing and validation.
- ConfirmGiftView.vue: Complete triple migration (11 minutes, EXCELLENT execution)
- Replaced databaseUtil and PlatformServiceFactory with PlatformServiceMixin methods
- Migrated 6 notification calls to helper methods with centralized constants
- Added 5 new notification constants for gift confirmation workflow
- All linting errors resolved, human tested and validated
- ClaimReportCertificateView.vue: Already migrated, marked as human tested
- Component was already fully compliant with modern patterns
- Human testing completed and documented
- No additional migration work required
- Updated migration status: 47% complete (43/92 components)
- Enhanced notification constants with proper message extraction
- All components follow Enhanced Triple Migration Pattern
- Security audit: SQL injection prevention, standardized error handling
- Performance: Migration time reduced by 20% through improved processes
Migration progress: 47% complete with perfect human testing record (4/4 components)
- Replaced all databaseUtil and direct PlatformServiceFactory usage with PlatformServiceMixin methods
- Abstracted all notification messages to src/constants/notifications.ts and migrated to notify helper
- Added computed properties for assignment labels to streamline template logic
- Removed unused imports and resolved all linter errors
- Updated migration documentation and ensured security audit compliance
- All changes validated with lint-fix and ready for human testing
- Create systematic audit template with line-by-line feature documentation
- Update migration checklist with mandatory audit as Step 0
- Complete example audit for GiftedPrompts.vue (15-20 min, Simple complexity)
- Ensure no functionality is lost during migrations
- Provide verification checklist for post-migration testing
- Add Human Testing Tracker with 33/92 components migrated (35% complete)
- Create detailed testing guide for ContactEditView.vue with migration patterns
- Add migration checklists for Views, Components, and Dialogs
- Create Phase 2 roadmap for remaining 59 component migrations
- Add performance dashboard with practical metrics and monitoring
- Create release checklist with quality gates and milestone planning
- Update README with complete documentation overview and navigation
- Add security audit checklist for comprehensive security validation
All documents reflect current 35% migration status with 8 components human tested.
Migration success rate: 100% with zero mixed patterns in migrated components.
- Update CURRENT_MIGRATION_STATUS.md with latest progress (35% complete)
- Add ContactAmountsView.vue to human testing completion list
- Update migration-time-tracker.md with testing metrics and progress
- Document 8 components now human tested, 25 ready for testing
- Update realistic estimates for remaining 59 components
Migration Progress: 33/92 components (35%) | Human Tested: 8 components
- Update CURRENT_MIGRATION_STATUS.md with latest progress (35% complete)
- Add ContactAmountsView.vue to human testing completion list
- Update migration-time-tracker.md with testing metrics and progress
- Document 8 components now human tested, 25 ready for testing
- Update realistic estimates for remaining 59 components
Migration Progress: 33/92 components (35%) | Human Tested: 8 components
- Update CURRENT_MIGRATION_STATUS.md with latest progress (34% complete)
- Add ContactEditView.vue to human testing completion list
- Update migration-time-tracker.md with testing metrics and progress
- Document 7 components now human tested, 25 ready for testing
- Update realistic estimates for remaining 60 components
Migration Progress: 32/92 components (34%) | Human Tested: 7 components
- Update CURRENT_MIGRATION_STATUS.md with latest progress (33% complete)
- Add human testing completion for OnboardMeetingSetupView.vue and ContactsView.vue
- Update migration-time-tracker.md with testing metrics and progress
- Document 6 components now human tested, 25 ready for testing
- Update technical architecture examples with latest patterns
Migration Progress: 31/92 components (33%) | Human Tested: 6 components
Matthew Raymer
Matthew Raymer