Skip to content
Back to search

step.parts

12,000+ open source STEP parts for your next CAD project

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/earthtojake--step-parts/badge.svg)](/listings/earthtojake--step-parts)

HTML

<a href="/listings/earthtojake--step-parts"><img src="/api/listings/earthtojake--step-parts/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 101 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img alt="step.parts social preview" src="public/step-parts-social-preview.png" width="720">
  3. </p>
  4. <h1 align="center">🔩 step.parts 🔩</h1>
  5. <p align="center">
  6. <a href="https://www.step.parts">Directory</a>
  7. ·
  8. <a href="https://x.com/earthtojake">@earthtojake</a>
  9. </p>
  10. <p align="center">
  11. <a href="https://nextjs.org/"><img alt="Next.js" src="https://img.shields.io/badge/Next.js-16.2.6-000000?logo=nextdotjs&amp;logoColor=white"></a>
  12. <a href="https://react.dev/"><img alt="React" src="https://img.shields.io/badge/React-19.2.4-149eca?logo=react&amp;logoColor=white"></a>
  13. <a href="https://www.typescriptlang.org/"><img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.x-3178c6?logo=typescript&amp;logoColor=white"></a>
  14. <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
  15. <a href="DEVELOPMENT.md#catalog-and-assets"><img alt="Catalog" src="https://img.shields.io/badge/catalog-STEP%20%2B%20Blob%20previews-2f6f73"></a>
  16. <a href="DEVELOPMENT.md#preview-assets"><img alt="Assets" src="https://img.shields.io/badge/previews-Vercel%20Blob-000000"></a>
  17. </p>
  18. <p align="center">16,000+ open source STEP parts for your next CAD project</p>
  19. ## 🧱 Parts
  20. step.parts is a searchable directory of open-source STEP models for parts you can drop into CAD assemblies, robot builds, electronics layouts, and mechanical prototypes. Each catalog entry pairs a canonical STEP file with human-authored metadata and generated preview assets.
  21. You can find components such as:
  22. - **🔩 Fasteners and hardware:** screws, nuts, washers, pins, spacers, standoffs, and threaded parts
  23. - **📐 Stock and structural parts:** extrusion profiles, plates, brackets, helper geometry, and enclosure pieces
  24. - **⚙️ Motion and power transmission parts:** bearings, gears, pulleys, shafts, belts, and linear-motion components
  25. - **🔌 Electronics and thermal parts:** development boards, modules, connectors, sensors, heatsinks, and fans
  26. - **🤖 Actuators and robotics parts:** servos, motors, robot actuators, gear reducers, and related mounting hardware
  27. ## 🧰 Contributions
  28. Contributions must be made with pull requests. Create a branch, make your catalog changes locally, run the relevant checks, and open a PR for review rather than pushing directly to `main`.
  29. Use the add-part helper to add STEP files to the catalog:
  30. ```bash
  31. npm run catalog:add
  32. ```
  33. The command prompts for a local STEP file path, part metadata, tags, aliases, optional standard details, and attributes. It generates the part id, copies the STEP file into the catalog, updates the source catalog, refreshes SQLite catalog metadata, exports GLB/PNG previews, and validates everything.
  34. Preview the generated record without writing files:
  35. ```bash
  36. npm run catalog:add -- --dry-run --step /path/to/part.step --name "Example part" --category fastener --family socket-head-cap-screw --tag screw --attr thread=M3
  37. ```
  38. Before opening the PR, review:
  39. - the new source entry in `catalog/parts.json`
  40. - the canonical STEP file in `catalog/step/`
  41. - regenerated SQLite catalog in `catalog/parts.sqlite`
  42. - generated preview URLs; local `public/glb/` and `public/png/` files should not be committed
  43. Then run the relevant checks:
  44. ```bash
  45. npm run catalog:check
  46. npm run lint
  47. npx tsc --noEmit
  48. ```
  49. See [`TAGGING.md`](TAGGING.md) for tag conventions and [`DEVELOPMENT.md`](DEVELOPMENT.md) for catalog schema, asset generation, and deployment details.
  50. ## 💻 Local Development
  51. Use Node.js 22.5 or newer. The repo includes `.nvmrc`, so `nvm use` will select the same major version used by CI.
  52. ```bash
  53. npm install
  54. npm run dev
  55. ```
  56. Open [http://localhost:3000](http://localhost:3000).
  57. For catalog generation, preview assets, validation, and deployment notes, see [`DEVELOPMENT.md`](DEVELOPMENT.md).
  58. ## 🧪 API
  59. The public API lives under `https://api.step.parts/v1`. The app also uses the same `/v1` routes locally for server-side search, filtering, downloads, and pagination.
  60. Common lookups:
  61. - `https://api.step.parts/v1/parts?pageSize=100`
  62. - `https://api.step.parts/v1/parts?q=M3&tag=screw&page=2`
  63. - `https://api.step.parts/v1/parts?category=fastener&family=socket-head-cap-screw&standard=ISO%204762`
  64. - `https://api.step.parts/v1/parts?q=lengthMm%2012`
  65. Machine-readable docs are available at `https://api.step.parts/v1/openapi.json`, `https://api.step.parts/v1/catalog/schema`, and `https://api.step.parts/v1/catalog/parts.index.json`.
  66. ## 🌐 License
  67. This repository is MIT-licensed for original project material.
  68. Some STEP/model files are copied from, modified from, adapted from, or generated using clearly licensed third-party model sources. The MIT License does not relicense third-party-derived STEP/model files. See [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md) for source, attribution, modification, and license details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.