{"id":28475897,"url":"https://github.com/samuele-barbiera/kubb-gen-scribe-cli","last_synced_at":"2026-04-17T01:01:54.720Z","repository":{"id":230037343,"uuid":"778267615","full_name":"Samuele-Barbiera/kubb-gen-scribe-cli","owner":"Samuele-Barbiera","description":"a cli made to scaffold a basic structure for the kubb SDKs, managing the BE api calls fully typesafe with a swagger yaml file","archived":false,"fork":false,"pushed_at":"2024-06-17T10:55:30.000Z","size":497,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-06T03:12:31.770Z","etag":null,"topics":["cli","kubb","openapi","typescript"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/gen-sdk-api","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/Samuele-Barbiera.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-03-27T12:01:18.000Z","updated_at":"2024-06-17T10:55:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"e1ad4884-9482-48f2-b860-44f812eb1f01","html_url":"https://github.com/Samuele-Barbiera/kubb-gen-scribe-cli","commit_stats":null,"previous_names":["samuele-barbiera/kubb-gen-scribe-cli"],"tags_count":3,"template":true,"template_full_name":null,"purl":"pkg:github/Samuele-Barbiera/kubb-gen-scribe-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samuele-Barbiera%2Fkubb-gen-scribe-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samuele-Barbiera%2Fkubb-gen-scribe-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samuele-Barbiera%2Fkubb-gen-scribe-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samuele-Barbiera%2Fkubb-gen-scribe-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Samuele-Barbiera","download_url":"https://codeload.github.com/Samuele-Barbiera/kubb-gen-scribe-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samuele-Barbiera%2Fkubb-gen-scribe-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31910585,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"ssl_error","status_checked_at":"2026-04-16T18:21:47.142Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["cli","kubb","openapi","typescript"],"created_at":"2025-06-07T15:05:09.781Z","updated_at":"2026-04-17T01:01:54.693Z","avatar_url":"https://github.com/Samuele-Barbiera.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gen-sdk-api\r\n\r\nTo scaffold the SDKs in your react / tsx  app using `gen-sdk-api`, run any of the following four commands and answer the command prompt questions:\r\n\r\n### npm\r\n\r\n```bash\r\nnpm gen-sdk-api@latest\r\n```\r\n\r\n### yarn\r\n\r\n```bash\r\nyarn gen-sdk-api\r\n```\r\n\r\n### pnpm\r\n\r\n```bash\r\npnpm gen-sdk-api@latest\r\n```\r\n\r\n### bun\r\n\r\n```bash\r\nbun gen-sdk-api@latest\r\n``` \r\n\r\n### Output\r\n\r\nThe script logs a message to the console when the OpenAPI document has been processed and saved.\r\n\r\nPlease note that this is a basic outline and you may need to add more details depending on the complexity of your project and the level of detail you want to provide in your documentation.\r\n\r\nDetermining workspace structure\r\n\r\nDeciding which workspace information to collect\r\n\r\nGathering workspace info\r\n\r\nSure, here's a continuation of the [`README.md`](command:_github.copilot.openRelativePath?%5B%22README.md%22%5D \"README.md\") based on the information from [`index.ts`](command:_github.copilot.openRelativePath?%5B%22index.ts%22%5D \"index.ts\"):\r\n\r\n## Usage\r\n\r\nThe `gen-sdk-api` CLI tool is used to generate SDKs for your React/TypeScript application based on a Swagger/OpenAPI document. Here's a step-by-step guide on how it works:\r\n\r\n\r\n0. **Selecting the lib / framework**: The CLI prompts you to select the configuration you'd like to use. You can choose between `React` and `Angular`. This selection determines the lib / framework that will be connected to the kubb config.\r\n\r\n```bash\r\n? What lib / framework you are currently using? (Use arrow keys)\r\n❯ React\r\n```\r\n\r\n1. **Selecting the Configuration**: The CLI prompts you to select the configuration you'd like to use. You can choose `Tanstack-query`. This selection determines the packages that will be installed and the files and folders that will be imported.\r\n\r\n```bash\r\n? What kubb config would you like to use? (Use arrow keys)\r\n❯ Tanstack-query\r\n```\r\n\r\n2. **Installing Dependencies**: If you haven't set the `noInstall` flag, the CLI will prompt you to confirm whether it should run the installation command for you. This step installs the necessary dependencies for the selected configuration.\r\n\r\n```bash\r\n? Should we run 'npm install' for you? (Y/n)\r\n```\r\n\r\n3. **Providing the Swagger File Path**: You're then asked to provide the path to your Swagger file. This file will be used to generate the SDKs.\r\n\r\n```bash\r\n? Indicate the path to the swagger file (./api.yaml)\r\n```\r\n\r\n4. **Processing the Swagger File**: The CLI runs a schema validation for the provided Swagger file. It logs a message to the console when the OpenAPI document has been processed and saved.\r\n\r\n5. **Generating the SDKs**: Finally, the CLI runs the `kubbGenCommand` to generate the code based on the provided Swagger file and the selected configuration.\r\n\r\nIf everything is successful, the process exits with code 0. If an error occurs during any of these steps, it's logged to the console and the process exits with code 1.\r\n\r\n\r\n\r\n## Contributing\r\nPlease see the CONTRIBUTING.md for details on how to contribute to this project.\r\n\r\n## License\r\nThis project is licensed under the terms of the license provided in LICENSE.md.\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamuele-barbiera%2Fkubb-gen-scribe-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamuele-barbiera%2Fkubb-gen-scribe-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamuele-barbiera%2Fkubb-gen-scribe-cli/lists"}