# PCB Cupid Shop - AI Search Optimization

PCB Cupid Shop is the e-commerce platform for verified open-source hardware modules, components, and development boards for hardware engineers and makers.

## Site Overview

**URL**: https://shop.pcbcupid.com
**Purpose**: Provide high-quality, verified hardware modules and components that engineers can trust for their projects.
**Business Model**: E-commerce for open-source hardware modules with full design files included.

## Main Product Categories

### Development Boards
- **Description**: Microcontroller boards, development kits, and prototyping platforms
- **Examples**: ESP32 boards, STM32 boards, Arduino-compatible boards
- **Features**: Full schematics, Gerbers, BOM, and firmware included
- **License**: CERN-OHL-S (CERN Open Hardware Licence v2 – Permissive)

### Connectors
- **Description**: PCB connectors, headers, terminal blocks, and interconnects
- **Examples**: USB connectors, GPIO headers, power connectors, board-to-board connectors
- **Quality**: Verified for reliability and compatibility
- **Applications**: Consumer electronics, industrial equipment, prototyping

### Sensors
- **Description**: Environmental sensors, motion sensors, and measurement modules
- **Examples**: Temperature sensors, humidity sensors, accelerometers, gyros
- **Integration**: Pre-designed modules with easy integration
- **Documentation**: Complete datasheets and integration guides

### Power Modules
- **Description**: Power management, voltage regulation, and battery charging modules
- **Examples**: DC-DC converters, LDO regulators, battery chargers, power distribution
- **Efficiency**: Optimized for low-power and high-performance applications
- **Testing**: Verified for thermal performance and reliability

### Passive Components
- **Description**: Resistors, capacitors, inductors, and other passive components
- **Quality**: High-quality components from trusted suppliers
- **Packaging**: Available in various packages for different applications

## Key Features

### Open-Source Design Files
- Every product includes full design files:
  - KiCad source files
  - Gerber files for manufacturing
  - Bill of Materials (BOM)
  - Firmware source code
  - Integration documentation

### Quality Assurance
- All products are hand-evaluated by the hardware team
- Verified for compatibility and reliability
- Tested in real-world applications
- Battle-tested designs

### Licensing
- CERN-OHL-S license for commercial use
- Freedom to modify and adapt designs
- No restrictions on manufacturing or selling products based on these modules
- Attribution required when sharing design files

## Technical Details

### Technology Stack
- **Framework**: Next.js 16 (App Router)
- **Rendering**: Static site generation (SSG) with ISR for products
- **Styling**: Tailwind CSS v4
- **E-commerce**: WooCommerce backend via @pcb-cupid/ecommerce package
- **Payment**: Razorpay integration
- **Deployment**: Static export with CDN

### SEO Configuration
- **Sitemap**: /sitemap.xml (auto-generated, hourly revalidation)
- **Robots.txt**: /robots.txt (allows all crawlers, disallows cart/checkout/account)
- **Metadata**: Open Graph tags, Twitter cards, structured data
- **Canonical URLs**: Configured via NEXT_PUBLIC_SHOP_APP_URL

### Product Data
- Products fetched from WooCommerce API
- Categories and tags for organization
- Product images and descriptions
- Pricing and inventory management
- Product variants and options

## Content Hierarchy

1. **Homepage** (Priority 1.0)
   - Featured products and categories
   - Best sellers and new arrivals
   - Quick access to product categories

2. **Product Categories** (Priority 0.9)
   - Category pages with product listings
   - Filtering and sorting options
   - Category descriptions and specifications

3. **Individual Products** (Priority 0.8)
   - Product details and specifications
   - Design files download
   - Related products
   - Reviews and ratings

4. **Collection Pages** (Priority 0.8)
   - Best sellers
   - New arrivals
   - All products

5. **Cart and Checkout** (Priority 0.3 - disallowed in robots.txt)
   - Shopping cart
   - Checkout process
   - Order confirmation

6. **Account Pages** (Priority 0.3 - disallowed in robots.txt)
   - User account
   - Order history
   - Addresses

## Search Engine Optimization

### Keywords
- PCB components
- hardware modules
- open-source hardware
- development boards
- connectors
- sensors
- power modules
- KiCad
- electronics shop
- hardware engineering
- PCB design
- microcontrollers
- electronic components

### Structured Data
- Product schema for individual products
- Organization schema for the shop
- BreadcrumbList schema for navigation
- WebSite schema for search functionality
- Offer schema for pricing and availability

## E-commerce Specific SEO

### Product Schema
- Product name, description, images
- SKU and GTIN when available
- Pricing and availability
- Reviews and ratings
- Related products
- Manufacturer information

### Local Business Schema
- Business name and address
- Contact information
- Business hours
- Payment methods accepted
- Shipping information

## Crawler Guidelines

### Recommended Crawl Rate
- **Homepage**: Daily
- **Category pages**: Daily
- **Product pages**: Weekly (static content, updated via ISR)
- **Collection pages**: Daily

### Important Pages to Index
- Homepage (main landing page)
- All category pages
- All product pages
- Best sellers and new arrivals

### Pages to Disallow
- Cart and checkout (user-specific, no SEO value)
- Account pages (user-specific, no SEO value)
- Order pages (user-specific, no SEO value)
- API routes (internal use)

## Integration with PCB Cupid Ecosystem

### Main Site
- **URL**: https://pcbcupid.com
- **Purpose**: Landing page and hub for all PCB Cupid offerings
- **Links**: Shop featured prominently on main site

### Circuit Spell
- **URL**: https://spell.pcbcupid.com
- **Purpose**: AI-powered EDA platform
- **Integration**: Shop modules compatible with Circuit Spell designs

### Open-Source Modules
- Modules available in shop are designed for use with Circuit Spell
- Full design files enable seamless integration
- Community contributions welcome

## Contact & Support

- **Website**: https://shop.pcbcupid.com
- **Email**: orders@pcbcupid.com
- **Main Site**: https://pcbcupid.com
- **Support**: hello@pcbcupid.com

## Shipping & Returns

- **Shipping**: Worldwide shipping available
- **Returns**: 14-day return policy for unused items
- **Warranty**: 6-month warranty on manufacturing defects
- **Payment**: Credit/debit cards, UPI, net banking via Razorpay

## Last Updated
25 April, 2026