Troubleshooting

Codex ribbon is missing

• Confirm you are running the targeted Revit 2025 build.
• Ask the prototype maintainer to check the approved local registration and assembly paths while Revit is closed.
• Rebuilding removes local development signatures; signing must be repeated before restarting Revit where applicable.
• Do not disable Revit security checks or change certificate trust to suppress a warning. There is no production installer or signing identity yet.

Commands are disabled

Open a project document. The ribbon commands are not enabled in a family document or when no project is open.

Input cannot be read

Confirm the selected input is DXF (AutoCAD 2000 or newer), not a renamed DWG, and the second selected file is the mapping JSON. Validate JSON syntax if you edited the mapping. Preserve the original files and report the exact diagnostic.

No model-space entities

Check that the detail is in model space. Paper space, unused layers, and nested block contents are not expanded by the current reader.

Missing layers or target types

Compare exact layer/type names, including case. Recreate the mapping using the open project's styles. A mapping created for another template may refer to types absent from this project. Codex skips missing mappings or target types instead of assigning replacements.

Nothing remains importable

Review unsupported entity kinds, unmapped layers, unavailable target types, invalid boundaries, and short geometry. No drafting view is created when all entities are rejected. A region mapping does not make a hatch or circle supported.

Text size differs

Verify units and view scale, then check the approved mapped type's paper size. Codex warns about size differences and uses the existing type unchanged. Review text extents and anchoring; it does not promise matching CAD font metrics.

Import fails or rolls back

Keep the diagnostic and reproduce only in a disposable project. The code is designed to roll back the new view and elements on transaction failure, but host validation of this behavior remains pending. Verify the document state before retrying; do not repeat failures in production files.

Reporting a problem safely

There is no public support portal or upload service yet. Share a sanitized description through an approved private channel: Revit/build version, the operation, expected result, and diagnostic text with local paths, project names, and firm-specific identifiers removed. Prefer a wholly synthetic reproduction. Do not post client drawings, RVTs, families, mappings, screenshots with sensitive content, or credentials to public issues.