# xmolecules/jmolecules

Libraries to help developers express architectural abstractions in Java code

Repository: https://github.com/xmolecules/jmolecules
Canonical: https://ross.abutalabs.com/products/jmolecules
Homepage: http://jmolecules.org
Language: Java
License: Apache-2.0
License Family: permissive
Topics: architecture, java, domain-driven-design
Last push: 2026-02-03T13:05:16+00:00

## Health v2 (maintenance only)
Score: 58/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 65, release rhythm 25, longevity 100
- inputs: {"age_days": 2403, "days_push": 211, "days_rel": 286, "gap_med": 182.0, "n_releases_24m": 3}
- flags: no_readme
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1554, forks 118 (observed 2026-08-28T04:05:02.917109+00:00)

## What it is
jMolecules is a set of Java libraries that let developers explicitly express architectural and domain-driven-design concepts (entities, aggregates, bounded contexts, layered architecture) directly in plain Java code via annotations and types. It also supports generating technical boilerplate and verifying/documenting the architecture from those declarations.

## Use cases
- express DDD concepts like entities, value objects and aggregates in Java code
- mark bounded contexts and modules in a codebase
- generate JPA or other technical boilerplate from architectural annotations
- verify that code follows the intended architecture rules
- document software architecture directly in source code
- write domain models in plain Java without framework dependencies

## When to choose
- you practice domain-driven design in Java and want concepts explicit in code
- you want architecture rules enforced via static analysis or ArchUnit rules
- you want to reduce boilerplate by deriving technical code from architectural intent

## When to avoid
- you don't use DDD or layered architecture patterns
- you need a runtime framework rather than compile-time abstractions
- your team won't adopt annotation discipline

## Facets
- artifact type: library
- maturity: active
- function: middleware, developer-tools
- domain: developer-tools, web-development
- platform: jvm
- tags: domain-driven-design, architecture, annotations, code-generation, architecture-verification

## Member repositories
- xmolecules/jmolecules (main) score 58

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:02.917109+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:30:07.227568+00:00, confidence not recorded.
  - homepage: http://jmolecules.org (fetched 2026-08-29T11:30:22.557163+00:00, sha f3d1cf41f465)
- Data as of 2026-08-30T08:39:29.467469+00:00.