cm-growth-hacking

CM Growth Hacking

Bottom Sheet + Calendar + Trigger + Tracking = Growth Hacking Engine. Đa ngành, đa mục đích, zero dependencies. 1 skill = mọi growth hacking pattern bạn cần.

---

🎯 When to Use

Trigger	Action
User says "bottom sheet", "popup"	Activate — start Phase 1
User says "đặt lịch popup", "booking bottom sheet"	Activate — focus booking sheet
User says "lead capture", "exit intent"	Activate — focus lead capture
User says "nhắc lịch", "google calendar", "apple calendar"	Activate — focus calendar CTA
User says "flash sale popup", "countdown"	Activate — focus promo sheet
User says "survey", "đánh giá", "feedback"	Activate — focus survey sheet
User says "tăng conversion", "giảm bounce"	Activate — explain + build

---

📖 Selective Reading Rule (MANDATORY)

File	Status	When to Read
bottom-sheet-engine.md	🔴 REQUIRED	Any bottom sheet implementation
trigger-system.md	🔴 REQUIRED	Setting up when/how sheets appear
calendar-integration.md	⚪ Optional	When sheet includes calendar CTA
tracking-events.md	⚪ Optional	When tracking engagement events

🔴 Always read bottom-sheet-engine.md + trigger-system.md first.

---

🧭 Quick Decision Tree

"I need an engagement popup"
│
├─ Booking / Appointment
│  └─ bottom-sheet-engine + calendar-integration + cm-booking-calendar
│     └─ Form → Sheet: cm-google-form
│     └─ Post-submit: Calendar CTA (GCal + ICS)
│
├─ Lead Capture / Exit Intent
│  └─ bottom-sheet-engine + trigger-system (exit-intent)
│     └─ Form → Sheet: cm-google-form
│     └─ Tracking: cro_lead_capture
│
├─ Flash Sale / Promo
│  └─ bottom-sheet-engine + trigger-system (timer)
│     └─ Countdown timer + CTA
│     └─ Optional: Calendar deadline
│
├─ Survey / Feedback
│  └─ bottom-sheet-engine + trigger-system (post-interaction)
│     └─ Star rating or NPS
│     └─ Form → Sheet: cm-google-form
│
├─ Event / Webinar Registration
│  └─ bottom-sheet-engine + calendar-integration
│     └─ Register → Add to Calendar
│     └─ Tracking: cro_event_register
│
├─ Re-engagement (Return Visitor)
│  └─ bottom-sheet-engine + trigger-system (return-visitor)
│     └─ "Welcome back" + personalized CTA
│
└─ Chat / Contact CTA
   └─ bottom-sheet-engine + trigger-system (scroll)
      └─ Zalo / Messenger / Hotline buttons

---

📋 6-Phase Workflow

Phase 1: DISCOVER → Scan site, detect industry, identify existing popups/forms
Phase 2: SOCRATIC GATE → Ask strategic questions (max 5)
Phase 3: CONFIGURE → Select engagement pattern + customize
Phase 4: BUILD → Generate bottom sheet + triggers + calendar + tracking
Phase 5: INTEGRATE → Wire to site + link skills
Phase 6: VERIFY → Test all interactions + tracking events

🔴 Rule: NEVER skip Phase 1 & 2. Always scan first, ask second.

---

Phase 1: DISCOVER

Scan the website to understand:

# Find existing popups/modals/sheets
grep -ri "modal\|popup\|bottom-sheet\|overlay\|dialog" --include="*.html" --include="*.astro" --include="*.css" .

# Find existing forms
grep -ri "data-form-type\|onsubmit\|<form" --include="*.html" --include="*.astro" .

# Find existing calendar code
grep -ri "VCALENDAR\|google.com/calendar\|\.ics\|VEVENT" --include="*.js" --include="*.html" .

# Find existing tracking
grep -ri "dataLayer\|fbq\|ttq\|gtag" --include="*.js" --include="*.html" .

Output: Discovery Report with detected industry, existing UI, and recommended pattern.

---

Phase 2: SOCRATIC GATE

🔴 MANDATORY. Ask ALL in ONE message. Max 5 questions.

1. Mục tiêu chính — Bạn muốn popup/bottom sheet để làm gì? (đặt lịch / thu lead / khuyến mãi / survey / khác)
2. Trigger — Khi nào hiện? (ngay khi vào trang / scroll X% / sau X giây / khi sắp thoát / click nút)
3. Nội dung — Trong popup cần gì? (form / calendar CTA / countdown / rating / nút chat)
4. Calendar — Có cần thêm Google Calendar / Apple Calendar không? Nhắc trước bao lâu?
5. Tracking — Đang chạy ads platform nào? (Facebook / TikTok / Google / không)

---

Phase 3: CONFIGURE

Based on answers, select from references/engagement-patterns.md and build config:

const ENGAGEMENT_CONFIG = {
  type: 'booking',           // booking | lead | promo | survey | event | chat | reengagement
  trigger: {
    type: 'scroll',          // scroll | time | exit | click | return | interaction
    value: 0.3,              // scroll % or ms or selector
    delay: 0,                // additional delay after trigger
  },
  sheet: {
    size: 'standard',        // compact | standard | full
    title: 'Đặt Lịch Khám',
    icon: '📅',
    dismissible: true,
    swipeToDismiss: true,
  },
  calendar: {
    enabled: true,
    providers: ['gcal', 'ics'],  // gcal | ics | outlook
    reminderMinutes: [1440, 120], // 1 day + 2 hours before
    location: 'Google Maps URL',
  },
  tracking: {
    events: ['cro_sheet_shown', 'cro_booking_submit', 'cro_calendar_add'],
    conversionValue: 500000,
    currency: 'VND',
  },
  session: {
    dismissKey: 'eng_booking_dismissed',
    storage: 'sessionStorage',   // sessionStorage | localStorage
    maxShowPerSession: 1,
  }
};

---

Phase 4: BUILD

Read and use templates from templates/ directory:

Template	Purpose
templates/bottom-sheet.css	Universal responsive bottom sheet CSS
templates/bottom-sheet.js	BottomSheetEngine class — create, show, hide, swipe, stack
templates/calendar-cta.js	Calendar button generators (GCal + ICS + device detection)
templates/trigger-manager.js	TriggerManager class — scroll, time, exit, click triggers
templates/tracking-events.js	DataLayer push helpers for engagement events

---

Phase 5: INTEGRATE

Wire to Existing Skills

cm-growth-hacking (this skill)
│
├── UI Layer ──────────── templates/bottom-sheet.css + .js
│
├── Form Submit ───────── @skills/cm-google-form
│   └── submitToGoogleSheet() → success callback → show calendar CTA
│
├── Calendar Logic ────── @skills/cm-booking-calendar
│   └── calendar-engine.js (scheduling)
│   └── calendar-export.js (ICS + GCal deep link)
│   └── reminder-config.js (VALARM + industry patterns)
│
├── CRO Tracking ──────── @skills/cm-ads-tracker
│   └── dataLayer.push() → GTM → FB/TikTok/Google
│
└── Design Principles ─── @skills/cm-ux-master
    └── Color, typography, animation standards

---

Phase 6: VERIFY

#	Test Case	Expected
1	Bottom sheet opens	Slides up with animation
2	Swipe down to dismiss	Sheet closes + state saved
3	Trigger fires correctly	Sheet appears at configured trigger
4	Form submit (if applicable)	Toast success → Calendar CTA appears
5	Google Calendar click	New tab with pre-filled event
6	ICS download click	.ics file downloads
7	.ics on iOS	Opens Apple Calendar with reminders
8	Tracking events fire	dataLayer shows correct events
9	Session dismiss works	Sheet doesn't reappear after dismiss
10	Mobile responsive	Sheet adapts to viewport
11	Accessibility	aria-labels, focus trap, Escape key
12	No conflict with existing UI	Doesn't break page layout

---

❌ Anti-Patterns

❌ Don't	✅ Do
Hardcode content in sheet	Use config object
Show popup immediately on page load	Use trigger system with delay
No dismiss option	Always allow close + swipe
Forget mobile safe-area	Pad for notched devices
Skip tracking	Track every interaction
One-size-fits-all sheet	Use compact/standard/full variants
Autoplay anything	Require user interaction
Show on every page visit	Respect session/localStorage dismiss
Build calendar logic from scratch	Inherit from cm-booking-calendar
Build tracking from scratch	Inherit from cm-ads-tracker

---

📑 Templates

File	Purpose
templates/bottom-sheet.css	Universal bottom sheet CSS (3 sizes)
templates/bottom-sheet.js	BottomSheetEngine class
templates/calendar-cta.js	Calendar CTA buttons + auto device route
templates/trigger-manager.js	TriggerManager class
templates/tracking-events.js	Engagement tracking helpers

📚 References

File	Purpose
references/engagement-patterns.md	10+ engagement patterns by industry

---

🔗 Related Skills

Need	Skill
Calendar scheduling + export	@[skills/cm-booking-calendar]
Form → Google Sheet	@[skills/cm-google-form]
Full CRO tracking setup	@[skills/cm-ads-tracker]
Audio engagement	@[skills/cm-readit]
UI/UX design principles	@[skills/cm-ux-master]