# PCB Cupid - AI Search Optimization

PCB Cupid is a hardware engineering platform focused on two main offerings: Circuit Spell (AI-powered EDA) and open-source hardware modules.

## Site Overview

**URL**: https://pcbcupid.com
**Purpose**: Provide AI-powered PCB design tools and open-source hardware modules to help engineers go from napkin idea to production-ready board.
**Main Products**:
- **Circuit Spell**: AI-powered EDA platform at spell.pcbcupid.com - Describe hardware in plain English and get production-ready PCB schematics
- **Open-Source Modules**: Verified hardware modules available at shop.pcbcupid.com - Battle-tested designs with full KiCad source, Gerbers, BOM, and firmware

**Supplementary Offerings**:
- Tools: Free PCB calculators for impedance, trace width, power analysis (80+ calculators)
- Articles: Technical guides and tutorials for hardware engineers

## Main Sections

### Circuit Spell (spell.pcbcupid.com)
- **Description**: AI-powered EDA platform that converts natural language descriptions into PCB schematics and layouts
- **Features**: Automatic routing, component placement, export to KiCad/Altium/Eagle
- **Target Audience**: Hardware engineers, PCB designers, electronics makers
- **Update Frequency**: Regular feature updates and AI model improvements

### Open-Source Modules (shop.pcbcupid.com)
- **Description**: E-commerce platform for verified open-source hardware modules
- **Content**: Dev boards, connectors, sensors, power modules, and more
- **License**: CERN-OHL-S (CERN Open Hardware Licence v2 – Permissive)
- **Includes**: Full KiCad source, Gerbers, BOM, and firmware for each module
- **Update Frequency**: New modules added regularly

### Tools (/tools) - Supplementary
- **Description**: Collection of 80+ free PCB design calculators and engineering tools
- **Content**: Interactive calculators for impedance matching, trace width calculations, power analysis, and more
- **Purpose**: Support tools for hardware engineers using Circuit Spell or designing custom boards
- **Categories**: 
  - Impedance calculators (microstrip, stripline, differential pairs)
  - Power calculations (DC, AC, transformer sizing)
  - Component calculators (inductance, capacitance, resistance)
  - RF and antenna design tools
  - Signal integrity tools
- **Update Frequency**: Tools are static, rarely updated

### Articles (/articles) - Supplementary
- **Description**: In-depth technical articles and tutorials on PCB design
- **Content**: Signal integrity, power delivery networks, impedance matching, EMI/EMC, and more
- **Source**: CMS - managed content
- **Update Frequency**: New articles added weekly
- **Target Audience**: Professional hardware engineers, students, researchers
- **Structure**: Each article has title, excerpt, full HTML content, author info, reading time, and tags

### About (/about)
- **Description**: Company information, mission, and product overview
- **Content**: Information about Circuit Spell, open-source modules, shop, and community
- **Update Frequency**: Rarely updated

### Legal Pages
- **Privacy Policy** (/privacy): Data handling and privacy practices
- **Terms of Service** (/terms): Terms and conditions for using the platform

## Key Content Types

### Circuit Spell (Primary Offering)
- AI-assisted PCB design platform
- Natural language to schematic conversion
- Automatic routing and component placement
- Export to standard EDA formats (KiCad, Altium, Eagle)
- Browser-based and beginner-friendly

### Open-Source Hardware Modules (Primary Offering)
- Verified, battle-tested module designs
- Full design files (KiCad source, Gerbers, BOM, firmware)
- CERN-OHL-S licensed for commercial use
- Available for purchase at shop.pcbcupid.com
- Categories: dev boards, connectors, sensors, power modules, etc.

### Calculators (Supplementary)
- Interactive tools built with React
- Real-time calculations for engineering parameters
- Each tool has: name, description, category, input fields, output fields, calculation logic
- Examples: Trace width calculator, impedance calculator, power dissipation calculator

### Technical Articles (Supplementary)
- Long-form educational content (1000-5000 words)
- Markdown-based with mathematical equations (KaTeX)
- Code examples and diagrams
- Author attribution and publication dates
- Tag-based categorization

## Technical Details

### Technology Stack
- **Framework**: Next.js 16 (App Router)
- **Rendering**: Static site generation (SSG)
- **Styling**: Tailwind CSS v4
- **Content**: CMS for articles, TypeScript for tools
- **Deployment**: Static export

### Related Applications
- **Circuit Spell**: spell.pcbcupid.com - AI EDA platform
- **Shop**: shop.pcbcupid.com - E-commerce for hardware modules
- **Auth**: auth.pcbcupid.com - Authentication service
- **Admin**: admin.pcbcupid.com - Admin dashboard

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

### API Endpoints
- No public API endpoints on main site
- All content is statically generated at build time
- CMS API used only during build for article fetching

## Content Hierarchy

1. **Homepage** (Priority 1.0)
   - Overview of Circuit Spell and open-source modules
   - Links to spell.pcbcupid.com and shop.pcbcupid.com
   - Access to supplementary tools and articles

2. **Circuit Spell** (Priority 1.0) - External: spell.pcbcupid.com
   - AI-powered EDA platform
   - Main product offering

3. **Open-Source Modules** (Priority 1.0) - External: shop.pcbcupid.com
   - E-commerce platform
   - Main product offering

4. **Tools Index** (Priority 0.7) - Supplementary
   - Categorized listing of calculators
   - Support tools for hardware engineers

5. **Individual Tools** (Priority 0.6) - Supplementary
   - Tool description and usage instructions
   - Interactive calculator interface

6. **Articles Index** (Priority 0.7) - Supplementary
   - Chronological listing of all articles
   - Category filtering

7. **Individual Articles** (Priority 0.6) - Supplementary
   - Full article content
   - Author information
   - Related articles navigation

8. **Legal Pages** (Priority 0.3)
   - Privacy policy and terms

## Search Engine Optimization

### Keywords
- PCB design
- AI EDA
- Circuit Spell
- open-source hardware
- hardware modules
- circuit design
- electronics
- CAD tools
- hardware engineering
- PCB layout
- schematic design
- hardware development
- KiCad
- Altium
- Eagle

### Structured Data
- Organization schema for company info
- WebApplication schema for the platform
- Article schema for blog posts (supplementary)
- BreadcrumbList schema for navigation
- SoftwareApplication schema for calculators (supplementary)

## Crawler Guidelines

### Recommended Crawl Rate
- **Homepage**: Daily
- **Tools pages**: Weekly (static content)
- **Articles pages**: Daily (new content added regularly)
- **Legal pages**: Monthly

### Important Pages to Index
- Homepage (main landing page)
- About page (product overview)
- Tool pages (supplementary resources)
- Article pages (supplementary educational content)

### Pages to De-prioritize
- Privacy policy and terms (low content value)
- Any API or admin routes (if added later)

### External Sites to Crawl
- spell.pcbcupid.com (Circuit Spell - main product)
- shop.pcbcupid.com (Open-source modules - main product)

## Contact & Support

- **Website**: https://pcbcupid.com
- **Circuit Spell**: https://spell.pcbcupid.com
- **Shop**: https://shop.pcbcupid.com
- **Email**: hello@pcbcupid.com
- **Content Updates**: Articles updated via CMS
- **Tool Updates**: Managed through code repository

## Last Updated
25 April, 2026