Build Reconciliation Checklist¶

This checklist turns the scaffold into a real shared-library project.

1. Configure pass¶

fresh build directory
verify all targets are declared
verify all source files referenced by CMake exist
verify Qt modules are complete for each target
verify install/export generation succeeds during configure

2. Library compile pass¶

Build libraries first with tests and examples off:

qtmaterial3_theme
qtmaterial3_legacy
qtmaterial3_core
qtmaterial3_specs
qtmaterial3_effects
qtmaterial3_widgets

3. Public header audit¶

no private headers leaked through include/
no src/.../private includes from public headers
export macros present on public classes
heavy implementation kept out of public headers

4. Dependency audit¶

Expected direction:

theme independent
legacy -> theme
core -> theme
specs -> theme, core
effects -> theme, core
widgets -> theme, core, specs, effects

5. Examples pass¶

Build:

gallery
minimal consumer
install consumer
theme playground

6. Test pass¶

build tests after libraries compile
classify tests as passing, placeholder, or intentionally disabled
do not leave ambiguous broken tests

7. Install/export pass¶

install headers and shared libraries
install exported targets
install config package files
validate external consumer with find_package(QtMaterial3Widgets REQUIRED)

8. Warnings pass¶

Turn warnings up and clean:

missing override
hidden virtuals
sign/size issues in geometry math
moc warnings
unused parameters

9. First release-quality checkpoint¶

The scaffold is reconciled only when:

configure passes
libraries compile
examples compile
install/export works
consumer example works
warnings are acceptable