An archive is useful only if it contains enough information to recover the intended design state. A ZIP file that opens successfully may still lack custom libraries, output settings, scripts, or external dependencies needed to recreate the released manufacturing package. Test recovery before the original working environment disappears.
The KiCad 10 project manual describes project archive and output-job facilities. Read the behavior for the version being used, then inspect what your archive actually contains. An archive command should not be assumed to capture every external resource on the author’s computer.
Define the recovery target
List the outputs the archive must reproduce: fabrication data, drill files, BOM, placement information, assembly drawings, and any required mechanical deliverable. Record the design revision, tool version, library baseline, output settings, and scripts or plugins used in generation.
Keep the approved release outputs as a comparison reference. Rebuilding without a reference may reveal missing files but cannot show whether the regenerated package represents the same geometry and component population. Keep the comparison outputs in a separate directory with a recovery-test identifier, so they cannot be mistaken for a newly approved manufacturing release or accidentally overwrite the historical package.
Recover in a clean location
- Extract the archive outside the original working directory.
- Open it with the documented application environment.
- Resolve dependencies using only the supplied package and documented resources.
- Run the relevant design checks.
- Generate the required outputs into a new directory.
- Compare them with the approved release.
Do not quietly reconnect the recovered project to the author’s personal library folders. If recovery needs an additional resource, record it as a missing dependency and improve the package. Otherwise, the test has only recreated the original hidden assumption.
Compare content, not only filenames
| Output | Meaningful comparison |
|---|---|
| Fabrication layers | Geometry, layer identity, and alignment |
| Drill data | Hole definitions, locations, and grouping |
| BOM and placement | Reference population, part identity, and positions |
| Drawings | Revision, dimensions, notes, and component references |
Some generated files contain timestamps or other metadata that change without altering the design. Separate those expected differences from geometry, connectivity, or population changes. A raw file mismatch is a prompt for investigation, not automatic proof that the recovered design is wrong.
Close the recovery test with a manifest of required resources and the comparison result. If migration to another software version is necessary, record it as a separate controlled step rather than overwriting the historical archive. For model-specific dependencies, see the 3D path portability review.
Move from reading to a build-ready project
Use the fabrication and assembly checklists to prepare drawings, production files and test requirements.
Open the DFM checklist