{"id":23543696,"url":"https://github.com/pedroaurelli/fastify-swagger","last_synced_at":"2026-05-08T19:33:47.476Z","repository":{"id":269552437,"uuid":"907375910","full_name":"pedroaurelli/fastify-swagger","owner":"pedroaurelli","description":"Fastify Node example application auto documatated by Swagger","archived":false,"fork":false,"pushed_at":"2025-01-22T15:47:19.000Z","size":37,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-01T05:06:37.327Z","etag":null,"topics":["autodoc","fastify","nodejs","solid","swagger","zod-validation"],"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/pedroaurelli.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-23T12:48:11.000Z","updated_at":"2025-01-22T15:47:22.000Z","dependencies_parsed_at":"2024-12-24T11:51:05.827Z","dependency_job_id":"959ced67-345e-4e80-b14f-adc0c01a36a2","html_url":"https://github.com/pedroaurelli/fastify-swagger","commit_stats":null,"previous_names":["pedroaurelli/fastify-swager"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pedroaurelli/fastify-swagger","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedroaurelli%2Ffastify-swagger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedroaurelli%2Ffastify-swagger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedroaurelli%2Ffastify-swagger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedroaurelli%2Ffastify-swagger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pedroaurelli","download_url":"https://codeload.github.com/pedroaurelli/fastify-swagger/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedroaurelli%2Ffastify-swagger/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32794716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"ssl_error","status_checked_at":"2026-05-08T08:22:45.650Z","response_time":54,"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":["autodoc","fastify","nodejs","solid","swagger","zod-validation"],"created_at":"2024-12-26T07:11:03.468Z","updated_at":"2026-05-08T19:33:47.459Z","avatar_url":"https://github.com/pedroaurelli.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Node.JS app (Fastify) auto documented by Swagger\n\n## Objective\n- The objective of this project is not to create a new API. I was testing some project structures to validate the input and output values from the controller. I applied knowledge from all the API projects I have worked on and merged only the best practices that I consider essential for any API project. This includes: route documentation, input and output value validation, tests (coming soon), directory structure, some SOLID principles, and Design Patterns.\n\n## Project Structure\n- [**src**](https://github.com/pedroaurelli/fastify-swager/tree/main/src)\n  - [**controllers**](https://github.com/pedroaurelli/fastify-swager/tree/main/src/controllers)\n  - [**lib**](https://github.com/pedroaurelli/fastify-swager/tree/main/src/lib)\n    - [definitions](https://github.com/pedroaurelli/fastify-swager/tree/main/src/lib/definitions)\n    - [schemas](https://github.com/pedroaurelli/fastify-swager/tree/main/src/lib/schemas)\n    - [types](https://github.com/pedroaurelli/fastify-swager/tree/main/src/lib/types)\n    - [utils](https://github.com/pedroaurelli/fastify-swager/tree/main/src/lib/utils)\n  - [**services**](https://github.com/pedroaurelli/fastify-swager/tree/main/src/services)\n\n| **Folder** | **Description** |\n|-------|---------|\n| [**src**](https://github.com/pedroaurelli/fastify-swager/tree/main/src)                            | Root folder of the project's source code.                                                       |\n| [**controllers**](https://github.com/pedroaurelli/fastify-swager/tree/main/src/controllers)        | Contains controllers responsible for handling route requests and responses.                     |\n| [**lib**](https://github.com/pedroaurelli/fastify-swager/tree/main/src/lib)                        | Folder with libraries and auxiliary resources for the project.                                  |\n| [**definitions**](https://github.com/pedroaurelli/fastify-swager/tree/main/src/lib/definitions)            | Define endpoint schema.                                                  |\n| [**schemas**](https://github.com/pedroaurelli/fastify-swager/tree/main/src/lib/schemas)            | Defines validation and data structure schemas.                                                  |\n| [**types**](https://github.com/pedroaurelli/fastify-swager/tree/main/src/lib/types)                | Contains type and interface definitions for the project.                                        |\n| [**utils**](https://github.com/pedroaurelli/fastify-swager/tree/main/src/lib/utils)                | Includes utility functions and helpers to support core functionalities.                         |\n| [**services**](https://github.com/pedroaurelli/fastify-swager/tree/main/src/services)              | Implements business logic.              |\n\n## Scripts\n| **Script** | **Description**                                         |\n|------------|---------------------------------------------------------|\n| `dev`      | Runs the server in development mode|\n| `build` | Build app to production |\n\n## Packages\n| **Dependency**         | **Description**                                      |\n|-------------------------|------------------------------------------------------|\n| `typescript`           | Typed JavaScript language.                           |\n| `tsx`                  | TypeScript runtime with ES module support.           |\n| `fastify`              | Fast web framework for Node.js.                      |\n| `@fastify/swagger`     | Swagger/OpenAPI plugin for Fastify.                  |\n| `zod`                  | Schema validation library for TypeScript.            |\n\n## Swagger\n- Swagger UI available in `/docs` route\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpedroaurelli%2Ffastify-swagger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpedroaurelli%2Ffastify-swagger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpedroaurelli%2Ffastify-swagger/lists"}