Files
modeling-app/public/kcl-samples/README.md
Greg Sweeney 2c6d69497c Update KCL samples readme (#5677)
update KCL samples readme
2025-03-08 00:15:36 +00:00

9.0 KiB

kcl-samples

KittyCAD Language (KCL) is our language for defining geometry and working with our Geometry Engine efficiently.

This repository includes a mixture of simple and complex models demonstrating the features and syntax of KCL.

The samples can be browsed in our documentation at https://zoo.dev/docs/kcl-samples.

Guidelines for adding samples

KCL samples conform to a set of style guidelines to ensure consistency and readability.

  1. File Naming: Name your KCL files descriptively and concisely, using hyphens to separate words (e.g., flange.kcl, ball-bearing.kcl).

  2. File Header: Include a title comment at the top of each file, followed by a brief description explaining what the model is and its typical use cases.

  3. Inline Comments: Use inline comments to explain non-obvious parts of the code. Each major section should have a comment describing its purpose.

  4. Constants: Define constants at the beginning of your KCL files for any values that might change or need to be reused (e.g., dimensions, angles).

Snapshot and export

When you submit a PR to add or modify KCL samples, images and STEP files will be generated and added to the repository automatically.


3d-boaty (step) (screenshot)

3d-boaty

80-20-rail (step) (screenshot)

80-20-rail

a-parametric-bearing-pillow-block (step) (screenshot)

a-parametric-bearing-pillow-block

ball-bearing (step) (screenshot)

ball-bearing

bracket (step) (screenshot)

bracket

car-wheel-assembly (step) (screenshot)

car-wheel-assembly

color-cube (step) (screenshot)

color-cube

cycloidal-gear (step) (screenshot)

cycloidal-gear

dodecahedron (step) (screenshot)

dodecahedron

enclosure (step) (screenshot)

enclosure

exhaust-manifold (step) (screenshot)

exhaust-manifold

flange-with-patterns (step) (screenshot)

flange-with-patterns

flange-xy (step) (screenshot)

flange-xy

focusrite-scarlett-mounting-bracket (step) (screenshot)

focusrite-scarlett-mounting-bracket

food-service-spatula (step) (screenshot)

food-service-spatula

french-press (step) (screenshot)

french-press

gear-rack (step) (screenshot)

gear-rack

gear (step) (screenshot)

gear

gridfinity-baseplate-magnets (step) (screenshot)

gridfinity-baseplate-magnets

gridfinity-baseplate (step) (screenshot)

gridfinity-baseplate

gridfinity-bins-stacking-lip (step) (screenshot)

gridfinity-bins-stacking-lip

gridfinity-bins (step) (screenshot)

gridfinity-bins

hex-nut (step) (screenshot)

hex-nut

i-beam (step) (screenshot)

i-beam

kitt (step) (screenshot)

kitt

lego (step) (screenshot)

lego

mounting-plate (step) (screenshot)

mounting-plate

multi-axis-robot (step) (screenshot)

multi-axis-robot

pipe-flange-assembly (step) (screenshot)

pipe-flange-assembly

pipe-with-bend (step) (screenshot)

pipe-with-bend

pipe (step) (screenshot)

pipe

poopy-shoe (step) (screenshot)

poopy-shoe

router-template-cross-bar (step) (screenshot)

router-template-cross-bar

router-template-slate (step) (screenshot)

router-template-slate

sheet-metal-bracket (step) (screenshot)

sheet-metal-bracket

socket-head-cap-screw (step) (screenshot)

socket-head-cap-screw

walkie-talkie (step) (screenshot)

walkie-talkie

washer (step) (screenshot)

washer