Skip to content

Dheerajsom/PinHub

Repository files navigation

PinHub

PinHub is a searchable pinout catalog for development boards, SBCs, microcontrollers, and embedded hardware. Instead of digging through image search, forum posts, PDFs, and vendor docs every time you need a board pinout, PinHub puts board summaries, warnings, source links, and source-backed connector maps in one clean interface.

Current Build

  • Next.js App Router with TypeScript and Tailwind CSS
  • Static board catalog in src/lib/boards.ts
  • Search by board name, vendor, processor, tag, interface, or warning text
  • Filters for category and common interfaces
  • Local favorites with cross-tab sync and a favorites-only filter
  • Detail view with specs, wiring warnings, source references, and in-app pin maps
  • Source-backed catalog for Raspberry Pi, Arduino, ESP32, STM32 Nucleo, BeagleBone, Jetson, Radxa, Orange Pi, Teensy, Adafruit, Seeed, SparkFun, and micro:bit boards

Getting Started

npm install
npm run dev

Command-Line Interface

PinHub is also available as the cross-platform ph terminal command:

npm install -g @dheerajsom/pinhub
ph rpi5

See the complete CLI guide for installation, commands, output options, troubleshooting, board aliases, development, and release instructions.

Validation

npm run lint
npm run typecheck
npm test
npm run build

Both the website and CLI workflows also run npm audit --audit-level=high. Dependabot checks npm and GitHub Actions dependencies weekly.

Deployment

The production website is deployed from main to pinhub-mauve.vercel.app. The application is statically generated for every known board, requires no runtime environment variables, and publishes a robots policy, sitemap, web app manifest, canonical URLs, and social metadata. Unknown API records return a JSON 404.

The CLI is published separately as @dheerajsom/pinhub on npm. Run the web and CLI validation commands before publishing either surface.

Data Model

Board entries live in src/lib/boards.ts and include:

  • board identity, vendor, category, family, processor, power, and logic level
  • tags and supported interfaces
  • highlights and wiring warnings
  • source links for docs, manuals, datasheets, schematics, and pinouts
  • optional in-app pinout maps for stable connector layouts

Planned Features

  • Board-to-board pinout comparison
  • Pin function filtering for UART, SPI, I2C, CAN, ADC, PWM, GPIO, and power pins
  • User-submitted board entries with review status
  • Downloadable quick-reference sheets
  • Community verification for submitted pinouts

About

Searchable pinout catalog for SBCs and development boards.

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages