{"id":18047293,"url":"https://github.com/cryogenicplanet/depp","last_synced_at":"2025-10-23T16:55:03.741Z","repository":{"id":39859763,"uuid":"423651876","full_name":"CryogenicPlanet/depp","owner":"CryogenicPlanet","description":"⚡ Check your npm modules for unused and duplicate dependencies fast","archived":false,"fork":false,"pushed_at":"2022-05-27T11:41:12.000Z","size":109,"stargazers_count":264,"open_issues_count":2,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-02T13:15:49.724Z","etag":null,"topics":["dependency","duplicate-detection","modules","monorepo","npm","unused"],"latest_commit_sha":null,"homepage":"https://depp-serverless.vercel.app","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CryogenicPlanet.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-11-01T23:56:56.000Z","updated_at":"2025-01-25T18:23:25.000Z","dependencies_parsed_at":"2022-08-30T20:10:11.916Z","dependency_job_id":null,"html_url":"https://github.com/CryogenicPlanet/depp","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryogenicPlanet%2Fdepp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryogenicPlanet%2Fdepp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryogenicPlanet%2Fdepp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryogenicPlanet%2Fdepp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CryogenicPlanet","download_url":"https://codeload.github.com/CryogenicPlanet/depp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246828496,"owners_count":20840474,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dependency","duplicate-detection","modules","monorepo","npm","unused"],"created_at":"2024-10-30T19:11:00.422Z","updated_at":"2025-10-23T16:54:58.700Z","avatar_url":"https://github.com/CryogenicPlanet.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Depp - A fast unused and duplicate package checker [![Go Reference](https://pkg.go.dev/badge/github.com/CryogenicPlanet/depp.svg)](https://pkg.go.dev/github.com/CryogenicPlanet/depp)\n\n![](https://user-images.githubusercontent.com/10355479/139758905-7f911615-84d0-46c6-805a-06f8eafaf633.png)\n\n## Installation\n\n```bash\n## NPM\nnpm install -g depp-installer \n# (will try to get npm install -g depp later)\n\n## Go\ngo install github.com/cryogenicplanet/depp@latest\n\n```\n\n## Usage\n\nJust run `depp` in your project folder and it will do the rest. Keep in mind it will likely fail without setting some externals\n\n**Note if you want it to work with JS** please use `-j` or `--js` by default it will do only `.ts|.tsx` files\n\nAll options\n```bash\n➜ depp --help  \nNAME:\n   depp - Find un used packages fast\n\nUSAGE:\n   depp [global options] command [command options] [arguments...]\n\nCOMMANDS:\n   clean      Cleans all output files\n   show       Shows previous report\n   deploy, d  Automatically deploy your report to netlify\n   config     A command to handle config\n   init       Initialize project\n   help, h    Shows a list of commands or help for one command\n\nGLOBAL OPTIONS:\n   --dev, -d                              Enable dev dependencies (default: false)\n   --js, -j                               Enable js source files (default: false)\n   --path value, -p value                 Overwrite root directory\n   --log, -l                              Will write logs to .depcheck.log (default: false)\n   --source value, -s value               Overwrite default sources\n   --report, -r                           Generate report file (default: false)\n   --show-versions, -v                    Show conflicting versions (default: false)\n   --write-output-files, -w               This will write the esbuild output files. (default: false)\n   --externals value, -e value            Pass custom externals using this flag\n   --ignore-namespaces value, --in value  Pass namespace (@monorepo) to be ignored\n   --no-open, --no                        Flag to prevent auto opening report in browser (default: false)\n   --save-config, --sc                    Flag to automatically save config from other flags (default: false)\n   --ci                                   Run in github actions ci mode (default: false)\n   --deploy value                         Will automatically deploy report to netlify\n   --help, -h                             show help (default: false)\n```\n\n## Example Advanced usage\n\nThis is an example of advanced usage of the script with `externals` and `ignore-namespace`\n\n```\ndepp -v -j -e mobx -e magic-sdk -e domain -e @daybrush/utils -e yjs -e constants -e ws  -e perf_hooks -in @editor -in @server   --report\n```\n\n\n## Configuration\n\nYou can save your `depp` config and not have to run it with flags every time, the config is saved in `.depp/config.json` but can be created from the cli\n\n```bash\n# Initialize config\ndepp init \n\n➜ depp --help                                                \nNAME:\n   depp - Find un used packages fast\n\nUSAGE:\n   depp [global options] command [command options] [arguments...]\n\nCOMMANDS:\n   clean      Cleans all output files\n   show       Shows previous report\n   deploy, d  Automatically deploy your report to netlify\n   config     A command to handle config\n   init       Initialize project\n   help, h    Shows a list of commands or help for one command\n\nGLOBAL OPTIONS:\n   --dev, -d                              Enable dev dependencies (default: false)\n   --js, -j                               Enable js source files (default: false)\n   --path value, -p value                 Overwrite root directory\n   --log, -l                              Will write logs to .depcheck.log (default: false)\n   --source value, -s value               Overwrite default sources\n   --report, -r                           Generate report file (default: false)\n   --show-versions, -v                    Show conflicting versions (default: false)\n   --write-output-files, -w               This will write the esbuild output files. (default: false)\n   --externals value, -e value            Pass custom externals using this flag\n   --ignore-namespaces value, --in value  Pass namespace (@monorepo) to be ignored\n   --no-open, --no                        Flag to prevent auto opening report in browser (default: false)\n   --save-config, --sc                    Flag to automatically save config from other flags (default: false)\n   --ci                                   Run in github actions ci mode (default: false)\n   --deploy value                         Will automatically deploy report to netlify\n   --browser                              Will use esbuild browser platform (by default it uses node platform) (default: false)\n   --ignore-path value, --ip value        A glob pattern of files to be ignored\n```\n\n## CI\n\nCurrently only supports Github actions out of the box.\n\nIn mode, `depp` will automatically comment on the PR with its report. It will look like [this](https://github.com/CryogenicPlanet/cryogenicplanet.github.io/issues/49#issuecomment-961496544)\n\nIt can also deploy the report to [netlify](netlify.com) but requires a `NETLIFY_TOKEN` which you can get [here](https://app.netlify.com/user/applications#personal-access-tokens)\n\n```yaml\nname: Dependency CI\n\non:\n  pull_request:\n\n\njobs:\n  release-go:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Checkout\n        uses: actions/checkout@v2\n        with:\n          fetch-depth: 0\n      - name: Set up Go\n        uses: actions/setup-go@v2\n        with:\n          go-version: 1.17\n      - name: Install Depp \n        run: go install github.com/cryogenicplanet/depp@latest\n      - name: Run Depp\n        run: depp --ci\n        env:\n            # NETLIFY_TOKEN: ${{secrets.NETLIFY_TOKEN}}\n            # Optional if you want report urls or not\n            # You can get a netlify pat here https://app.netlify.com/user/applications#personal-access-tokens\n```\n\n## Example Outputs\n\n1. [Markdown](./static/markdownReport.md)\n2. [Html](https://cryogenicplanet.github.io/depp/static/htmlReport.html)\n\n## Why use this\n\n1. It is using `esbuild` and `go` so it is quite a bit faster than most other tools\n2. Most tools that I could find at least, didn't not support monorepos. This does and is built for monorepos\n\n## Caveats \n\nThis is not been extensively tested and might have some short comings, it may not identify every unused package but will definitely do a decent first pass\n\n\n## Acknowledgement\n\n\n\u003e Credits to [@zack_overflow](https://github.com/zackradisic) for the amazing cover photo\n\nThis is built upon the excellent work down by [@evanw](https://github.com/evanw/) on `esbuild` and uses `esbuild` under the hood\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcryogenicplanet%2Fdepp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcryogenicplanet%2Fdepp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcryogenicplanet%2Fdepp/lists"}