Removed Flowbite

.rules/03232026.sparkplate.PrepAndExecution.md

@@ -0,0 +1,388 @@
+# Sparkplate Preparation and Execution Plan - March 23, 2026
+
+**Supersedes / split from**: `05312025.sparkplate.PrepAndExecution.md` (May 31, 2025)
+
+## Overview
+This document outlines the comprehensive execution plan for Sparkplate.Fresh as of March 23, 2026. It reflects the current state of the project, completed migrations, and the path forward for implementing remaining features and achieving full production readiness.
+
+## Table of Contents
+1. [Current State Assessment](#current-state-assessment)
+2. [Immediate Action Items](#immediate-action-items)
+3. [Core Development Priorities](#core-development-priorities)
+4. [Feature Implementation Roadmap](#feature-implementation-roadmap)
+5. [Testing and Quality Assurance](#testing-and-quality-assurance)
+6. [Documentation and Deployment](#documentation-and-deployment)
+7. [Maintenance and Growth](#maintenance-and-growth)
+
+## Current State Assessment
+
+### ✅ Completed Infrastructure
+- [x] Vue 3.4.21 migration from Vue 2
+- [x] TypeScript 5.4.2 integration
+- [x] Vite 5.1.5 build system
+- [x] Electron 29.1.1 desktop framework
+- [x] Tailwind CSS 4.1.7 upgrade
+- [x] Modern project structure
+- [x] Development environment setup
+- [x] Basic routing and components
+
+### 🔄 Partially Implemented
+- [x] Crypto utilities (crypto-js, bignumber.js)
+- [x] Currency handling (currency-codes, currency-symbol-map)
+- [x] UI framework (Tailwind, Radix Vue, Lucide icons)
+- [ ] Domain resolution services
+- [ ] Network discovery system
+- [ ] Game implementations
+
+### ⏳ Pending Implementation
+- [ ] Express server integration
+- [ ] SQLite database setup
+- [ ] API connectors (CoinGecko, WalletBeacon, Tezos Domains)
+- [ ] Blessed terminal UI
+- [ ] Multi-platform build pipeline
+- [ ] Package distribution system
+
+## Immediate Action Items (Next 7 Days)
+
+### Day 1-2: Core Services Setup
+```bash
+# Priority 1: Database Integration
+npm install sqlite3 better-sqlite3
+npm install @types/better-sqlite3 --save-dev
+
+# Priority 2: Express Server
+npm install express cors helmet
+npm install @types/express @types/cors --save-dev
+
+# Priority 3: Additional Crypto Support
+npm install web3 ethers @tezos-domains/core
+npm install @airgap/beacon-sdk
+```
+
+### Day 3-4: Service Architecture
+- [ ] Create database schema and migration system
+- [ ] Implement settings service with persistent storage
+- [ ] Set up Express server with security middleware
+- [ ] Create API service layer architecture
+
+### Day 5-7: Basic Integrations
+- [ ] Implement basic domain resolution service
+- [ ] Create cryptocurrency price service (CoinGecko)
+- [ ] Set up wallet connection framework
+- [ ] Implement basic network discovery
+
+## Core Development Priorities
+
+### 1. Database and State Management
+```typescript
+// Database schema design
+interface Settings {
+  theme: 'light' | 'dark';
+  features: {
+    blessed: boolean;
+    express: boolean;
+    network: boolean;
+  };
+  api: {
+    coingecko: string;
+    rateLimit: number;
+  };
+}
+
+interface DomainResolution {
+  domain: string;
+  address: string;
+  resolver: string;
+  chain: string;
+  timestamp: number;
+  ttl: number;
+}
+
+interface GameScore {
+  game: 'pong' | 'tictactoe' | 'breakout';
+  player: string;
+  score: number;
+  timestamp: number;
+}
+```
+
+### 2. API Service Layer
+```typescript
+// Service architecture
+interface ApiService {
+  coingecko: CoinGeckoService;
+  domains: DomainResolutionService;
+  wallet: WalletService;
+  network: NetworkDiscoveryService;
+}
+
+interface CoinGeckoService {
+  getPrice(coinId: string): Promise<number>;
+  getMarketData(coinId: string): Promise<MarketData>;
+  getHistoricalData(coinId: string, days: number): Promise<HistoricalData[]>;
+}
+```
+
+### 3. Domain Resolution Implementation
+```typescript
+interface DomainResolver {
+  ada: AdaDomainsResolver;
+  bonfida: BonfidaResolver;
+  ens: EthereumNameService;
+  icns: InterchainNameService;
+  btc: BtcUsResolver;
+  terra: TerraNameService;
+  tezos: TezosDomainsResolver;
+  unstoppable: UnstoppableDomainsResolver;
+  handshake: HandshakeResolver;
+}
+```
+
+## Feature Implementation Roadmap
+
+### Phase 1: Core Services (Weeks 1-2)
+- [ ] **Database Integration**
+  - SQLite setup with migrations
+  - Settings persistence
+  - Game score tracking
+  - Cache management
+
+- [ ] **Express Server**
+  - REST API endpoints
+  - Security middleware
+  - Rate limiting
+  - CORS configuration
+
+- [ ] **Basic UI Components**
+  - Settings management interface
+  - Domain resolution testing page
+  - Network status indicator
+  - Error handling components
+
+### Phase 2: Cryptocurrency Features (Weeks 3-4)
+- [ ] **Domain Resolution**
+  - Implement all 9 resolver services
+  - Create unified resolution API
+  - Add caching and fallbacks
+  - Error handling and validation
+
+- [ ] **Price and Market Data**
+  - CoinGecko API integration
+  - Real-time price updates
+  - Historical data visualization
+  - Portfolio tracking
+
+- [ ] **Wallet Integration**
+  - WalletBeacon for Tezos
+  - MetaMask for Ethereum
+  - Basic transaction support
+  - Address validation
+
+### Phase 3: Advanced Features (Weeks 5-6)
+- [ ] **Network Discovery**
+  - Peer-to-peer communication
+  - Instance discovery protocol
+  - Message broadcasting
+  - Network status tracking
+
+- [ ] **Game Development**
+  - Pong implementation
+  - Tic Tac Toe with AI
+  - Breakout with levels
+  - Score persistence and leaderboards
+
+- [ ] **Terminal UI (Blessed)**
+  - Alternative TUI interface
+  - Keyboard navigation
+  - Command-line compatibility
+  - Terminal-specific features
+
+### Phase 4: Build and Distribution (Weeks 7-8)
+- [ ] **Multi-platform Building**
+  - Windows installer (NSIS/MSI)
+  - Linux packages (DEB, RPM, AppImage)
+  - macOS bundle (DMG)
+  - Auto-update mechanism
+
+- [ ] **Package Distribution**
+  - Chocolatey (Windows)
+  - Flathub (Linux)
+  - Snapcraft (Linux)
+  - Homebrew (macOS)
+  - Store submissions
+
+## Testing and Quality Assurance
+
+### Unit Testing Setup
+```bash
+# Testing dependencies
+npm install --save-dev vitest @vue/test-utils jsdom
+npm install --save-dev @testing-library/vue @testing-library/jest-dom
+npm install --save-dev playwright # For E2E testing
+```
+
+### Testing Strategy
+- [ ] **Unit Tests**: All services and utilities (90% coverage target)
+- [ ] **Component Tests**: Vue components and composables
+- [ ] **Integration Tests**: API services and database operations
+- [ ] **E2E Tests**: Complete user workflows
+- [ ] **Security Tests**: Input validation and API security
+
+### Quality Gates
+- [ ] ESLint and Prettier enforcement
+- [ ] TypeScript strict mode
+- [ ] Pre-commit hooks
+- [ ] Automated testing in CI/CD
+- [ ] Security vulnerability scanning
+
+## Documentation and Deployment
+
+### Technical Documentation
+- [ ] **API Documentation**
+  - Service interfaces
+  - Error codes and handling
+  - Rate limiting and authentication
+  - Integration examples
+
+- [ ] **Component Library**
+  - Component documentation
+  - Props and events
+  - Usage examples
+  - Accessibility guidelines
+
+- [ ] **Build and Deployment**
+  - Environment setup
+  - Build process documentation
+  - Deployment procedures
+  - Troubleshooting guides
+
+### User Documentation
+- [ ] **Installation Guide**
+  - System requirements
+  - Platform-specific instructions
+  - Troubleshooting common issues
+  - Update procedures
+
+- [ ] **User Manual**
+  - Feature overview
+  - Step-by-step tutorials
+  - Settings configuration
+  - Advanced usage
+
+### CI/CD Pipeline
+```yaml
+# GitHub Actions workflow
+name: Build and Test
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+      - run: npm ci
+      - run: npm run test
+      - run: npm run build
+
+  build-multiplatform:
+    needs: test
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+      - run: npm ci
+      - run: npm run build
+      - run: npm run package
+```
+
+## Maintenance and Growth
+
+### Regular Maintenance Tasks
+- [ ] **Weekly**
+  - Dependency security updates
+  - Performance monitoring
+  - User feedback review
+  - Bug triage
+
+- [ ] **Monthly**
+  - Dependency version updates
+  - Performance optimization
+  - Documentation updates
+  - Feature planning
+
+- [ ] **Quarterly**
+  - Major dependency upgrades
+  - Security audit
+  - User experience review
+  - Roadmap planning
+
+### Growth Opportunities
+- [ ] **Community Building**
+  - Open source contribution guidelines
+  - Community Discord/forum
+  - Tutorial content creation
+  - Developer advocacy
+
+- [ ] **Feature Expansion**
+  - Additional blockchain support
+  - Advanced cryptography features
+  - Plugin system architecture
+  - Cloud sync capabilities
+
+## Success Metrics
+
+### Technical Metrics
+- Build time < 2 minutes
+- Test coverage > 90%
+- Bundle size < 100MB
+- Startup time < 3 seconds
+- Memory usage < 200MB
+
+### User Metrics
+- Installation success rate > 95%
+- User retention > 80% after 30 days
+- Support ticket resolution < 24 hours
+- Community engagement growth
+
+## Risk Assessment and Mitigation
+
+### Technical Risks
+- **Dependency Conflicts**: Regular testing, version pinning
+- **Security Vulnerabilities**: Automated scanning, rapid patching
+- **Performance Issues**: Continuous monitoring, optimization
+- **Cross-platform Compatibility**: Comprehensive testing matrix
+
+### Business Risks
+- **Market Changes**: Flexible architecture, regular assessment
+- **Regulatory Changes**: Compliance monitoring, legal review
+- **Competition**: Feature differentiation, community building
+- **Resource Constraints**: Prioritization framework, automation
+
+## Version History
+- 2026-03-23: Split from May 2025 doc; UI stack notes updated (e.g. Tailwind + Radix Vue + Lucide; Flowbite removed from dependency narrative)
+- 2025-05-31: Initial comprehensive execution plan
+- 2025-05-31: Current state assessment and priority setting
+- 2025-05-31: Roadmap and timeline establishment
+
+## References
+- [Vue 3 Migration Guide](https://v3-migration.vuejs.org/)
+- [Electron Security Guidelines](https://www.electronjs.org/docs/latest/tutorial/security)
+- [Vite Production Build](https://vitejs.dev/guide/build.html)
+- [CoinGecko API Documentation](https://www.coingecko.com/api/documentation)
+- [WalletBeacon Documentation](https://docs.walletbeacon.io/)
+
+## Next Steps
+1. Execute immediate action items (Days 1-7)
+2. Begin Phase 1 implementation (Weeks 1-2)
+3. Regular progress reviews and adjustments
+4. Community feedback integration
+5. Continuous improvement cycle
+
+## Contact and Support
+- **Development Team**: Greenfire <hello@greenfire.io>
+- **Repository**: Sparkplate.Fresh
+- **Documentation**: Internal .rules directory
+- **Issue Tracking**: GitHub Issues