This repository has been archived on 2024-07-19. You can view files and clone it, but cannot push or open issues or pull requests.
works-on-my-machine/architecture/adr-0001-no-dependencies.md
Marc Cataford cab7505672
docs: adr-0001 nodeps + ci check (#19)
* docs: adr-0001 nodeps + ci check

* ci: add check
2023-04-14 09:38:29 -04:00

958 B

ADR 1 - No production dependencies


Decision

The project should have no production dependencies that users need to install for core functionality to work.

Some optional peer dependencies are acceptable (i.e. the project installing womm might need to install typescript to support Typescript tests, etc.). These should not be bundled with womm.

Development dependencies should be kept to a minimum and each one present should be thoroughly justified.

Rationale

The NodeJS ecosystem is too trigger-happy with npm install and yarn add. Even basic applications quickly end up requiring tens of packages to be shipped to users. A lot of those packages being maintained (or not) by the community, this means that ensuring that the downstream dependency of a project can quickly become a major concern.

The best way to ensure that things are becoming stale is to depend on less, and depending on nothing than the standard library is best.