chore: initialize project repository with core extension files

- 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
This commit is contained in:
2026-01-12 17:46:42 +01:00
commit 216a972fef
180 changed files with 88019 additions and 0 deletions

66
.kiro/steering/tech.md Normal file
View File

@@ -0,0 +1,66 @@
# 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
```bash
# 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.js` and `dist/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
1. Run `npm run dev` for watch mode
2. Load unpacked extension in Chrome (`chrome://extensions/`)
3. After code changes, reload extension in Chrome
4. 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.js` for 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)