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:
66
.kiro/steering/tech.md
Normal file
66
.kiro/steering/tech.md
Normal 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)
|
||||
Reference in New Issue
Block a user