[공유] 앱인토스 미니앱 개발을 위한 커뮤니티 오픈소스

개발
1

이 글의 성격은 무엇인가요?

아이디어 / 제안

내용을 설명해주세요

미니앱 개발을 좀 더 편하게 할 수 있는 도구들을 만들어봤습니다.

앱인토스 미니앱을 개발하면서 자주 필요했던 것들을 정리해서 apps-in-toss-community에 올렸어요.

토스 앱 없이 브라우저에서 바로 개발하고 테스트할 수 있는 도구부터, SDK를 직접 실행해보며 확인할 수 있는 예제, 웹 표준 API 처럼 미니앱 기능을 사용할 수 있게 해주는 polyfill, 문서, 인증 연동, 배포 자동화 도구까지 함께 만들고 있습니다.

각 프로젝트는 아래와 같습니다.

  • devtools
    • @apps-in-toss/web-framework SDK의 mock 라이브러리, 번들러 플러그인, floating DevTools 패널입니다. 토스 앱 없이 웹 브라우저에서 미니앱을 구동하고 테스트할 수 있습니다.
  • sdk-example
    • 앱인토스 SDK의 public API를 직접 실행해보면서 결과와 이력을 확인할 수 있는 인터랙티브 예제 앱입니다. 문서만 읽는 대신 실제 동작을 바로 확인할 수 있습니다.
  • polyfill
    • navigator.clipboard, navigator.geolocation 같은 웹 표준 API를 그대로 사용하면서 미니앱 기능을 구현할 수 있게 해주는 polyfill입니다. 앱인토스 환경에서는 SDK로 라우팅되고, 일반 브라우저에서는 원래 웹 API가 그대로 동작합니다.
  • docs
    • 앱인토스 SDK 문서를 바탕으로 다시 정리한 커뮤니티 문서입니다. API 레퍼런스뿐 아니라 실제 구현 흐름과 사용 패턴까지 함께 볼 수 있습니다.
  • oidc-bridge
    • 토스 로그인을 표준 OIDC와 Firebase Custom Token으로 중계해주는 오픈소스 서버입니다. Supabase Auth, Firebase Auth, Auth0 같은 외부 인증 시스템과 더 쉽게 연결할 수 있습니다.
  • console-cli
    • 앱인토스 콘솔 작업을 CLI로 자동화할 수 있는 도구입니다. 한 번 로그인한 뒤에는 빌드, 배포, 릴리스 같은 작업을 커맨드 기반으로 처리할 수 있습니다.
  • agent-plugin
    • 위 도구들을 AI 코딩 에이전트 안에서 함께 사용할 수 있도록 묶은 커뮤니티 플러그인입니다. 미니앱 생성, 문서 확인, 개발 환경 설정, 배포 같은 흐름을 한 번에 연결하는 것을 목표로 하고 있습니다.

전체적으로 문서만 읽다가 막히기보다 직접 실행해보고, 로컬에서 빠르게 개발하고, 운영 과정도 조금 더 단순하게 만드는 데 초점을 맞췄습니다.

커뮤니티 기여도 언제든 환영합니다. 써보시면서 느낀 점이나 아쉬운 점이 있으면 편하게 말씀해주세요.

7개의 좋아요