appintoss-cross-promo

Present branded promo banners that route Toss mini-app users via openURL.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Taek-D/kbo_appintoss --skill appintoss-cross-promo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: appintoss-cross-promo
Source: https://github.com/Taek-D/kbo_appintoss/tree/main/miniapp/.claude/skills/appintoss-cross-promo
Command: npx skills add https://github.com/Taek-D/kbo_appintoss --skill appintoss-cross-promo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Navigating between Toss mini-apps can be cumbersome and disrupts user momentum; this Skill provides cross-promo banners to link to other apps using the SDK openURL, keeping users within the native experience.

Core Features & Use Cases

  • UI-driven cross-app promos presented as banners or a bottom sheet
  • Navigation via the SDK openURL API with a safe web fallback
  • Data-driven PROMO_ITEMS for easy adding/removing promoted apps

Quick Start

Create a cross-promo bottom sheet that lists apps and navigates to them using openURL

Frequently Asked Questions about appintoss-cross-promo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I link to other Toss mini-apps from my current mini-app?

To link Toss mini-apps, dynamically import openURL from @apps-in-toss/web-framework and trigger it via a promo banner to route users natively. This maintains user momentum by keeping navigation within the Toss ecosystem.

What is the best way to implement cross-promotion in Toss mini-apps?

The best way to implement Toss mini-app cross-promotion is using a data-driven Drawer-based UI. Define your promotion targets in a PROMO_ITEMS array, then render branded promo banners that trigger the SDK openURL API for users.

Does the Toss openURL SDK API provide a fallback for web browsers?

Yes, the openURL SDK API implementation includes a safe web fallback. If the native routing is unavailable, the cross-promo banner logic defaults to window.location.href to ensure the user still reaches the target destination.

How do I add or remove promoted apps from a Toss promo banner?

You add or remove promoted apps by updating the PROMO_ITEMS data array. This data-driven approach allows you to manage the cross-app promotion links displayed in the Drawer-based UI without modifying the core navigation logic.

When should I display cross-promo banners in a Toss mini-app?

Display cross-promo banners during natural transition points, especially after users complete rewards or game events. Presenting the Drawer-based UI at these moments encourages users to try other Toss apps without disrupting their momentum.

Can I use a bottom sheet for Toss mini-app cross-promotion?

Yes, you can use a Drawer-based bottom sheet for Toss mini-app cross-promotion. The UI component lists available apps and uses the SDK openURL API to navigate users, providing a native experience when they select a promo banner.