Naming Convention

All breakout board directories and files in this repository follow a standardized, lowercase, dash-separated naming scheme for clarity, scalability, and consistency.

Format 

[type]-[footprint]-[variant or feature]

Components

  • type – General category of component:

    • conn – Connectors (e.g., USB, audio jacks, headers, terminal blocks)
    • pwr – Power components (e.g., regulators, converters, relays)
    • mcu – Microcontrollers (bare MCU breakouts)
    • prog – Programming/debug adapters (e.g., ISP, UPDI, SWD)
    • ic – Integrated circuits (op-amps, logic ICs, memory, etc.)
    • sensor – Sensors (temperature, pressure, IMUs, etc.)
    • disp – Displays (OLED, LCD, 7-segment, etc.)
    • passive – Passive components (resistors, capacitors, inductors, pots)
    • input – Input components (switches, buttons, DIP switches)
    • led – LEDs and indicators (discrete, RGB, arrays)
    • misc – Miscellaneous or special-purpose components
    • (More categories like rf or oscil can be added as needed)

  • footprint – Physical package or interface style:

    • For ICs: soic8, tssop14, dip16, qfn32, etc.
    • For connectors: usb-c, usb-micro, rca, audio35, jst-xh-2p, etc.

  • variant or feature (optional) – Additional detail for function, layout, or configuration:

    • Examples: 3p (3-pin), 5x (5 units), dual, combo, proto, sw, pwm, vusb, cc, matrix

  • chip or device name (optional) – Use when a breakout is tailored to a specific part (e.g., icl7660, mcp16252, ws2812b, g2rl-1e)

Examples 

conn-audio35-3p                 → 3.5mm audio jack (3-conductor, 3-pin)
conn-combo-rca2-audio35-5p-2sw  → Dual RCA + 3.5mm combo jack (5-pin, 2 switches)
ic-tssop14-dual                 → Dual TSSOP-14 IC breakout
pwr-mcp16252-boost-sot23        → MCP16252 boost converter breakout