Sample report

What Wingbox writes about a real project.

One command, wingbox build, on the server of immich (commit e5d6eb7, Wingbox 0.2.2). It writes two files: a report for people and an interactive map. Both are below exactly as the tool wrote them.

Wingbox report: immich-server

Generated on 2026-11-16 by wingbox 0.2.2 from the code graph of this project. Open map.html in this folder for the interactive map.

Key findings

  • A change to src/enum.ts reaches 545 of 707 modules (77%) within 2 hops; 339 modules depend on it directly.
  • 0 boundary violations between layers that are set by folders. 2 more candidates rest on a guessed layer and are not counted.
  • The layer rules place 702 of 707 modules (99%): 689 by folder, 13 by the role of the file. The boundary rules say nothing about the rest.

Summary

Modules707
Dependencies between modules3,795
Functions, constants, classes and types2,856
Languagests 695, tsx 9, js 3
Boundary violations0

Architecture layers

Each module is assigned to a layer from its folders; when no folder rule applies, from the role of the file, which is a guess. other holds the modules no rule applies to.

LayerModulesShare
ui91%
api629%
service598%
domain13419%
infra16824%
shared385%
test23233%
other51%

Most depended-on modules

A change in one of these files reaches the most code (test files are left out). "Within 2 hops" counts the modules that depend on it directly or through one other module.

FileLayerDirect dependentsWithin 2 hops
src/enum.tsshared339545
src/decorators.tsshared183457
src/schema/index.tsdomain113247
src/repositories/logging.repository.tsinfra103337
src/dtos/auth.dto.tsdomain92352
src/types.tsshared81405
src/database.tsshared69378
src/services/base.service.tsservice65281
src/middleware/auth.guard.tsapi57231
src/validation.tsdomain57201
src/zod.tsother56392
src/utils/misc.tsshared51190
src/repositories/event.repository.tsinfra45384
src/dtos/config.dto.tsdomain43252
src/constants.tsshared40232

Boundary violations

None found by the layer rules, which place 99% of the modules.

2 more candidates where a layer is only guessed from the role of a file: wingbox boundaries all lists them.

6 imports of types only cross a layer boundary. The compiler erases such an import, so it is not counted as a violation; a change of the type still reaches the importing file.

FromTo
src/dtos/asset.dto.ts (domain)src/repositories/asset.repository.ts (infra)
src/emails/album-invite.email.tsx (ui)src/repositories/email.repository.ts (infra)
src/emails/album-update.email.tsx (ui)src/repositories/email.repository.ts (infra)
src/emails/test.email.tsx (ui)src/repositories/email.repository.ts (infra)
src/emails/welcome.email.tsx (ui)src/repositories/email.repository.ts (infra)
src/services/asset-media.service.ts (service)src/middleware/auth.guard.ts (api)

Where to start reading

Files that nothing else depends on and that pull in the most modules:

  • src/bin/sync-sql.ts (other), depends on 9 modules
  • src/workers/microservices.ts (api), depends on 8 modules
  • src/main.ts (infra), depends on 6 modules
  • src/workers/api.ts (api), depends on 5 modules
  • src/workers/maintenance.ts (other), depends on 5 modules
  • src/schema/migrations/1744910873969-InitialMigration.ts (infra), depends on 4 modules
  • src/bin/sync-open-api.ts (infra), depends on 2 modules
  • src/emails/license.email.tsx (ui), depends on 2 modules
  • src/schema/migrations/1749067526135-UserOnboardingDefault.ts (infra), depends on 1 module
  • src/schema/migrations/1752759108283-ConvertToAbsolutePaths.ts (infra), depends on 1 module

Next steps

Check what a change will reach before you make it:

wingbox impact src/enum.ts

Rebuild after the code changes with wingbox build. This report and the map are rewritten on every build.

Limits

The graph comes from static parsing. Dependencies created at run time (dependency injection, reflection, generated code) are not visible here.

Checked

Every number of this report, against the code

The report was compared with an import resolver and a declaration count written separately from Wingbox, on the same commit.

  • 707 modules: the same 707 source files a walk of the repository finds.
  • 3,795 dependencies between modules: an import resolver written separately from Wingbox finds the same pairs, none extra and none missing.
  • The 15 rows of the most depended-on modules: direct dependents and two-hop reach recounted from the independent graph, and the rows are the top of that ranking.
  • The 10 entry points: nothing imports them, and each depends on the number of modules shown.
  • Declarations counted with the TypeScript compiler: 671 classes, 148 interfaces, 318 type aliases and 111 enums, the numbers behind the summary line.
  • Boundary rules applied to the independent edges: 8 imports cross a rule; 6 are the type-only rows of the report, 2 are its candidates on a guessed layer.