Datasheet Miner

Search, filter, and compare motor and drive specs from datasheets

Features

🔍

Advanced Filtering

Filter by any spec attribute with IS/NOT modes, range sliders, and multi-select. Sort by multiple columns simultaneously.

Gear Ratio Computation

Auto-compute per-motor gear ratios from torque and speed filters, or apply a fixed ratio across all results.

📄

Datasheet Links

Click any product to view full specs with direct links to source datasheets and relevant pages.

📡

PDF Upload Pipeline

Upload datasheets via presigned S3 URLs. AI extracts structured specs with quality scoring and dedup.

💻

CLI Tools

Quickstart CLI for dev, test, deploy, and smoke testing. Agent-facing query CLI for programmatic access.

📱

Mobile Responsive

Collapsible filters on mobile with touch-friendly targets. Desktop-first with a snug mobile layout.

Quick Start

# Clone and install
git clone https://github.com/jimothyjohn/datasheetminer.git
cd datasheetminer

# Start local dev servers (backend + frontend)
./Quickstart dev

# Run tests
./Quickstart test

# Deploy to AWS (requires AWS CLI configured)
./Quickstart deploy --stage prod

API

Endpoint Description
GET /health Health check with status, mode, and timestamp
GET /api/products List products (filter with ?type=motor)
GET /api/products/summary Counts by product type
GET /api/products/categories Available product types
GET /api/products/manufacturers Manufacturer list
GET /api/datasheets Datasheet entries

Architecture

Frontend

React + TypeScript + Vite. Deployed to S3 behind CloudFront with custom domain support.

Backend

Express.js on AWS Lambda via API Gateway. Public mode blocks writes; admin mode for local dev.

Data

DynamoDB with PK/SK schema. Stage-isolated tables (products-dev, products-prod). S3 for PDF uploads.

Infrastructure

AWS CDK with three stacks: Database, API, and Frontend. Multi-stage (dev/staging/prod) deployments.