{"id":23002509,"url":"https://github.com/kimdcottrell/debug-typescript-docker-compose","last_synced_at":"2026-04-11T03:33:32.349Z","repository":{"id":267062964,"uuid":"900143622","full_name":"kimdcottrell/debug-typescript-docker-compose","owner":"kimdcottrell","description":"A fully configured Dockerized localdev that hooks into Visual Studio Code. You just need to start it. Includes things like a debugger, a linter, a formatter, and a watch script.","archived":false,"fork":false,"pushed_at":"2024-12-11T02:11:00.000Z","size":57,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-17T09:51:23.093Z","etag":null,"topics":["debug","debugger","debugging","debugging-tool","docker","docker-compose","localdev","localdevelopment","node","npm","ts-node","typescript","visual-studio","visual-studio-code","vscode"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kimdcottrell.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-08T01:15:45.000Z","updated_at":"2024-12-11T02:11:04.000Z","dependencies_parsed_at":"2024-12-08T04:17:47.128Z","dependency_job_id":"8f057539-e196-4bc4-a566-946f9dee08da","html_url":"https://github.com/kimdcottrell/debug-typescript-docker-compose","commit_stats":null,"previous_names":["kimdcottrell/debug-typescript-docker-compose"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kimdcottrell/debug-typescript-docker-compose","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimdcottrell%2Fdebug-typescript-docker-compose","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimdcottrell%2Fdebug-typescript-docker-compose/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimdcottrell%2Fdebug-typescript-docker-compose/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimdcottrell%2Fdebug-typescript-docker-compose/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kimdcottrell","download_url":"https://codeload.github.com/kimdcottrell/debug-typescript-docker-compose/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimdcottrell%2Fdebug-typescript-docker-compose/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31668047,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["debug","debugger","debugging","debugging-tool","docker","docker-compose","localdev","localdevelopment","node","npm","ts-node","typescript","visual-studio","visual-studio-code","vscode"],"created_at":"2024-12-15T07:11:15.956Z","updated_at":"2026-04-11T03:33:32.330Z","avatar_url":"https://github.com/kimdcottrell.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Typescript debugger in VSCode attached to existing Docker Compose session\n\nThis repo details how to configure a localdev for learning typescript. \n\nIt details how to do things like configure a typescript debugger in vscode, how to add in tooling to your containerized localdev, and how to reduce bloat in your Docker image. \n\n## How to use\n\n```\n# in a terminal window, build and start your docker compose session as a background process\ndocker compose up --build -d\n```\n\nnode node_modules/eslint/bin/eslint --fix --parser typescript-eslint --rule 'indent: [1,4,{SwitchCase: 1}]' src/\n\nNow start vscode.\n\nThe required extensions should auto-install. \n\nTo debug:\n\n- open `src/greeters.ts` file (or any file in `src/`) and be on that tab in your editor\n- add breakpoints by clicking on the left side of the line number in the script\n- from the left side menu, hit `Run and Debug (Ctrl+Shift+D)` \n- in the top menu in the newly presented sidebar, run `tsx debug`. \n\nThe debugger will run on the file you have open (see `.vscode/launch.json` and [here](https://tsx.is/vscode#setup) for more info). \n\n## Requirements\n\n**For most people, you just need `vscode` and `docker desktop`.**\n\nBut if you're on **linux** and stubbornly not using `docker desktop`:\n\n1. You'll need the [Proprietary Microsoft-branded release of Visual Studio Code](https://wiki.archlinux.org/title/Visual_Studio_Code)\n\n2. You'll need these packages at minimum:\n- docker \n- docker-compose \n- docker-buildx\n\n## Linting, Formatting, and VSCode Integration\n\nLinting and formatting are two different things in [javascript](https://prettier.io/docs/en/comparison). Linting serves to bug catch bugs by insisting on certain things about codde quality. Formatting is your syntax enforcement, e.g. tabs vs spaces for indentation.\n\nThis codebase assumes:\n\n- [typescript-eslint](https://typescript-eslint.io/) for linting your typescript-only files\n- [prettier](https://prettier.io) for formatting\n- [.editorconfig](https://editorconfig.org/) to actually hold all of the formatting checks for all files in this codebase\n- `prettier` [falls back](https://prettier.io/docs/en/configuration#editorconfig) to `.editorconfig` with overrides available in `.prettierrc`\n\nThis setup, along with the following vscode settings, allows all the plugin configurations to work together inside vscode:\n\n```\n{\n    \"customizations\": {\n        \"vscode\": {\n            \"extensions\": [\n                \"dbaeumer.vscode-eslint\",\n                \"EditorConfig.EditorConfig\"\n            ],\n            \"settings\": {\n                \"typescript.format.enable\": true,\n                \"editor.formatOnSave\": true,\n                \"editor.codeActionsOnSave\": {\n                \"source.fixAll.eslint\": \"explicit\"\n                },\n            }\n        }\n    }\n}\n```\n\n## Last Tested Versions\n\n```\n# docker --version\nDocker version 27.3.1, build ce1223035a\n\n# docker compose version\nDocker Compose version 2.31.0\n\n# docker buildx version\ngithub.com/docker/buildx 0.19.2 1fc5647dc281ca3c2ad5b451aeff2dce84f1dc49\n\n# code --version (as https://aur.archlinux.org/packages/visual-studio-code-bin)\n1.95.3\nf1a4fb101478ce6ec82fe9627c43efbf9e98c813\nx64\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkimdcottrell%2Fdebug-typescript-docker-compose","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkimdcottrell%2Fdebug-typescript-docker-compose","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkimdcottrell%2Fdebug-typescript-docker-compose/lists"}