diff --git a/CLAUDE.md b/CLAUDE.md
index 3ace50a..8168747 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,5 +1,7 @@
 # tscircuit docs - Development Guidelines
 
+- Use `bun` not `node`/`npx`/`npm`
+
 ## Commands
 
 - **Start development server**: `bun run start`
diff --git a/docs/elements/symbol.mdx b/docs/elements/symbol.mdx
index 9a73b6e..90636a3 100644
--- a/docs/elements/symbol.mdx
+++ b/docs/elements/symbol.mdx
@@ -127,3 +127,9 @@ Within a `<symbol />`, you can use the following primitive components to draw yo
 - [`<schematicline />`](./schematicline.mdx) - Draw straight lines
 - [`<schematicpath />`](./schematicpath.mdx) - Draw connected path segments
 - [`<schematicarc />`](./schematicarc.mdx) - Draw circular arcs
+
+## Viewing Symbol Ports
+
+To visualize the port positions on your schematic symbols, go to **View > Schematic > Show Schematic Ports** in the editor:
+
+![Show schematic ports option in the View menu](/img/show-schematic-ports.gif)
diff --git a/static/img/show-schematic-ports.gif b/static/img/show-schematic-ports.gif
new file mode 100644
index 0000000..ab2d6d9
Binary files /dev/null and b/static/img/show-schematic-ports.gif differ