{"id":20832210,"url":"https://github.com/scbd/clearing-house-documentation","last_synced_at":"2026-04-20T22:04:11.368Z","repository":{"id":246913934,"uuid":"823208591","full_name":"scbd/clearing-house-documentation","owner":"scbd","description":"clearing-house-documentation","archived":false,"fork":false,"pushed_at":"2026-04-10T15:14:13.000Z","size":4006,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":6,"default_branch":"master","last_synced_at":"2026-04-10T16:17:55.180Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/scbd.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-07-02T15:32:02.000Z","updated_at":"2026-04-10T14:34:28.000Z","dependencies_parsed_at":"2024-07-29T20:24:43.277Z","dependency_job_id":"d6d73d8f-375e-4858-be8c-70cdc4d284cf","html_url":"https://github.com/scbd/clearing-house-documentation","commit_stats":null,"previous_names":["scbd/clearing-house-documentation"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/scbd/clearing-house-documentation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scbd%2Fclearing-house-documentation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scbd%2Fclearing-house-documentation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scbd%2Fclearing-house-documentation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scbd%2Fclearing-house-documentation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/scbd","download_url":"https://codeload.github.com/scbd/clearing-house-documentation/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scbd%2Fclearing-house-documentation/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32067637,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T21:26:33.338Z","status":"ssl_error","status_checked_at":"2026-04-20T21:26:22.081Z","response_time":94,"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":[],"created_at":"2024-11-18T00:10:45.569Z","updated_at":"2026-04-20T22:04:11.332Z","avatar_url":"https://github.com/scbd.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# clearing-house-documentation\nThis documentation is created using VitePress. Follow the steps below to add a new route to our application.\n\n## Steps to Add a New Route\n\n### 1. Add Routes in the Corresponding Clearing House\n\nFirst, navigate to the appropriate clearing house folder and add the route. The available folders are:\n\n- `/routes/abs`\n- `/routes/bch`\n- `/routes/chm`\n- `/routes/common`\n\nAdd the new route in the corresponding folder based on the type of route you are adding.\n\n### 2. Create the Corresponding Markdown File\n\nVitePress uses file-based routing, so you need to add the markdown file in the `docs` folder following the structure of your route.\n\nFor example, to add a route `/ircc/document/get`:\n\n1. Create a folder `ircc` inside the `docs` folder.\n2. Inside the `ircc` folder, create another folder named `document`.\n3. Inside the `document` folder, create a markdown file named `get.md`.\n\nThe folder structure should look like this:\n\ndocs/\n└── ircc/\n    └── document/\n        └── get.md\n\n\nIn the `get.md` file, write the content required for the webpage.\n\n### 3. Add the Swagger File\n\nNext, add the Swagger file for the playground specification. Place the Swagger JSON file inside the `swagger/json` folder. Ensure that the Swagger JSON file accurately reflects the API documentation for the new route.\n\n### 4. Render the Swagger JSON in the Markdown File\n\nFinally, reference and render the Swagger JSON file within the corresponding markdown file to display the API specification on the webpage. You can use VitePress's markdown capabilities to embed the Swagger UI.\n\nBy following these steps, you can successfully add new routes to your application and ensure that the API documentation is correctly displayed and functional.\n\n## Environment Variables\n\nTo ensure the project runs correctly, you must set the following environment variables in your `.env` file located in the `docs` folder:\n\n`VITE_ACCOUNTS_HOST_URL=\u003cyour-accounts-host-url\u003e` \n\n`VITE_API_URL=\u003cyour-api-url\u003e`\n\n\nYou can find examples of these environment variables in the `.env.example` file located in the `/docs` directory.\n\nAdditionally, for the project to work, you need to have a launch configuration where the `VITE_CLEARING_HOUSE` value is set to the clearing house you are viewing. For example:\n\n```json\n\"VITE_CLEARING_HOUSE\": \"abs\"\n```\n\n\n## Steps to Run the Project\n\n### 1. Install Dependencies\n\nBefore running the project, make sure to install all necessary dependencies. Run the following command in your project directory:\n\n```sh\nnpm install\n```\n\n### 2. Running the Development Server\n\nYou can start the development server for different clearing houses by using the following commands:\n\n- For ABS:\n\n```sh\nnpm run dev:abs\n```\n\n- For CHM:\n\n```sh\nnpm run dev:chm\n```\n\n- For ABS:\n\n```sh\nnpm run dev:bch\n```\n\nThese commands will set the appropriate environment variable and start the VitePress development server.\n\n### 3. Building the Project\n\nTo build the project for production, use the following command:\n\n```sh\nnpm run build\n```\n\nThis will generate the static files for the documentation in the dist folder inside the docs directory.\n\n### 2. Serving the Built Project\n\nAfter building the project, you can serve the static files using:\n\n```sh\nnpm run serve\n```\n\nThis will start a server to serve the built documentation locally.\n\nBy following these steps, you can run the project in development mode, build it for production, and serve the built documentation.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscbd%2Fclearing-house-documentation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscbd%2Fclearing-house-documentation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscbd%2Fclearing-house-documentation/lists"}