skills.rest
warpdotdev
warpdotdevOFFICIAL
Explore all skills by this author →
WebsiteGitHub

gui-create-launch-modal

Creates one-time launch modals in the Warp GUI desktop client with feature flags and theme tokens.

64.7k|5.5k|Updated Jul 8, 2021
Search Tags:#desktop app#Rust#gui#Onboarding#feature flag#Warp#launch modal
One-click install
npx skills add https://github.com/warpdotdev/warp --skill gui-create-launch-modal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gui-create-launch-modal
Source: https://github.com/warpdotdev/warp/tree/main/.agents/skills/gui-create-launch-modal
Command: npx skills add https://github.com/warpdotdev/warp --skill gui-create-launch-modal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Adding a one-time feature announcement or onboarding modal to the Warp GUI desktop client requires coordinated changes across feature flags, settings, modal state models, view files, workspace wiring, and debug actions, and missing any step causes bugs like new users seeing stale announcements.

Core Features & Use Cases

  • End-to-end checklist: Covers feature flag registration in warp_features, settings fields in AISettings, trigger logic in OneTimeModalModel, view files, workspace wiring, and debug actions.
  • Theme-correct UI guidance: Enforces Warp theme tokens and terminal theme colors instead of hardcoded hex values, with patterns for hero images and "New" badges.
  • Correct one-time behavior: Pre-dismisses the modal for new signups, suppresses it on the Integration channel, and persists dismissal globally across devices.
  • Use Case: When shipping a new Warp feature, use this Skill to scaffold a launch modal that appears exactly once per existing user on startup, gated behind a feature flag.

Quick Start

Create a one-time launch modal in the Warp GUI app for our new feature, following the orchestration_launch_modal reference implementation with a feature flag, settings field, trigger logic, view, and debug actions.

Frequently Asked Questions about gui-create-launch-modal

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

FAQPage Schema
How do I add a one-time launch modal to the Warp desktop app?▼

Add a feature flag in warp_features, a boolean settings field in AISettings, trigger logic in OneTimeModalModel, view files under app/src/workspace/view/, workspace wiring in view.rs and mod.rs, and debug actions. Follow the orchestration_launch_modal directory as the reference implementation.

How do I show a modal only once per user across devices?▼

Model the shown-state as a private boolean setting synced globally with SyncToCloud::Globally and RespectUserSyncSetting::No. Set it to true when the modal triggers so it persists across all of the user's devices.

Does this launch modal pattern work in the Warp TUI front-end?▼

No, this pattern applies only to the GUI desktop front-end built on the WarpUI pixel/GPU framework. The headless TUI front-end uses its own components and workflows covered by the tui-ui-guidelines, tui-testing, and tui-verify-change skills.

Why do new users see the launch modal after onboarding?▼

This happens when the modal is not pre-dismissed in the AuthComplete new-user branch of OneTimeModalModel. Set the modal's settings field to true for new signups so they never see announcements for features that predate their account.

What colors should a Warp launch modal use?▼

Use Warp theme tokens such as surface_3 for backgrounds, main_text_color and sub_text_color for text, and terminal theme colors like normal.magenta for accents. Avoid hardcoded hex values so the modal adapts to user themes.

Related Skills

Explore More Software Engineering Skills→
Luohao-YanLuohao-Yan
6

create-launch-modal

Create a one-time launch modal in the Warp client using feature flags and theme tokens.

Community
Intermediate
warpdotdevwarpdotdev
64.1k

add-feature-flag

Add a runtime feature flag to gate Warp code changes.

Official
Advanced
alslimanyalslimany

fluxui-development

Guide Flux UI component creation and theming in Livewire apps.

Community
Advanced
archibatearchibate
103

interactive-test

Guide terminal-based testing of GUI and TUI applications with Playwright or tmux.

Community
Intermediate