Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

File formats at a glance

This chapter lists every file type the app reads and writes, what each carries and what is lost, and then describes the part file itself.

What the app opens

All lengths are millimetres inside the app. Formats that carry other units are converted on the way in.

FormatExtensionHow to openYou getWhat is lost
CivilKit CAD part.ckpart, .json, .ckpart.gzOpen, dropThe full editable partNothing
STEP.step, .stpOpen, drop, More file actionsA part feature saved with the part (or a view-only solid, your choice in the import box)The history; colours, names, assembly structure
SolidWorks part.sldprtOpen, drop, More file actionsAn editable imported body (view-only if it cannot be built)The feature tree, sketches, configurations, annotations
SketchUp.skpOpen, drop, More file actionsA reference mesh saved with the part, with its colours (or a view-only surface model, your choice in the import box)Scenes, text, dimensions, curves as true arcs
STL.stlOpen, drop, More file actionsA reference mesh saved with the partColours, textures
OBJ.objOpen, drop (with its .mtl for colours), More file actionsA reference mesh saved with the part, with colours when the .mtl comes with itNormals, textures, smoothing groups, lines; objects are joined into one mesh
glTF binary.glbOpen, drop, More file actionsA reference mesh saved with the part, with its colours (metres and Y up converted)Textures, animation, vertex colours; compressed or multi-file glTF is refused
3MF.3mfOpen, drop, More file actionsA reference mesh saved with the part, with its colours and unitTextures, colour gradients, print supports; build items are joined into one mesh
FreeCAD.FCStdOpen, dropAn editable part for the features that mapFeatures that do not map; the rest of the document
SolidCraft.solidcraftOpen, dropAn editable part for the features that mapFeatures that do not map are kept as suppressed placeholders
DXF.dxfHome > Sketch group, or dropSketch geometry (lines, arcs, circles, splines, points)Text, hatches, dimensions, blocks, 3D entities
SVG.svgHome > Sketch group, or dropSketch geometry (paths, rectangles, circles, ellipses, lines, polygons)Text, images, fills, strokes, gradients, clip paths

DWG cannot be imported yet. “View only” means you can look at the body and turn the model, but it is not a feature, it is not saved with the part and the next edit replaces it. Importing has the details and limits of each.

What the app writes

FormatExtensionWhereCarriesWhat is lost
CivilKit CAD part.ckpart, .ckpart.gzSave, Save asThe recipe and the app’s own dataNothing
STEP.stepExportThe exact solidColours, history
STL (binary or ASCII).stlExportA triangle meshThe exact surfaces, colours, history
OBJ.objExportA triangle mesh, one object per bodyThe exact surfaces, history
3MF.3mfExportA triangle mesh for 3D printing, one object per body, with body coloursThe exact surfaces, history
glTF binary.glbExportA triangle mesh for viewers and the web, one node per bodyThe exact surfaces, history
DXF, sketch.dxfExportOne sketch as R12 2D geometryConstraints, dimensions
DXF, three views.dxfExportFront, top and right views of the edgesHidden lines, dimensions
Drawing.pdf, .svg, .dxfDrawing viewThe sheet as drawnThe link to the part
Bill of materials.csvAssembly > Bill of materialsThe tableNothing

Exporting describes each one and its options.

The part file

A part file is one JSON document in a text file, and is what Save writes. You can open it in any text editor, keep it in version control and diff it. Its main parts are:

FieldMeaning
format and versionTell the reader what it is looking at. The format string is ck-part.
nameThe part name shown in the top bar.
featuresThe ordered list of features: sketches, planes, extrudes, fillets and so on, with all their settings. The kernel replays them from first to last to build the model.
variablesThe equations and variables of the part.
materialThe name of the material, such as “Aluminium 6061”. Density and colour are looked up by name.

The file does not store the model’s faces. It stores how to rebuild them, which is why parametric edits work after you reopen a file, and why a file of a few kilobytes can describe a detailed part. For the complete field list, the feature types and how references to faces stay stable, see the kernel book chapter Overview of the part format.

Other data the app keeps in the same file when you use it:

  • A preview picture (a small PNG of the part in the isometric view), used for the recent list. It is refreshed when you save and is never read as part of the model.
  • The stored view if you chose Save geometry in file (see Saving and opening). It is a cache; removing it is always safe. The MCP export tool can also write it (cache: true), and the app tells you when it ignores one that does not match the file or this build.
  • Drawings, the exploded view of an assembly, the colours, opacity and finish of bodies and body names, an embedded script and the fonts used by text.
  • Configurations and variables that you defined.

Fields that the app does not know are left alone and written back, so a file edited elsewhere does not lose data.

Files from earlier versions

Files saved by earlier versions of the app still open. They are converted to the current format when read, and the next save writes the current format. A file that was made by a newer version still opens, with a notice that some features may be missing or wrong. See Versions and earlier files in the kernel book.

Compressed and plain

.ckpart.gz is the same file compressed with gzip. The app reads it without any extra step. A program that wants the text must decompress it first.

Units

A part has no unit setting. Everything is millimetres, in the file and in the interface, and this is also what Measure, Mass properties and the exports use.

Where the model comes from

The kernel does the geometry. Its own book covers the part format, the checks that decide whether a model is valid, and the import and export readers at a deeper level than this guide: start at the kernel book, and see Validation for what makes a solid valid.

Next