Reference guide
Packaging Review
A separate small desktop app for checking the packaging library: models, materials and sizes.
What it is for
Reviewing every packaging model before it is used in ads. The library is on the left, the viewport in the middle, and Materials and Size on the right. It runs on macOS and Windows and lives in review/.
What you can do
- Browse the whole library and look at any model, path traced.
- Change material values and see them rendered correctly, including clearcoat and tinted glass.
- Change a model's dimensions. The app rebuilds it through headless FreeCAD.
- Save a version.
- Switch between ten lighting styles with keys 1 to 9 and 0.
- Set library-wide material defaults.
Saved versions
A saved version is a folder beside the type's built sizes. It holds version.json, the CAD files, a GLB with the reviewed material values written in, and mapping.json with a materials block. Ad Shots lists these versions and applies the values.
Its local API
review/server.cjs uses only Node built-ins. It serves:
| Thing | Detail |
|---|---|
| Packaging library | The same folder Ad Shots reads |
| Rebuilds | Through freecadcmd, found per platform or set with FREECADCMD. Sources come from <library>/_source, else packaging/ |
| Material defaults | <library>/material-overrides.json |
| Lighting | HDRIs from LIBRARY/HDRIS (override REVIEW_HDRIS), served as cached thumbnails and 2k copies |
| Lighting styles | review/hdri-presets.json |
The accurate view stops at 120 samples.
Updated 2026-11-14. Built 2026-11-15.