document jlcpcb footprint strings

docs/elements/chip.mdx

@@ -788,5 +788,10 @@ guide! This is often much easier and reliable than configuring a chip yourself.
 - [Importing Components from KiCad](../guides/importing-modules-and-chips/importing-from-kicad.md)
 
 :::tip
-If you're only looking to use a standard footprint from KiCad, you can skip importing entirely by referencing the footprint directly with the `kicad:` prefix (e.g. `footprint="kicad:Resistor_SMD/R_0402_1005Metric"`). See [KiCad Footprints](/footprints/kicad-footprints) for details.
+If you're only looking to use an existing PCB footprint, you can skip importing entirely and reference it directly.
+
+- For KiCad library footprints, use the `kicad:` prefix (for example `footprint="kicad:Resistor_SMD/R_0402_1005Metric"`).
+- For JLCPCB / EasyEDA part footprints, use the `jlcpcb:` prefix (for example `footprint="jlcpcb:C2040"`).
+
+See [KiCad Footprints](/footprints/kicad-footprints) and [JLCPCB Footprints](/footprints/jlcpcb-footprints) for details.
 :::

docs/footprints/jlcpcb-footprints.mdx

@@ -0,0 +1,49 @@
+---
+title: JLCPCB Footprints
+sidebar_position: 2
+description: Use JLCPCB supplier part numbers directly with the `jlcpcb:` footprint prefix
+---
+
+tscircuit can load PCB footprints directly from JLCPCB/EasyEDA part records. Any element that accepts a `footprint` property can reference a JLCPCB part by using the `jlcpcb:` prefix followed by the supplier part number.
+
+import CircuitPreview from "@site/src/components/CircuitPreview"
+
+## Basic Usage
+
+<CircuitPreview
+  defaultView="pcb"
+  hideSchematicTab
+  code={`export default () => (
+  <board width="20mm" height="20mm">
+    <chip
+      name="U1"
+      manufacturerPartNumber="RP2040"
+      footprint="jlcpcb:C2040"
+    />
+  </board>
+)`}
+/>
+
+The recommended format is `jlcpcb:C<part-number>`, for example `jlcpcb:C2040`.
+
+For example, the RP2040 can be referenced directly with:
+
+```tsx
+<chip name="U1" manufacturerPartNumber="RP2040" footprint="jlcpcb:C2040" />
+```
+
+## What Gets Loaded
+
+When you use a `jlcpcb:` footprint string, tscircuit fetches the part's PCB footprint data from the configured parts engine. In the default platform, this uses the JLCPCB/EasyEDA part catalog and can also attach 3D model data when it is available.
+
+Use this when you only need the PCB footprint (and optional 3D model). If you also need a generated symbol, port definitions, or a reusable TSX component, use [Importing from JLCPCB](/guides/importing-modules-and-chips/importing-from-jlcpcb) instead.
+
+## Search for Part Numbers
+
+You can discover valid JLCPCB part numbers with:
+
+```bash
+tsci search --jlcpcb RP2040
+```
+
+Search results now include qualified footprint strings like `jlcpcb:C2040`, which can be copied directly into your `footprint` prop.

docs/guides/running-tscircuit/platform-configuration.md

@@ -26,7 +26,7 @@ All of the following features of the platform can be configured:
 - **registryApiUrl** - The registry to use, defaults to `https://api.tscircuit.com`. See [Registry API](../../web-apis/the-registry-api.md) for more details
 - **cloudAutorouterUrl** - The cloud autorouter to use, defaults to a tscircuit cloud service that uses freerouting
 - Disable specific circuit outputs to optimize build times, such as disabling autorouting
-- **footprintLibraryMap** - Configure custom prefixes for loading footprint strings from a server. This is how the `kicad:*` footprint strings are loaded!
+- **footprintLibraryMap** - Configure custom prefixes for loading footprint strings from a server. This is how built-in library prefixes like `kicad:*` and `jlcpcb:*` are loaded.
 - **printBoardInformationToSilkscreen** - Print the board information to the silkscreen. This includes standard board and platform information like the board name, version etc.
 
 > See the full specification for the [tscircuit platform configuration](https://github.com/tscircuit/props/blob/main/lib/platformConfig.ts)