Skip to content

docs: complete USB flashlight tutorial with step-by-step guide#740

Open
kish-00 wants to merge 2 commits into
tscircuit:mainfrom
kish-00:complete-usb-flashlight-tutorial
Open

docs: complete USB flashlight tutorial with step-by-step guide#740
kish-00 wants to merge 2 commits into
tscircuit:mainfrom
kish-00:complete-usb-flashlight-tutorial

Conversation

@kish-00

@kish-00 kish-00 commented Jun 14, 2026

Copy link
Copy Markdown

Closes #555

This PR replaces the stub USB flashlight tutorial (~42 lines) with a full step-by-step guide following the canonical tutorial structure used by the Buzzer HAT and LED Matrix tutorials.

Changes

  • Complete rewrite of building-a-simple-usb-flashlight.mdx
  • Follows the established tutorial structure: Overview → Objectives → Requirements → Components → Step-by-Step Build → PCB Layout → Ordering → Next Steps
  • Each build step has a self-contained CircuitPreview with proper imports (no forward references)
  • Final overview uses TscircuitIframe with 3D view
  • PCB Layout section includes PCB view
  • Target: ~9,500 chars (matching Buzzer HAT depth)

Design principles followed

  1. Self-contained previews — each CircuitPreview snippet is fully valid with its own imports, avoiding forward reference bugs that killed previous PRs
  2. Incremental build — components added one at a time before wiring in the final step
  3. Canonical structure — mirrors simple-buzzer-hat.mdx layout exactly
  4. Build verifiedbun run build passes without errors

kish-00 added 2 commits June 14, 2026 15:12
Adds examples demonstrating all anchorAlignment options:
- center, top_left, top_right, bottom_left, bottom_right
- center_left, center_right, top_center, bottom_center
- Irregular polygon with anchor alignment

Fixes tscircuit#498
@vercel

vercel Bot commented Jun 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jun 14, 2026 2:07pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Complete the USB Flashlight tutorial

1 participant