# rmanguinho/clean-ts-api

API em NodeJs usando Typescript, TDD, Clean Architecture, Design Patterns e SOLID principles

Repository: https://github.com/rmanguinho/clean-ts-api
Canonical: https://ross.abutalabs.com/products/clean-ts-api
Homepage: https://rmanguinho.github.io/
Language: TypeScript
License: GPL-3.0
License Family: copyleft
Topics: tdd, typescript, solid, mongodb, design-patterns, nodejs, clean-architecture, clean-code, docker, docker-compose, dockerfile, jest, travis-ci, coveralls, lint-staged, husky, rest-api, graphql
Last push: 2024-11-27T13:53:24+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": 2413, "days_push": 644, "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 1913, forks 487 (observed 2026-08-28T04:05:53.450267+00:00)

## What it is
A Node.js/TypeScript REST and GraphQL API built with Clean Architecture, SOLID principles, design patterns, and TDD, serving as the companion codebase for a Udemy course. It implements a survey system with signup, login, and survey CRUD endpoints using MongoDB, Jest, and Docker.

## Use cases
- learn clean architecture in nodejs
- study tdd with jest and typescript
- reference for structuring a layered api
- boilerplate for a node rest api with mongodb
- see solid principles and design patterns applied in a real api
- example of ci/cd setup with travis and coveralls

## When to choose
- you are taking the accompanying course or want a guided architecture reference
- you want a well-structured TypeScript API template with tests and Docker
- you want to study how Clean Architecture layers map to a Node.js backend

## When to avoid
- you need a production-ready framework or maintained library rather than educational code
- you want minimal boilerplate without layered architecture overhead
- you need a stack other than Node.js, TypeScript, and MongoDB

## Facets
- artifact type: learning-resource
- maturity: maintenance
- function: web-framework, api-framework, testing, auth, graphql, http-server
- domain: web-development, backend, developer-tools, tutorials, apis
- platform: cross-platform
- tags: clean-architecture, tdd, solid, design-patterns, typescript, mongodb, rest-api, boilerplate, udemy-course, jest, nodejs, docker

## Member repositories
- rmanguinho/clean-ts-api (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:53.450267+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-30T03:10:29.147902+00:00, confidence not recorded.
  - readme: https://github.com/rmanguinho/clean-ts-api (fetched 2026-08-28T04:05:53.450267+00:00, sha dbd7cdbb7ac8)
  - homepage: https://rmanguinho.github.io/ (fetched 2026-08-29T10:50:02.749052+00:00, sha 6ac0320879df)
- Data as of 2026-08-30T08:39:29.467469+00:00.