flutter-pro-max-cli 2.3.5 → 2.4.0

package/assets/scripts/search.py

@@ -3,10 +3,10 @@
 """
 Flutter Pro Max Search - CLI for Flutter knowledge base search
 Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--top 5]
-       python search.py "<query>" --design-system [-p "Project Name"]
-       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
+    python search.py "<query>" --design-system [-p "Project Name"]
+    python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
 
-Domains: widget, package, pattern, architect, chart, color, typography, style, ux, icon, landing, naming, product, prompt, performance, ui-reasoning, accessibility
+Domains: widget, package, pattern, architect, chart, color, typography, style, ux, icon, landing, naming, product, prompt, play-store, performance, ui-reasoning, accessibility
 Stacks: riverpod, bloc, provider
 
 Persistence (Master + Overrides pattern):
@@ -68,6 +68,7 @@ Examples:
   python search.py "ListView pagination" --top 3
   python search.py "network http" --domain package
   python search.py "state management" --stack riverpod
+    python search.py "google play store listing" --domain play-store
   python search.py "login" --json
         """
     )

package/assets/templates/base/quick-reference.md

@@ -34,6 +34,10 @@ python3 {{SCRIPT_PATH}}/search.py "state" --stack provider --top 5
 
 # JSON output
 python3 {{SCRIPT_PATH}}/search.py "login" --json --top 3
+
+# Google Play Console workflow
+python3 {{SCRIPT_PATH}}/search.py "google play listing" --domain play-store --top 5
+python3 {{SCRIPT_PATH}}/search.py "data safety content rating" --domain play-store --json --top 5
 ```
 
 ### Package Management
@@ -73,6 +77,13 @@ dart pub remove <package_name>
 
 4. **Apply results** với native state management (ValueNotifier/ChangeNotifier)
 
+### Google Play Console Workflow
+
+1. Search `play-store` for ASO, listing copy, and compliance guidance.
+2. Generate text assets with the correct limits before writing anything final.
+3. Validate content rating, data safety, screenshots, and privacy policy details.
+4. Export Markdown for humans and JSON for machine-readable handoff.
+
 5. **Validate:**
    ```bash
    dart format . && flutter analyze . && flutter test .

package/assets/templates/base/rules/16_google_play_aso.md

@@ -0,0 +1,40 @@
+---
+description: Google Play ASO, store listing copy, keyword strategy
+globs: *
+---
+
+# Rule: Google Play ASO
+
+> Kich hoat: Khi user yeu cau tao hoac toi uu listing Google Play, app name, short description, full description, keyword set, hoac export Play Console.
+
+## Luon lam truoc khi viet copy
+
+1. Xac dinh USP thuc su cua app.
+2. Xac dinh persona chinh va pain point.
+3. Lay keyword cluster theo y nghia, khong theo spam density.
+4. Kiem tra gioi han text truoc khi tra ket qua.
+
+## Gioi han can tuan thu
+
+| Asset | Limit | Nguyen tac |
+|------|-------|------------|
+| App Name | 30 ky tu | Brand + 1 tu khoa chinh |
+| Short Description | 80 ky tu | 1 cau, ro loi ich |
+| Full Description | 4000 ky tu | Co cau truc, de scan |
+
+## Khong duoc lam
+
+- Khong dung "best", "#1", hoac claim phong dai.
+- Khong spam keyword lap lai vo nghia.
+- Khong viet copy khac voi tinh nang that.
+- Khong bo qua kha nang da ngon ngu neu app co thi truong quoc te.
+
+## Output mong doi
+
+- App name
+- Short description
+- Full description
+- Keyword set theo muc do uu tien
+- Category va tags de xuat
+
+> Neu thong tin dau vao khong du, phai ghi ro gia dinh va phan can xac minh.

package/assets/templates/base/rules/17_google_play_compliance.md

@@ -0,0 +1,39 @@
+---
+description: Google Play content rating, data safety, privacy policy
+globs: *
+---
+
+# Rule: Google Play Compliance
+
+> Kich hoat: Khi user yeu cau content rating, data safety, privacy policy, location disclosure, hoac release checklist.
+
+## Content Rating
+
+- Tra loi IARC theo tinh nang that.
+- Neu app co UGC, report, block, hoac moderation, phai de cap ro.
+- Neu app co location, phai phan biet approximate va precise.
+- Khong doan mo neu chua biet; danh dau can xac minh.
+
+## Data Safety
+
+- Chi khai bao du lieu that su thu thap hoac chia se.
+- Neu co du lieu ca nhan, phai ghi ro muc dich su dung.
+- Neu du lieu duoc ma hoa khi truyen, ghi ro "encrypted in transit".
+- Neu app ho tro xoa du lieu, ghi ro duong dan request xoa.
+
+## Privacy Policy
+
+- Phai co URL on dinh va hoat dong.
+- Phai neu ro loai du lieu, muc dich, retention, sharing, va contact.
+- Email ho tro phai khop voi domain neu co the.
+
+## Final Gate
+
+Truoc khi xuat ket qua, phai kiem tra:
+
+1. Content rating co trung thuc.
+2. Data safety khop voi hanh vi san pham.
+3. Privacy policy co link va noi dung day du.
+4. Thong tin lien he hoat dong.
+
+> Compliance sai se gay reject, nen uong dua vao facts, khong phai assumptions.

package/assets/templates/base/rules/18_google_play_visuals.md

@@ -0,0 +1,35 @@
+---
+description: Google Play screenshots, feature graphic, icon guidance
+globs: *
+---
+
+# Rule: Google Play Visuals
+
+> Kich hoat: Khi user yeu cau screenshot, feature graphic, icon guidance, hoac visual pack cho Play Store.
+
+## Screenshots
+
+- Anh dau tien phai the hien core feature manh nhat.
+- Thu tu anh nen di tu value -> feature -> trust -> CTA.
+- Khong dung device mockup qua cu.
+- Khong nhieu chu, khong lam nguoi xem phai doc qua lau.
+
+## Feature Graphic
+
+- Mot thong diep chinh, mot focal point ro rang.
+- Chu to, ngan, de nhan biet tren mobile.
+- Giu safe area sach, khong nhot qua nhieu icon.
+
+## Icon / Brand
+
+- Khong dung trademark cua ben thu ba neu khong co quyen.
+- Giữ mau sac nhat quan voi app.
+- Uu tien hinh khoi don gian, nhan dien nhanh.
+
+## Quality Gate
+
+- Co core feature ngay anh dau.
+- Device mockup hien dai va dong nhat.
+- Visual khong lam sai san pham that.
+
+> Muc tieu la tang conversion, khong phai trang tri vo nghia.

package/assets/templates/base/skill-content.md

@@ -43,7 +43,7 @@ python3 {{SCRIPT_PATH}}/search.py "<keyword>" --stack riverpod --top 5
 python3 {{SCRIPT_PATH}}/search.py "<keyword>" --json --top 5
 ```
 
-**Available domains (17):** `widget`, `package`, `pattern`, `architect`, `chart`, `color`, `typography`, `style`, `ux`, `icon`, `landing`, `naming`, `product`, `prompt`, `performance`, `ui-reasoning`, `accessibility`
+**Available domains (18):** `widget`, `package`, `pattern`, `architect`, `chart`, `color`, `typography`, `style`, `ux`, `icon`, `landing`, `naming`, `product`, `prompt`, `play-store`, `performance`, `ui-reasoning`, `accessibility`
 
 **Available stacks:** `riverpod`, `bloc`, `provider`
 
@@ -74,9 +74,38 @@ python3 {{SCRIPT_PATH}}/search.py "<keyword>" --json --top 5
 | Naming | `name_convention.csv` | Naming conventions |
 | Products | `products.csv` | Product type styling |
 | Prompts | `prompts.csv` | AI prompt templates |
+| Play Store | `play-store.csv` | ASO, store listing, compliance, privacy |
 
 ---
 
+## Google Play Console Workflow
+
+Use the `play-store` domain when the user asks for ASO, app listing copy, content rating, data safety, screenshots, privacy policy, or Play Console export.
+
+### Suggested Flow
+
+1. Analyze the app input and extract USP, persona, keywords, category, and tags.
+2. Generate store text assets with strict length limits.
+3. Validate compliance details for content rating, data safety, and privacy.
+4. Produce screenshot and feature graphic guidance.
+5. Export the result as Markdown and JSON when needed.
+
+### Example Queries
+
+```bash
+python3 {{SCRIPT_PATH}}/search.py "google play store listing" --domain play-store --top 5
+python3 {{SCRIPT_PATH}}/search.py "content rating data safety" --domain play-store --top 5
+python3 {{SCRIPT_PATH}}/search.py "app name short description" --domain play-store --json --top 5
+```
+
+### Output Targets
+
+- App Name: max 30 characters, brand + core keyword
+- Short Description: max 80 characters, concise value proposition
+- Full Description: max 4000 characters, structured and policy-safe
+- Compliance Pack: content rating answers, data safety table, privacy notes
+- Visual Pack: first screenshot guidance, feature graphic, icon rules
+
 ## Example Workflow
 
 **User Request:** "Tạo màn hình đăng nhập"

package/dist/utils/template.js

@@ -93,12 +93,13 @@ export async function renderSkillFile(config) {
     // Load base template (use config.template or default to skill-content.md)
     const templateFile = config.template || 'skill-content.md';
     let content = await loadTemplate(`base/${templateFile}`);
+    const scriptDir = dirname(config.scriptPath);
     // Load quick reference if needed
     let quickReferenceContent = '';
     if (config.sections.quickReference) {
         quickReferenceContent = await loadTemplate('base/quick-reference.md');
         // Replace script path in quick reference
-        quickReferenceContent = quickReferenceContent.replace(/\{\{SCRIPT_PATH\}\}/g, config.scriptPath);
+        quickReferenceContent = quickReferenceContent.replace(/\{\{SCRIPT_PATH\}\}/g, scriptDir);
     }
     // Build the final content
     const frontmatter = renderFrontmatter(config.frontmatter);
@@ -107,7 +108,7 @@ export async function renderSkillFile(config) {
     content = content
         .replace(/\{\{TITLE\}\}/g, config.title)
         .replace(/\{\{DESCRIPTION\}\}/g, config.description)
-        .replace(/\{\{SCRIPT_PATH\}\}/g, config.scriptPath)
+        .replace(/\{\{SCRIPT_PATH\}\}/g, scriptDir)
         .replace(/\{\{SKILL_OR_WORKFLOW\}\}/g, config.skillOrWorkflow)
         .replace(/\{\{QUICK_REFERENCE\}\}/g, quickRefWithNewline);
     return frontmatter + content;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "flutter-pro-max-cli",
-    "version": "2.3.5",
+    "version": "2.4.0",
     "description": "CLI to install Flutter Pro Max skill for AI coding assistants",
     "type": "module",
     "bin": {