Q4 2024 Update
Published on December 21, 2024 by Drew Powers
We’ve hit some of our biggest milestones these past 3 months thanks to our sponsors and all our contributors!
By the numbers
- 📈 openapi-typescript is up to 1.2 million downloads/week on npm (we passed the 1m milestone back in July/Aug!)
- openapi-fetch is up to 390k downloads/week
- openapi-react-query is up to 11k downloads/week
- swr-openapi has joined the project (originally by Hunter Tunnicliff @htunnicliff who is now a maintainer!) and is almost at 3k downloads/week
- 🏆 On average we’re the top Google search result for “openapi typescript” (avg 1.2 position according to search console)
- 🗺️ We average 3k visits/month to the docs site from all around the world, which means lots of attention to the few sponsor logos on our docs pages.
- 🇺🇸 US is the largest country by volume, making up 42% of traffic, 🇸🇬 Singapore at 12%, 🇯🇵 Japan and 🇩🇪 Germany at 9% each, 🇭🇰 Hong Kong and 🇫🇷 France at 5% each, 🇬🇧 UK, 🇳🇱 Netherlands, 🇦🇺 Australia, and 🇨🇦 Canada at 4% each.
- Our docs are localized in English, Japanese, and Chinese, which helps reach a wider audience.
- 👷 Over 175 contributors have contributed code to the projects. 200+ counting issues and bug reports.
Releases and updates
- 🆕 swr-openapi, Hunter’s wrapper for SWR, has been in production for years and has joined this project to benefit from shared updates and maintenance!
- 🆕 openapi-metadata is an exciting new experiment by our maintainer Martin Paucot (@kerwanp) to generate OpenAPI schemas and documentation by using Typescript decorators and metadata. We’re excited about what could come out of this exploration over the next year, including some possible tools to generate documentation.
- 🏋️ Tobias Schlatter (@gzm0) and Hunter Tunnicliff (@htunnicliff) have joined as maintainers, bringing the count to 4! Since taking on sponsorship, we’ve been able to grow the project beyond just myself to bring on people of equal talent and caliber to push this forward
- ✨ openapi-typescript shipped a long-awaited request to export PascalCase types thanks to @BradHacker! It was no small effort. The project also shipped several bugfixes and minor updates.
- 🔜 openapi-fetch is preparing for its big 1.0 release, and shipped several type improvements and bugfixes, as well as a new onError API thanks to @luchsamapparat!
What’s next
We’ve been fortunate to see this grow into one of the primary tools developers use when working with OpenAPI, and have seen year-over-year growth adopting our packages. While it’s hard to say exactly why some tools are more popular than others, I like to think the project goals (paraphrased) resonate with the tens of thousands of devs that use openapi-typescript directly or indirectly:
- Support the full OpenAPI specification
- Prioritize runtime-free static types whenever possible, for maximum performance and the tightest feedback loop possible
- Preserve OpenAPI schemas as-authored
- Rely on Node.js and nothing else
This philosophy that has prioritized performance and wide compatibility over narrow usecases and opinionated approaches, has made this the most widely-applicable, longest-lasting tool for OpenAPI in the JS ecosystem.
So in service of that, the end of 2024 was focused on onboarding more maintainers beyond myself to help the project grow and continue, and we’ve gone from 1 to 4 dedicated maintainers!
2025 will be an exciting year where we not only release the long-awaited openapi-fetch 1.0, and prepare for the upcoming OpenAPI 4.0 spec, but also explore the future of what’s next for APIs, without forgetting the reliability and quality that got us here in the first place. Look forward to some updates next year of what we have planned.
☃️ Happy holidays for those celebrating, and we’ll see you next year! 🎇