JLCPCB Parts Library

@@ -1,99 +1,52 @@-# JLCPCB Parts Library+# adom-jlcpcb -**Know it's in the JLCPCB library — Basic or Extended — before you commit a board to fab.**+JLCPCB Electronics component search for the Adom ecosystem — one Rust binary, three modes: -![Is it in the JLCPCB library? Check Basic vs Extended, LCSC stock and assembly pricing before you fab](/blob/app/adom-jlcpcb/screenshots/hero.png)+- **CLI verbs** — `adom-jlcpcb search|part|health` for quick JSON-returning shell use.+- **Hydrogen webview app** — `adom-jlcpcb app` opens a searchable UI as a first-class Hydrogen tab.+- **Backend HTTP service** — `adom-jlcpcb serve` runs the shared proxy (port 8774) used by the `service-jlcpcb` container. -`adom-jlcpcb` is the single-vendor JLCPCB / LCSC tool for the Adom ecosystem — one Rust binary,-three faces:+Replaces the former `gallia/services/jlcpcb/server.js` + `gallia/jlcpcb/mcp/` setup. No MCP server, no Adom Viewer dependency. -- **CLI** — `adom-jlcpcb search | part | health` for quick JSON-returning shell use and BOMs.-- **Hydrogen app** — `adom-jlcpcb app` opens a searchable UI as a first-class Hydrogen tab.-- **Backend service** — `adom-jlcpcb serve` runs the shared proxy (port 8779) that powers the-  `service-jlcpcb` container and feeds [`adom-parts-search`](/adom/adom-parts-search).+## Quick start  ```bash-adom-wiki pkg install adom-jlcpcb-adom-jlcpcb search "0402 10k resistor"-```--## Basic vs Extended — the question that costs money--On a JLCPCB assembly run, **Basic** parts are pre-loaded on the line (no fee), while **Extended**-parts add a per-part feeder setup charge. Picking a Basic equivalent up front can shave real money-off a build. `adom-jlcpcb` shows the library tier on every card, alongside LCSC code, stock and-price, so you design around what's actually cheap to place.--![adom-jlcpcb results for an 0402 10k resistor and an LM358 op-amp, all flagged as Basic parts with LCSC codes and assembly pricing](/blob/app/adom-jlcpcb/screenshots/results-passives.png)--## Catch the Extended part before fab does--Search your MCU or regulator and you'll see at a glance whether your first pick is Basic, and what-the Basic alternative is. Here a popular STM32 is Basic, while a drop-in GD32 equivalent is-Extended — exactly the trade-off you want to make *before* the board goes out.--![adom-jlcpcb results comparing an STM32F103C8T6 Basic part with a GD32 Extended alternative and a Basic MLCC, with LCSC stock and pricing](/blob/app/adom-jlcpcb/screenshots/results-mcu.png)--## Scriptable from the first keystroke--`search` returns JSON; `part` fetches one LCSC code; `health` checks the backend. Pipe it into-`jq`, a BOM, or a board-cost estimator.+# One-shot search (auto-detects backend, or falls back to direct JLCPCB call)+adom-jlcpcb search "STM32F103RBT6" -![Terminal showing adom-jlcpcb search piped to jq for the first component including its Basic library tier, then a health check](/blob/app/adom-jlcpcb/screenshots/cli.png)+# Interactive UI+adom-jlcpcb app -```bash-adom-jlcpcb search "LM358" | jq '.components[0]'-adom-jlcpcb part "C7950"-adom-jlcpcb health+# Run the backend on the service container+JLCPCB_API_KEY_UNUSED_placeholder=<key> adom-jlcpcb serve ``` -## Install--```bash-adom-wiki pkg install adom-jlcpcb-```+See `SKILL.md` for the full command reference and typical workflows. -## How it works+## Architecture  ```-  any container                          service-jlcpcb-  $ adom-jlcpcb search "LM358"  ──POST──▶  adom-jlcpcb serve  (:8779)-  $ adom-jlcpcb app                        LCSC resolve + cache-    (Hydrogen webview tab)-                                                 │-                                                 ▼-                                          JLCPCB / LCSC parts API+┌─────────────────────────────────┐          ┌─────────────────────────┐+│  any container                  │          │  service-jlcpcb         │+│                                 │          │                         │+│  $ adom-jlcpcb search "ESP32"   │───POST──▶│  adom-jlcpcb serve      │+│  $ adom-jlcpcb app              │          │    port 8774            │+│    (Hydrogen webview tab)       │          │    JLCPCB_API_KEY_UNUSED_placeholder set   │+│                                 │          │    10-min LRU cache     │+└─────────────────────────────────┘          └─────────────────────────┘+                                                         │+                                                         ▼+                                              api.jlcpcb.com (v2) ``` -JLCPCB is an assembly-first workflow, so in [`adom-parts-search`](/adom/adom-parts-search) it shows-as a library column rather than competing on the buy-now recommendation — but for "can JLCPCB-place this for me, and is it Basic?" it's the fastest answer in the workspace.+Consumer containers point `JLCPCB_API` at the service container's public URL; locally, the CLI will also autodetect `http://127.0.0.1:8774` if a backend is running on the same box. -## See also--- [`adom-parts-search`](/adom/adom-parts-search) — searches Mouser, DigiKey and JLCPCB at once and picks the best buy.--## Open source — make it yours, then give it back--This app is **open source under the MIT license**. Fork it, rewrite it, rename it, bend it to your-own workflow — and when you've made it better, **send your changes back to the Adom Wiki so the-whole community benefits**. Every wiki page is a git repo with a package registry on top, so-contributing back is first-class — improvements that land here ship to every Adom user who installs-the app.+## Build  ```bash-adom-wiki pkg install adom-jlcpcb      # install it-#   …edit the source to taste…-adom-wiki pkg publish             # publish your own fork, or-#   open a pull request against this page so the change lands for everyone+./build.sh    # cargo build --release → copy to /usr/local/bin → adom-jlcpcb install ``` -> **One caveat — the search backend is an Adom service.** The actual lookups run against-> Adom's hosted JLCPCB / LCSC backend (`service-jlcpcb`), which uses **Adom's vendor API credentials and counts against Adom's quota**. That-> hosted backend is an Adom service and is **subject to change** — rate limits, endpoints, and-> availability can move at any time. Everything client-side (the CLI, the webview, the rendering-> and recommendation logic) is yours to fork and republish; the cloud API quota is not.- ## License -MIT © Adom — do what you want with the code, just pass it on.+MIT.