Xenon Labs Help Codex development prototype

Create a mapping

A mapping is a small local JSON file that points each CAD layer at an existing Revit style or type by its exact name. It contains no geometry.

CAD layers on the left point to existing Revit types on the right: DETAIL to a line style, NOTES to a text type, FILL to a filled-region type by explicit opt-in, and TEMP left blank, which is skipped with a diagnostic. Below, a closed polyline becomes a detail-line outline when region conversion is off, and a filled region when it is on with a type selected.
One arrow per layer. Blank layers are skipped and reported, never auto-assigned.

Walkthrough

Open a project made from the firm template (or one containing a vetted drafting detail), choose Codex › Mapping › Create Mapping, and select the DXF.

Schematic of the Codex Create Mapping window with numbered callouts. 1 Style source drop-down. 2 Revit line style for the DETAIL layer. 3 Revit text type with paper size for the NOTES layer. 4 Closed outline to region checkbox ticked with a filled-region type for the FILL layer. 5 TEMP layer left blank. 6 Save Mapping button.
Numbers match the steps below. Layer and type names are placeholders.
  1. Style source: All styles in open project, or Only styles used in active drafting view (available only from a drafting view).
  2. Line style for layers with lines, arcs and polylines.
  3. Text type for text layers. Labels show paper size and font; the file stores exact type names.
  4. Closed outline → region only where closed polylines should become fills, then pick a filled-region type.
  5. Leave unwanted layers blank. They are skipped with diagnostics.
  6. Save Mapping… Replacing an existing file asks for confirmation.

Then run Convert CAD with the same DXF and this mapping.

Creating a mapping only reads the project. Choices start blank; nothing is name-matched automatically. Changing the style source clears choices that are no longer available and shows a notice.

Rules to remember

JSON shape

Placeholders, not real firm names:

{
  "layers": {
    "DETAIL": {
      "lineStyle": "EXACT EXISTING LINE STYLE NAME",
      "textType": "EXACT EXISTING TEXT TYPE NAME"
    },
    "FILL": {
      "filledRegionType": "EXACT EXISTING FILLED REGION TYPE NAME"
    }
  }
}

Include only properties relevant to each layer. Target names missing? See troubleshooting.