From f4102f36c31ed8d89fb6000237684fb3ac32b1bf Mon Sep 17 00:00:00 2001
From: Rahul Nailoo <rahulsinghnailoo@gmail.com>
Date: Mon, 20 Oct 2025 22:48:20 +0530
Subject: [PATCH 1/2] Add tutorial for building a capacitive touch sensor

This tutorial provides step-by-step instructions on a capacitive touch sensor using polygon pads and a touch controller.
---
 .../building-capacitive-touch-sensor.mdx      | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 docs/tutorials/building-capacitive-touch-sensor.mdx

diff --git a/docs/tutorials/building-capacitive-touch-sensor.mdx b/docs/tutorials/building-capacitive-touch-sensor.mdx
new file mode 100644
index 0000000..fac9bce
--- /dev/null
+++ b/docs/tutorials/building-capacitive-touch-sensor.mdx
@@ -0,0 +1,52 @@
+---
+title: Building a Capacitive Touch Sensor
+description: Learn how to design, route, and test a single-button capacitive touch sensor that uses polygon pads and a touch controller.
+---
+
+## Overview
+
+Capacitive touch sensors replace mechanical buttons with copper shapes that detect when a finger changes their electric field. In this tutorial you will:
+
+- Draw a capacitive electrode using `polygon` surface-mount pads.
+- Connect the electrode to a capacitive touch controller.
+- Route the traces, ground reference, and LED indicator for feedback.
+- Simulate the PCB stackup with `tscircuit` before ordering the board.
+
+The finished design exposes a responsive touch pad that lights an LED when it is activated.
+
+<CircuitPreview
+  defaultView="pcb"
+  browser3dView={false}
+  code={`
+  export default () => (
+    <board width="20mm" height="20mm">
+      <chip name="U1" footprint={
+          <footprint>
+        <smtpad shape="polygon" layer="top" portHints={["pin1"]} points={[
+          { x: -4.5, y: 2 },
+          { x: -2.2, y: 2 },
+          { x: -0.4, y: 0 },
+          { x: -2.2, y: -2 },
+          { x: -4.5, y: -2 },
+        ]} />
+        <smtpad shape="polygon" layer="top" portHints={["pin2"]} points={[
+          { x: -1.8, y: 2 },
+          { x: 1.8, y: 2 },
+          { x: 3.6, y: 0 },
+          { x: 1.8, y: -2 },
+          { x: -1.8, y: -2 },
+          { x: 0, y: 0 },
+        ]} />
+        <smtpad shape="polygon" layer="top" portHints={["pin3"]} points={[
+          { x: 2.2, y: 2 },
+          { x: 6, y: 2 },
+          { x: 6, y: -2 },
+          { x: 2.2, y: -2 },
+          { x: 4, y: 0 },
+        ]} />
+      </footprint>
+      } />
+    </board>
+  )
+  `}
+/>

From 91771b2b1064019f7b4835585fde078d98012ef9 Mon Sep 17 00:00:00 2001
From: Rahul Nailoo <rahulsinghnailoo@gmail.com>
Date: Tue, 21 Oct 2025 00:17:29 +0530
Subject: [PATCH 2/2] Update done

---
 docs/tutorials/building-capacitive-touch-sensor.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/tutorials/building-capacitive-touch-sensor.mdx b/docs/tutorials/building-capacitive-touch-sensor.mdx
index fac9bce..a714b4a 100644
--- a/docs/tutorials/building-capacitive-touch-sensor.mdx
+++ b/docs/tutorials/building-capacitive-touch-sensor.mdx
@@ -12,6 +12,8 @@ Capacitive touch sensors replace mechanical buttons with copper shapes that dete
 - Route the traces, ground reference, and LED indicator for feedback.
 - Simulate the PCB stackup with `tscircuit` before ordering the board.
 
+import CircuitPreview from "@site/src/components/CircuitPreview"
+
 The finished design exposes a responsive touch pad that lights an LED when it is activated.
 
 <CircuitPreview