{"id":15062781,"url":"https://github.com/deve-sh/express-to-doc","last_synced_at":"2026-01-29T15:33:33.500Z","repository":{"id":197370549,"uuid":"697228932","full_name":"deve-sh/Express-To-Doc","owner":"deve-sh","description":"CLI utility to read your Express App and export standardized documentation templates like Postman Collection. 📃","archived":false,"fork":false,"pushed_at":"2023-09-30T13:48:29.000Z","size":120,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-22T08:08:35.330Z","etag":null,"topics":["api","collection","exporter","postman"],"latest_commit_sha":null,"homepage":"https://npmjs.com/package/express-to-doc","language":"TypeScript","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/deve-sh.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,"governance":null}},"created_at":"2023-09-27T10:05:41.000Z","updated_at":"2023-09-30T13:50:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"218b3902-ff2f-47b9-8f9b-109c58e92ca3","html_url":"https://github.com/deve-sh/Express-To-Doc","commit_stats":{"total_commits":23,"total_committers":2,"mean_commits":11.5,"dds":"0.26086956521739135","last_synced_commit":"5741afe99de1d8ff00738a018af29bde33746ec0"},"previous_names":["deve-sh/express-to-doc"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deve-sh%2FExpress-To-Doc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deve-sh%2FExpress-To-Doc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deve-sh%2FExpress-To-Doc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deve-sh%2FExpress-To-Doc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deve-sh","download_url":"https://codeload.github.com/deve-sh/Express-To-Doc/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235064304,"owners_count":18930088,"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":["api","collection","exporter","postman"],"created_at":"2024-09-24T23:46:25.323Z","updated_at":"2026-01-29T15:33:28.479Z","avatar_url":"https://github.com/deve-sh.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📃 Express to Doc\n\nWhen you create a backend API, it can get large and lengthy very fast and documenting it is a hassle. The hardest part is often _getting started_.\n\nThis repo is a simple CLI utility to read your Express App and export standardized documentation templates like Postman Collection or OpenAPI Specification (Hit me up if you want that feature) to start documenting your APIs.\n\nFor now it supports Postman Collection exports.\n\n### Pre-requisite\n\nExport your Express app from your index flag.\n\n```javascript\n// app.js\nmodule.exports = app;\n\n// or if you're using TypeScript or ESM\nexport default app;\n```\n\n### Running the exporter\n\n```bash\nnpm i --save-dev express-to-doc\n# or\nnpm i -g express-to-doc\n\n# Run the exporter\nnpx convert-express-app-to-doc\n```\n\nThis starts a CLI session with options to export your Express app to a collection/documentation file.\n\n![CLI Session](https://raw.githubusercontent.com/deve-sh/Express-To-Doc/main/doc-assets/cli-session.PNG)\n\n### Passing options via CLI Flags\n\nYou can also pass options as CLI Flags when running this command in a non-interactive environment.\n\nThe following is a list of supported flags, the presence of which will disable the associated CLI prompts:\n\n```bash\nnpx convert-express-app-to-doc\n    --appPath=./test-app/app.js # Path to your final Express app\n    --buildStep=\"npm run build\" # If you're using a build step with something like TypeScript\n    --moduleName=\"default\" # Name of the module your Express app is exported as\n    --doc=Postman\n    # Applicable when setting `doc` as Postman\n    --flat false    # Nest route paths recursively and create folders where needed\n    --fileName=\"my.postman_collection.json\"\n    --collectionName=\"Express App\"\n```\n\n### Possible features\n\n-   GUI to spin up with the base app information to allow the user to add headers, query params and other information and export all that information instead.\n-   Auto reading of query params, headers and body to generate a comprehensive Express app Postman collection/OpenAPI documentation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeve-sh%2Fexpress-to-doc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeve-sh%2Fexpress-to-doc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeve-sh%2Fexpress-to-doc/lists"}