# jbuget/nodejs-clean-architecture-app

A simple API built with Hapi.js that follows DDD + Clean Architecture principles

Repository: https://github.com/jbuget/nodejs-clean-architecture-app
Canonical: https://ross.abutalabs.com/products/nodejs-clean-architecture-app
Homepage: https://hapijs-v17-app.herokuapp.com/users
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2023-01-06T01:32:37+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3162, "days_push": 1336, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1540, forks 257 (observed 2026-08-28T04:05:00.538491+00:00)

## What it is
A reference Node.js API built with Hapi.js that demonstrates Clean Architecture and Domain-Driven Design principles. It organizes code into application, domain, and infrastructure layers with swappable ORM and security implementations.

## Use cases
- learn clean architecture in nodejs
- ddd example project javascript
- hapi.js api starter template
- how to structure a nodejs backend with clean architecture
- onion architecture example in javascript
- reference project for hexagonal architecture
- separate business logic from framework code nodejs

## When to choose
- you want a concrete, working example of Clean Architecture in JavaScript
- you are starting a Node.js API and want a DDD-style layered structure
- you want to see how to swap ORMs (Sequelize/Mongoose) behind repository interfaces

## When to avoid
- you need a production-ready framework with active development and community support
- you prefer minimal boilerplate without architectural layers
- you use a framework other than Hapi.js and don't want to adapt the structure

## Facets
- artifact type: application
- maturity: maintenance
- function: api-framework, web-framework, orm, auth
- domain: web-development, backend, developer-tools, tutorials
- platform: -
- tags: clean-architecture, ddd, hapi, boilerplate, reference-architecture, hexagonal-architecture, nodejs, javascript

## Member repositories
- jbuget/nodejs-clean-architecture-app (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:00.538491+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:51.393965+00:00, confidence not recorded.
  - readme: https://github.com/jbuget/nodejs-clean-architecture-app (fetched 2026-08-28T04:05:00.538491+00:00, sha 36b6c90011f2)
- Data as of 2026-08-30T08:39:29.467469+00:00.