hackclub · qcoral · Feb 10, 2025 · Feb 8, 2025 · Feb 8, 2025 · Feb 8, 2025
diff --git a/hackpads/Duccs Fidget Toy/CAD/Case.20250210-205706.FCBak b/hackpads/Duccs Fidget Toy/CAD/Case.20250210-205706.FCBak
diff --git a/hackpads/Duccs Fidget Toy/CAD/Case.FCStd b/hackpads/Duccs Fidget Toy/CAD/Case.FCStd
diff --git a/hackpads/Duccs Fidget Toy/CAD/Case.stl b/hackpads/Duccs Fidget Toy/CAD/Case.stl
diff --git a/hackpads/Duccs Fidget Toy/CAD/Plate.20250210-204049.FCBak b/hackpads/Duccs Fidget Toy/CAD/Plate.20250210-204049.FCBak
diff --git a/hackpads/Duccs Fidget Toy/CAD/Plate.FCStd b/hackpads/Duccs Fidget Toy/CAD/Plate.FCStd
diff --git a/hackpads/Duccs Fidget Toy/CAD/Plate.stl b/hackpads/Duccs Fidget Toy/CAD/Plate.stl
diff --git a/website/public/docs/v2/1sketch2.png b/website/public/docs/v2/1sketch2.png
diff --git a/website/public/docs/v2/3d-view.png b/website/public/docs/v2/3d-view.png
diff --git a/website/public/docs/v2/3dmodels.png b/website/public/docs/v2/3dmodels.png
diff --git a/website/public/docs/v2/3dwithcomponents.png b/website/public/docs/v2/3dwithcomponents.png
diff --git a/website/public/docs/v2/addtext.png b/website/public/docs/v2/addtext.png
diff --git a/website/public/docs/v2/align.png b/website/public/docs/v2/align.png
diff --git a/website/public/docs/v2/body.png b/website/public/docs/v2/body.png
diff --git a/website/public/docs/v2/circletool.png b/website/public/docs/v2/circletool.png
diff --git a/website/public/docs/v2/compfrontback.png b/website/public/docs/v2/compfrontback.png
diff --git a/website/public/docs/v2/copyfootprint.png b/website/public/docs/v2/copyfootprint.png
diff --git a/website/public/docs/v2/correctneopixel3d.png b/website/public/docs/v2/correctneopixel3d.png
diff --git a/website/public/docs/v2/deletelayer.png b/website/public/docs/v2/deletelayer.png
diff --git a/website/public/docs/v2/dimension.png b/website/public/docs/v2/dimension.png
diff --git a/website/public/docs/v2/doneplatesketch.png b/website/public/docs/v2/doneplatesketch.png
diff --git a/website/public/docs/v2/draft.png b/website/public/docs/v2/draft.png
diff --git a/website/public/docs/v2/drafttosketch.png b/website/public/docs/v2/drafttosketch.png
diff --git a/website/public/docs/v2/edgecuts.png b/website/public/docs/v2/edgecuts.png
diff --git a/website/public/docs/v2/edgecutsselect.png b/website/public/docs/v2/edgecutsselect.png
diff --git a/website/public/docs/v2/edges.png b/website/public/docs/v2/edges.png
diff --git a/website/public/docs/v2/editfootprint.png b/website/public/docs/v2/editfootprint.png
diff --git a/website/public/docs/v2/editgrid.png b/website/public/docs/v2/editgrid.png
diff --git a/website/public/docs/v2/expandersym.png b/website/public/docs/v2/expandersym.png
diff --git a/website/public/docs/v2/expanderwired.png b/website/public/docs/v2/expanderwired.png
diff --git a/website/public/docs/v2/exportstep.png b/website/public/docs/v2/exportstep.png
diff --git a/website/public/docs/v2/externalgeometry.png b/website/public/docs/v2/externalgeometry.png
diff --git a/website/public/docs/v2/finalpcb.png b/website/public/docs/v2/finalpcb.png
diff --git a/website/public/docs/v2/footprinteditor.png b/website/public/docs/v2/footprinteditor.png
diff --git a/website/public/docs/v2/freecadbase.png b/website/public/docs/v2/freecadbase.png
diff --git a/website/public/docs/v2/freecadbaseextrude.png b/website/public/docs/v2/freecadbaseextrude.png
diff --git a/website/public/docs/v2/freecadbasewhole.png b/website/public/docs/v2/freecadbasewhole.png
diff --git a/website/public/docs/v2/freecadbothole.png b/website/public/docs/v2/freecadbothole.png
diff --git a/website/public/docs/v2/freecadcase.png b/website/public/docs/v2/freecadcase.png
diff --git a/website/public/docs/v2/freecadfinal.png b/website/public/docs/v2/freecadfinal.png
diff --git a/website/public/docs/v2/freecadholesketch.png b/website/public/docs/v2/freecadholesketch.png
diff --git a/website/public/docs/v2/freecadkeyhole.png b/website/public/docs/v2/freecadkeyhole.png
diff --git a/website/public/docs/v2/freecadpad.png b/website/public/docs/v2/freecadpad.png
diff --git a/website/public/docs/v2/freecadplatehole.png b/website/public/docs/v2/freecadplatehole.png
diff --git a/website/public/docs/v2/freecadpocket.png b/website/public/docs/v2/freecadpocket.png
diff --git a/website/public/docs/v2/freecadpocket2.png b/website/public/docs/v2/freecadpocket2.png
diff --git a/website/public/docs/v2/freecadproperty.png b/website/public/docs/v2/freecadproperty.png
diff --git a/website/public/docs/v2/freecadrectangle.png b/website/public/docs/v2/freecadrectangle.png
diff --git a/website/public/docs/v2/freecadselect.png b/website/public/docs/v2/freecadselect.png
diff --git a/website/public/docs/v2/freecadtrimedge.png b/website/public/docs/v2/freecadtrimedge.png
diff --git a/website/public/docs/v2/freecadtrimmed.png b/website/public/docs/v2/freecadtrimmed.png
diff --git a/website/public/docs/v2/freecadusbsketch.png b/website/public/docs/v2/freecadusbsketch.png
diff --git a/website/public/docs/v2/frontback.png b/website/public/docs/v2/frontback.png
diff --git a/website/public/docs/v2/fusionalmost.png b/website/public/docs/v2/fusionalmost.png
diff --git a/website/public/docs/v2/fusioncase.png b/website/public/docs/v2/fusioncase.png
diff --git a/website/public/docs/v2/fusioncasehalf.png b/website/public/docs/v2/fusioncasehalf.png
diff --git a/website/public/docs/v2/fusioncircle.png b/website/public/docs/v2/fusioncircle.png
diff --git a/website/public/docs/v2/fusioncircle2.png b/website/public/docs/v2/fusioncircle2.png
diff --git a/website/public/docs/v2/fusioncircledim.png b/website/public/docs/v2/fusioncircledim.png
diff --git a/website/public/docs/v2/fusioncoincident.png b/website/public/docs/v2/fusioncoincident.png
diff --git a/website/public/docs/v2/fusioncomp.png b/website/public/docs/v2/fusioncomp.png
diff --git a/website/public/docs/v2/fusiondim.png b/website/public/docs/v2/fusiondim.png
diff --git a/website/public/docs/v2/fusionextrude.png b/website/public/docs/v2/fusionextrude.png
diff --git a/website/public/docs/v2/fusionextrude2.png b/website/public/docs/v2/fusionextrude2.png
diff --git a/website/public/docs/v2/fusionextrudemenu.png b/website/public/docs/v2/fusionextrudemenu.png
diff --git a/website/public/docs/v2/fusionfinalsketch.png b/website/public/docs/v2/fusionfinalsketch.png
diff --git a/website/public/docs/v2/fusionfinishsketch.png b/website/public/docs/v2/fusionfinishsketch.png
diff --git a/website/public/docs/v2/fusiongfinaltop.png b/website/public/docs/v2/fusiongfinaltop.png
diff --git a/website/public/docs/v2/fusionhole.png b/website/public/docs/v2/fusionhole.png
diff --git a/website/public/docs/v2/fusionholes.png b/website/public/docs/v2/fusionholes.png
diff --git a/website/public/docs/v2/fusionholetool.png b/website/public/docs/v2/fusionholetool.png
diff --git a/website/public/docs/v2/fusionlock.png b/website/public/docs/v2/fusionlock.png
diff --git a/website/public/docs/v2/fusionmidcircle.png b/website/public/docs/v2/fusionmidcircle.png
diff --git a/website/public/docs/v2/fusionnewdesign.png b/website/public/docs/v2/fusionnewdesign.png
diff --git a/website/public/docs/v2/fusionplate.png b/website/public/docs/v2/fusionplate.png
diff --git a/website/public/docs/v2/fusionplatefinal.png b/website/public/docs/v2/fusionplatefinal.png
diff --git a/website/public/docs/v2/fusionrect.png b/website/public/docs/v2/fusionrect.png
diff --git a/website/public/docs/v2/fusionrect2.png b/website/public/docs/v2/fusionrect2.png
diff --git a/website/public/docs/v2/fusionrect3.png b/website/public/docs/v2/fusionrect3.png
diff --git a/website/public/docs/v2/fusionselect.png b/website/public/docs/v2/fusionselect.png
diff --git a/website/public/docs/v2/fusionshow.png b/website/public/docs/v2/fusionshow.png
diff --git a/website/public/docs/v2/fusiontop.png b/website/public/docs/v2/fusiontop.png
diff --git a/website/public/docs/v2/goodsketch.png b/website/public/docs/v2/goodsketch.png
diff --git a/website/public/docs/v2/grid.png b/website/public/docs/v2/grid.png
diff --git a/website/public/docs/v2/halfdonefreecadsketch.png b/website/public/docs/v2/halfdonefreecadsketch.png
diff --git a/website/public/docs/v2/holefreecad.png b/website/public/docs/v2/holefreecad.png
diff --git a/website/public/docs/v2/keymatrixdiode.png b/website/public/docs/v2/keymatrixdiode.png
diff --git a/website/public/docs/v2/keymatrixschematic.png b/website/public/docs/v2/keymatrixschematic.png
diff --git a/website/public/docs/v2/keymatrixschematicassign.png b/website/public/docs/v2/keymatrixschematicassign.png
diff --git a/website/public/docs/v2/keymatrixschematicconnected.png b/website/public/docs/v2/keymatrixschematicconnected.png
diff --git a/website/public/docs/v2/keymatrixschematicdiode.png b/website/public/docs/v2/keymatrixschematicdiode.png
diff --git a/website/public/docs/v2/kicadusbdist.png b/website/public/docs/v2/kicadusbdist.png
diff --git a/website/public/docs/v2/neoassoc.png b/website/public/docs/v2/neoassoc.png
diff --git a/website/public/docs/v2/neoedit.png b/website/public/docs/v2/neoedit.png
diff --git a/website/public/docs/v2/neofinal.png b/website/public/docs/v2/neofinal.png
diff --git a/website/public/docs/v2/neomiddle.png b/website/public/docs/v2/neomiddle.png
diff --git a/website/public/docs/v2/neopixel3d.png b/website/public/docs/v2/neopixel3d.png
diff --git a/website/public/docs/v2/newfreecad.png b/website/public/docs/v2/newfreecad.png
diff --git a/website/public/docs/v2/newlibrary.png b/website/public/docs/v2/newlibrary.png
diff --git a/website/public/docs/v2/newsketch.png b/website/public/docs/v2/newsketch.png
diff --git a/website/public/docs/v2/oledassoc.png b/website/public/docs/v2/oledassoc.png
diff --git a/website/public/docs/v2/oledhalfschem.png b/website/public/docs/v2/oledhalfschem.png
diff --git a/website/public/docs/v2/oledschem.png b/website/public/docs/v2/oledschem.png
diff --git a/website/public/docs/v2/oledsymbol.png b/website/public/docs/v2/oledsymbol.png
diff --git a/website/public/docs/v2/pastefootprint.png b/website/public/docs/v2/pastefootprint.png
diff --git a/website/public/docs/v2/pcbsize.png b/website/public/docs/v2/pcbsize.png
diff --git a/website/public/docs/v2/placedfootprints.png b/website/public/docs/v2/placedfootprints.png
diff --git a/website/public/docs/v2/pouradd.png b/website/public/docs/v2/pouradd.png
diff --git a/website/public/docs/v2/pouraddvias.png b/website/public/docs/v2/pouraddvias.png
diff --git a/website/public/docs/v2/pouraddzone.png b/website/public/docs/v2/pouraddzone.png
diff --git a/website/public/docs/v2/pourfilled.png b/website/public/docs/v2/pourfilled.png
diff --git a/website/public/docs/v2/pourfinish.png b/website/public/docs/v2/pourfinish.png
diff --git a/website/public/docs/v2/pourstart.png b/website/public/docs/v2/pourstart.png
diff --git a/website/public/docs/v2/realfinalpcb.png b/website/public/docs/v2/realfinalpcb.png
diff --git a/website/public/docs/v2/righttoolbar.png b/website/public/docs/v2/righttoolbar.png
diff --git a/website/public/docs/v2/rotarysym.png b/website/public/docs/v2/rotarysym.png
diff --git a/website/public/docs/v2/rotarywired.png b/website/public/docs/v2/rotarywired.png
diff --git a/website/public/docs/v2/roundedrect.png b/website/public/docs/v2/roundedrect.png
diff --git a/website/public/docs/v2/roundedrect2.png b/website/public/docs/v2/roundedrect2.png
diff --git a/website/public/docs/v2/routing.png b/website/public/docs/v2/routing.png
diff --git a/website/public/docs/v2/ruler.png b/website/public/docs/v2/ruler.png
diff --git a/website/public/docs/v2/selectsketch.png b/website/public/docs/v2/selectsketch.png
diff --git a/website/public/docs/v2/silkbadsilk.png b/website/public/docs/v2/silkbadsilk.png
diff --git a/website/public/docs/v2/silkconverter.png b/website/public/docs/v2/silkconverter.png
diff --git a/website/public/docs/v2/silkfinal.png b/website/public/docs/v2/silkfinal.png
diff --git a/website/public/docs/v2/silkfinal3d.png b/website/public/docs/v2/silkfinal3d.png
diff --git a/website/public/docs/v2/silkgoodsilk.png b/website/public/docs/v2/silkgoodsilk.png
diff --git a/website/public/docs/v2/silkgura.png b/website/public/docs/v2/silkgura.png
diff --git a/website/public/docs/v2/silkoptions.png b/website/public/docs/v2/silkoptions.png
diff --git a/website/public/docs/v2/swoffset.png b/website/public/docs/v2/swoffset.png
diff --git a/website/public/docs/v2/toplength.png b/website/public/docs/v2/toplength.png
diff --git a/website/public/docs/v2/updatefromlib.png b/website/public/docs/v2/updatefromlib.png
diff --git a/website/public/docs/v2/validatesketch.png b/website/public/docs/v2/validatesketch.png
diff --git a/website/public/docs/v2/via.png b/website/public/docs/v2/via.png
diff --git a/website/public/docs/v2/xiaohead.png b/website/public/docs/v2/xiaohead.png
diff --git a/website/src/components/SideBar.tsx b/website/src/components/SideBar.tsx
@@ -13,6 +13,11 @@ const SideBar = () => {
               DIY Guide
             </a>
           </li>
+          <li>
+            <a href="/advancedguide" className="block py-2 px-4 rounded hover:bg-slate-200 transition-all text-slate-900 hover:text-cyan-800">
+              Advanced DIY guide
+            </a>
+          </li>
           <li>
             <a href="/resources" className="block py-2 px-4 rounded hover:bg-slate-200 transition-all text-slate-900 hover:text-cyan-800">
               Resources & Tips
@@ -44,4 +49,4 @@ const SideBar = () => {
   );
 };
 
-export default SideBar;
+export default SideBar;
diff --git a/website/src/main.tsx b/website/src/main.tsx
@@ -3,6 +3,8 @@ import { createRoot } from "react-dom/client";
 import App from "./App.tsx";
 
 import Tutorial from "./pages/hackpad/Tutorial.mdx";
+import AdvancedTutorial from "./pages/hackpad/AdvancedTutorial.mdx";
+import Errors from "./pages/hackpad/Errors.mdx";
 import Submission from "./pages/hackpad/Submission.mdx";
 import ApprovedParts from "./pages/hackpad/ApprovedParts.mdx";
 import Faq from "./pages/hackpad/Faq.mdx";
@@ -36,9 +38,13 @@ const router = createBrowserRouter([
       <DocPage Content={Tutorial} SideBar={ SideBar } />
     ),
   },
+  {
+    path: "/advancedguide",
+    element: <DocPage Content={ AdvancedTutorial } SideBar={ SideBar } />,
+  },
   {
     path: "/submitting",
-    element: <DocPage Content={Submission} SideBar={ SideBar } />,
+    element: <DocPage Content={ Submission } SideBar={ SideBar } />,
   },
   {
     path: "/parts",
@@ -60,6 +66,10 @@ const router = createBrowserRouter([
     path: "/get-keycap",
     element: <DocPage Content={ GetKeycap } SideBar={ SideBar } />,
   },
+  {
+    path: "/errors",
+    element: <DocPage Content={ Errors } SideBar={ SideBar } />,
+  },
   {
     path: "/keyboard",
     element: <DocPage Content={ Overview } SideBar={ SideBarKeyboard } />,

diff --git a/website/src/pages/hackpad/AdvancedTutorial.mdx b/website/src/pages/hackpad/AdvancedTutorial.mdx
diff --git a/website/src/pages/hackpad/DesignTips.mdx b/website/src/pages/hackpad/DesignTips.mdx
diff --git a/website/src/pages/hackpad/Errors.mdx b/website/src/pages/hackpad/Errors.mdx
@@ -0,0 +1,60 @@
+# DRC error code compliation
+
+Oh no! You have DRC errors? Don't worry, we got you covered. Here is a compliation of most error codes: (Press Control+F to search)
+
+Try looking into the unconnected items tab too!
+
+- Warning: Silkscreen clipped by solder mask:
+- Warning: Silkscreen clipped by board edge:
+- Warning: Footprint component type doesn't match footprint pads:
+- Warning: Footprint has no courtyard defined:
+
+Ignore, this has no importance
+
+- Warning: Text height out of range:
+
+Ignore, this has no importance (Your text might not get printed properly tho)
+
+- Warning: Trace has unconnected end:
+
+Click on the text and you should see a trace with a yellow arrow on it. Delete that trace since it has no use. (Or maybe did you forget to connect it?)
+
+- Warning: PTH inside courtyard:
+
+It might be a false-alarm, but double check if you accidently put some component on top of another one.
+
+- Warning: Footprint 'xxxxxxxx' does not match copy in library 'xxx'
+
+Open Tools > Update Footprints from Library. Select everything inside "Update Options" and click Update.
+
+- Warning: Footprint 'xxxxxxxx' not found in library 'xxx'
+
+You are probably missing a library! Or try re-assigning the footprints.
+
+- Warning: Board edge clearance violation:
+
+Your traces/pads are too close to the edge of the board. (If you are using my neopixel footprint, ignore it. I might have put the pads a little tooo close to the borders, but it won't break anything. Sowwy~~ UwU)
+
+- Error: Board has malformed outline:
+
+Important! You forgot to add Edge.Cuts outline/ The Edge.Cuts outline isn't closed properly
+
+- Error: Track has unconnected end:
+
+Important! You forgot to join two components! Check if there are thin blue lines present.
+
+- Error: Courtyards overlap:
+
+Important! Some of the components are overlapping (physically), click on the text to check which one.
+
+- Error: Hole clearance violation:
+
+Important! Something is too close to the holes, it will get drilled out
+
+- Error: Items shorting two nets:
+
+Important! You got two wires connected that shouldn't be connected! Click on the text to check out which ones.
+
+- Error: Missing connection between items
+
+Important! You two pads aren't connected together! Click on the error message to find out which ones
diff --git a/website/src/pages/hackpad/Faq.mdx b/website/src/pages/hackpad/Faq.mdx
@@ -47,5 +47,8 @@ You can! We'll have V2's at HQ. note: please use 19.05x19.05mm spacing, or else
 **I have more questions!!!**  \
 Join the #hackpad channel in the Hack Club slack!
 
+**What are the footprint name for diodes/resistors?**
+Diodes are D_DO-35_SOD27_P7.62mm_Horizontal.
 
+Resistors are R_Axial_DIN0204_L3.6mm_D1.6mm_P7.62mm_Horizontal
 
diff --git a/website/src/pages/hackpad/Resources.mdx b/website/src/pages/hackpad/Resources.mdx
@@ -5,6 +5,8 @@ With that in mind, there are *thousands* of other resources on the internet that
 
 If a guide doesn't seem to work, try it again. If it *really* doesn't work, try another guide! The magic of it is to keep at it, because if so many other teens can do it, you absolutely can too.
 
+There is also a list of [common DRC errors here](/errors)
+
 ## KiCad Libraries
 - [Keyswitch footprints](https://github.com/ai03-2725/MX_V2)
 - [XIAO Footprints](https://github.com/Seeed-Studio/OPL_Kicad_Library)
@@ -29,6 +31,7 @@ It has an OLED, a rotary encoder, 4 switches in a matrix, 2 addressable LEDs, an
 - [XIAO RP2040 Docs](https://wiki.seeedstudio.com/XIAO-RP2040/)
 - [Anatomy of a keyboard](https://matt3o.com/anatomy-of-a-keyboard/)
 - [Keyboard Mounting Styles](https://www.keyboard.university/200-courses/keyboard-mounting-styles-4lpp7)
+- [Holo's PCB Routing Commandments](https://libsharedobject.so/howsmypcb.html)
 
 ## Useful measurements
 - Making holes for your PCB:
@@ -53,6 +56,16 @@ It has an OLED, a rotary encoder, 4 switches in a matrix, 2 addressable LEDs, an
 - Most DIY keyboards are at least partially open source.
 You can go to their git repositories and copy their tolerances/footprints/schematics/whatever
 - You can export your KiCad PCB to a PDF and print them to check measurements
-- Most Keyboards are wired in a matrix to save pins, but if you have 5 or less switches just avoid the matrix altogether
+- Most Keyboards are wired in a matrix to save pins, but if you have 6 or less switches just avoid the matrix altogether
 - For screens, just use a 4-pin header for footprints
 - Adding graphics in KiCad is really annoying. Instead, you can design your entire thing in Figma and import it as an overlay instead
+- Google is your best friend, search up anything u don't know.
+- Spam vias everywhere! They are free.
+- Try routing everything on one layers first, if you can't without making a big loop, move to the second layer. This keeps your board clean.
+- Make multiple revisions! I rerouted my first macropad like 10 times while adding stuff.
+- After routing everything, run Tools > Cleanup Tracks & Vias. You gotta press the Build changes button twice for the optimizations to apply.
+- Use a ground fill, they are good!
+- Try adding capacitors, they will increase your board's stability.
+- With kmk, you can control your mouse with buttons! See [Mouse Keys](https://github.com/KMKfw/kmk_firmware/blob/main/docs/en/mouse_keys.md) in the docs.
+- Maybe use some thicker traces! Edit the trace width a at the top left "Track: use netclass width", click edit predefined and add yours. Then select it in the same menu.
+- Use tunnels to keep your schematic organised.