Kenso Grimm
216a972fef
- Add .gitignore to exclude node_modules, dist, logs, and system files - Add comprehensive project documentation including README, deployment guide, and development setup - Add .kiro project specifications for amazon-product-bar-extension, appwrite-cloud-storage, appwrite-userid-repair, blacklist-feature, and enhanced-item-management - Add .kiro steering documents for product, structure, styling, and tech guidelines - Add VSCode settings configuration for consistent development environment - Add manifest.json and babel/vite configuration for extension build setup - Add complete source code implementation including AppWrite integration, storage managers, UI components, and services - Add comprehensive test suite with Jest configuration and 30+ test files covering all major modules - Add test HTML files for integration testing and validation - Add coverage reports and build validation scripts - Add AppWrite setup and repair documentation for database schema management - Add migration guides and responsive accessibility implementation documentation - Establish foundation for Amazon product bar extension with full feature set including blacklist management, enhanced item workflows, and real-time synchronization
1.8 KiB
1.8 KiB
Technology Stack & Build System
Core Technologies
- React 18: UI framework for components (StaggeredMenu, panels)
- GSAP 3.12+: Animation library for smooth menu transitions
- Vite 6.0+: Build tool and development server
- Jest 30+: Testing framework with jsdom environment
- Babel: JavaScript transpilation for compatibility
- Chrome Extension Manifest V3: Extension platform
Build System
Development Commands
# Install dependencies
npm install
# Development build with watch mode
npm run dev
# Production build
npm run build
# Run tests
npm run test
# Run tests in watch mode
npm run test:watch
Build Configuration
- Entry Point:
src/content.jsx - Output:
dist/content.jsanddist/style.css - No code splitting: Single bundle for extension compatibility
- CSS bundling: All styles combined into single file
- Minification: Disabled for debugging
Extension Development Workflow
- Run
npm run devfor watch mode - Load unpacked extension in Chrome (
chrome://extensions/) - After code changes, reload extension in Chrome
- Refresh Amazon page to see changes
Testing Setup
- Environment: jsdom for DOM simulation
- Mocks: localStorage, Chrome APIs
- Property-based testing: fast-check for robust test cases
- Setup file:
jest.setup.jsfor test environment configuration
Key Dependencies
- gsap: Animation engine for menu transitions
- react/react-dom: UI framework and rendering
- @vitejs/plugin-react: Vite React integration
- jest-environment-jsdom: DOM testing environment
- fast-check: Property-based testing library
Browser Compatibility
- Chrome/Chromium-based browsers
- Manifest V3 compliance
- ES6+ features (modules, async/await, classes)
- Modern DOM APIs (MutationObserver, localStorage)