10/08/2025 –, RB105
What started as a simple tool to view API docs on my phone, turned into OpenAPI Studio — a full-featured platform for writing, verifying, and sharing OpenAPI files.
As a full-stack developer, I joined a Web3 frontend project and faced a nightmare: API specs were messy HackMD snippets filled with enums and partial responses. Documentation didn’t match reality. I had to brute-force every call just to understand the backend.
So, I built a small tool just for myself. But from version 0.1 to 0.4.7, it evolved into:
A Monaco-based editor with real-time validation, autocomplete, and error feedback (WIP)
Multi-engine validation: Redocly, Spectral, and custom logic
Full RWD support (RTL languages, overflow handling, 390px layout)
Multi-language support (currently refining)
Embed-ready display & planned team collaboration mode
I’m releasing a lightweight open-source version for community use, while building toward a self-hosted or SaaS-ready architecture.
This talk shares how I built the platform, why DX matters deeply to developers, and how a tiny idea born from frustration became a tool worth sharing with the open-source world.
本來只是為了改善團隊協作中 API 文件難用的痛點，沒想到一手打造出整個 API 文件平台 —— OpenAPI Studio。
作為一個獨立全端開發者，在一次 Web3 專案中，我被後端以 HackMD 散貼 enum 及半殘的 response 文件搞到崩潰。為了讓我能隨時在手機上查看文件，也為了解決驗證混亂、格式不一致、Swagger 體驗低落等問題，我決定開發一個簡單的小工具。
沒想到這個工具從 v0.1 一路演進到 v0.4.7，逐步發展出以下功能模組：
即時驗證、自動補全與錯誤訊息提示的 Monaco 編輯器（目前仍在完善中）
Redocly / Spectral / 自研引擎等多重驗證架構
RWD 設計（支援 RTL 語系、文字溢位處理、390px 裝置瀏覽）
多語系支援（包含方向性處理與長文字展延設計，優化中）
文件內嵌展示與協作分享機制（已規劃開發中）
本系統目前正規劃釋出 基礎功能版本作為開源專案，並將穩定模組演進為可自建內部平台與 SaaS 解決方案，走向「半開源 + 可自建 + 訂閱授權」的產品路線。
這次分享將從實際的開發痛點出發，帶大家探討如何設計一套「以開發者體驗（DX）為核心」的系統，同時分享我如何作為個人開發者，一步步讓一個 Side Project 成為具規模與擴展性的產品平台。
曾接觸 Swagger、Postman、Redoc 等工具的開發者，或對 API 文件整合與 DX 優化有實務經驗的團隊與個人開發者。 Developers familiar with Swagger, Postman, or Redoc, and those interested in API integration and DX optimization.
Niveau de difficulté:中階
I’m not your typical startup founder, and I don’t have a wealthy background.
I’m a solo developer — I’ve failed, I’ve been in debt, and I’ve even lost millions.
But I’m still here, because I have something even more valuable:
A family who believes in me — my partner and our three children.
I have no investors, no team, and my business is currently just a sole proprietorship.
But I have passion, I have a vision, and I have multiple working systems I built completely on my own.
I’m participating in COSCUP not just to share my code,
but to prove how far a single person’s effort can go.
I hope to meet partners, to be seen, to be supported —
and maybe, just maybe, to bring this platform to the next stage.
This is a defining step in my life.
Thank you for giving me the chance to take it.
我不是典型的創業者，也沒有富爸爸。我只是個一人獨立開發者，過去曾跌倒過、負債過，甚至賠上千萬。
但我還在這裡，因為我還有一個家，一個支持我的家人與三個孩子。
我沒有資本、沒有團隊，現在的公司也只是登記為商行。
但我有熱情、有願景，還有好幾套我真正自己做出來的系統。
我參與這次 COSCUP，不只是為了分享技術，更是希望能讓更多人看到一個人的努力是可以走多遠的。
也希望能有機會遇見志同道合的夥伴、被看見、被投資、甚至讓這個平台有機會被帶上另一個舞台。
這是我人生重要的一步。謝謝你們給我這個機會。