菜单
Onboarding and re-onboarding flows in TryRamadan. Covers step order, persistence (draft vs final preferences), redirect to dashboard, and edge cases (abandonment, skip location, Muslim vs Non-Muslim path). Use when changing onboarding steps, routes, or completion logic.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
TryRamadan app overview, performance optimizations, and resources. Use when making cross-cutting changes, adding dependencies, or optimizing build/runtime.
Fact-check and verify culture pages, traditions, and recipes; add and validate hyperlink sources; test authenticity of cultural and culinary claims. Use when adding or editing cultural-traditions.json, recipes.json, country pages, recipe pages, or any tradition/food/recipe content in TryRamadan.
Offline and degraded network behavior in TryRamadan. Covers cache-first prayer times, API failure/timeout for Aladhan and location/timezone, and what works offline (fasting log, journal, meals). Use when adding features that call external APIs or read/write cached data.
Web performance and Core Web Vitals (LCP, INP, CLS) in TryRamadan. Covers critical path, lazy loading, images/fonts, and layout stability. Use when changing above-the-fold content, images, fonts, or heavy components on the main route.
Writing clear bug reports and converting bugs into regression tests in TryRamadan. Covers precise title, environment, numbered steps, expected vs actual, missing information, and BUG-<AREA>-<ID> test naming. Use when writing or rewriting bug reports, or when adding regression tests from a fixed bug.
Ramadan calendar (start/end, day number, year boundary), fasting states (completed/skipped/broken), streak and todayOverride in TryRamadan. Use when editing src/lib/ramadan.ts, fasting state transitions, streak calculation, or Ramadan day labels.
| name | onboarding-and-re-onboarding |
| description | Onboarding and re-onboarding flows in TryRamadan. Covers step order, persistence (draft vs final preferences), redirect to dashboard, and edge cases (abandonment, skip location, Muslim vs Non-Muslim path). Use when changing onboarding steps, routes, or completion logic. |
Use this skill when changing onboarding steps, completion logic, or redirect to dashboard so flows and persistence stay correct.
| # | Step | Route | Required? |
|---|---|---|---|
| 1 | Welcome | /onboarding/welcome | — |
| 2 | Mode | /onboarding/mode | Yes (Muslim vs Non-Muslim; Muslim skips Knowledge) |
| 3 | Knowledge | /onboarding/knowledge | Yes if Non-Muslim |
| 4 | Health | /onboarding/health | Yes |
| 5 | Location | /onboarding/location | No (can "Skip for now"; Dashboard shows reminder if missing) |
| 6 | Schedule | /onboarding/schedule | Yes |
| 7 | Notifications | /onboarding/notifications | No |
| 8 | Priorities | /onboarding/priorities | Yes (defaults pre-filled) |
| 9 | Goals | /onboarding/goals | Goals optional |
Doc: docs/ONBOARDING-REONBOARDING-FLOWS.md (information order, time-of-Ramadan variants, abandonment, re-onboarding).
tryramadan-onboarding-draft on every change. Not written to final preferences until completion.persistPreferencesSync(...) (including onboardingComplete: true), persistQuickActionsSync(...) (from priorities). Redirect to /dashboard./onboarding/welcome only when !preferences.onboardingComplete && !hasTime (and not still loading location). Once onboardingComplete is true, user is not forced back into onboarding.persistPreferencesSync and persistQuickActionsSync before navigating away so Dashboard reads fresh data.tryramadan-preferences until completion.src/test/onboardingFlow.test.tsx, src/test/onboardingCritical.test.tsx. Complete onboarding → land on dashboard; preferences persisted; no redirect loop.