From dca3f0f4a37a1f0bf2231b72b1b9dfd986847646 Mon Sep 17 00:00:00 2001
From: techmannih <manishchaudharyttt@gmail.com>
Date: Thu, 16 Jul 2026 21:51:07 +0530
Subject: [PATCH] Add guide for importing Ultra Librarian

---
 .../importing-from-ultra-librarian.md         | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 docs/guides/importing-modules-and-chips/importing-from-ultra-librarian.md

diff --git a/docs/guides/importing-modules-and-chips/importing-from-ultra-librarian.md b/docs/guides/importing-modules-and-chips/importing-from-ultra-librarian.md
new file mode 100644
index 0000000..f9fe4a6
--- /dev/null
+++ b/docs/guides/importing-modules-and-chips/importing-from-ultra-librarian.md
@@ -0,0 +1,51 @@
+---
+title: Importing from Ultra Librarian
+sidebar_position: 3.5
+description: Download a KiCad symbol and footprint from Ultra Librarian and import them directly into tscircuit.
+---
+
+## Overview
+
+You can download schematic symbols and PCB footprints from
+[Ultra Librarian](https://www.ultralibrarian.com/) and import the KiCad files
+directly into tscircuit.
+
+## Downloading from Ultra Librarian
+
+1. Visit [Ultra Librarian](https://www.ultralibrarian.com/).
+2. Search for the manufacturer part number.
+3. Select the footprint variant you need.
+4. Click **Download Now**.
+5. Sign in or create an Ultra Librarian account when prompted.
+6. Choose the **KiCad v5** or **KiCad v6+** format.
+7. Download and extract the ZIP file.
+
+The extracted files include:
+
+- the `.kicad_mod` file for the PCB footprint
+- the `.kicad_sym` file for the schematic symbol
+
+## Importing Ultra Librarian Components
+
+Copy both files into your tscircuit project. Import them and pass them to the
+`footprint` and `symbol` props of a `<chip />`:
+
+```tsx
+import kicadSym from "./symbol.kicad_sym"
+import kicadMod from "./footprint.kicad_mod"
+
+export default () => {
+  return (
+    <board>
+      <chip
+        name="U1"
+        footprint={kicadMod}
+        symbol={kicadSym}
+      />
+    </board>
+  )
+}
+```
+
+The `.kicad_mod` file provides the PCB footprint, while the `.kicad_sym` file
+provides the schematic symbol.