flutter-pro-max-cli - npm Package Compare versions

Comparing version 2.3.5 to 2.4.0

assets/data/play-store.csv

+Stage,Goal,Prompt Template,Output Schema,Required Inputs,Length/Limit,Quality Gate,Notes
+Input Analyzer,"Extract app positioning before writing store copy","I will provide an app idea, feature list, or codebase summary. Act as an ASO specialist and identify the USP, primary persona, core problem, keyword clusters, best-fit category, and tags.","{ usp, persona, short_tail_keywords, long_tail_keywords, category, tags, differentiation }","feature summary, target user, monetization model, platform scope","No invented claims; infer only from provided facts","Use plain language and avoid keyword stuffing","Start with facts, then infer positioning"
+App Name,"Create a compliant title","Generate an app name that combines the brand with one core keyword. Keep it readable and policy-safe.","{ app_name, rationale }","brand name, core keyword","Max 30 characters","Avoid 'best', '#1', and misleading claims","Prefer natural phrasing over forced keyword matches"
+Short Description,"Write a high-converting summary","Write a short description that states the main value and ends with a soft CTA.","{ short_description, rationale }","core value proposition, target user","Max 80 characters","One sentence only; no spammy repetition","Focus on the strongest benefit"
+Full Description,"Generate structured store copy","Write a full description with sections for intro, key features, benefits, how it works, trust, and privacy.","{ intro, features, benefits, how_it_works, trust, privacy }","feature list, differentiators, proof points","Max 4000 characters","Must be truthful, readable, and scannable","Use bullet lists and short paragraphs"
+Keyword Strategy,"Surface relevant ASO keywords","List short-tail and long-tail keywords with priority levels and intent notes.","{ primary_keywords, secondary_keywords, long_tail_keywords, intent_notes }","industry, user pain points, competitor context","No volume claims unless provided by data","Prefer relevance over density","Group by intent and feature"
+Content Rating,"Answer IARC prompts honestly","Map the app features to the likely content rating answers and flag any uncertain items that need human confirmation.","{ violence, language, user_control, location, social_features, gambling }","app interactions, social features, location use, user-generated content","Do not guess when the feature is unknown","Truthful answers only","Escalate any unclear sensitive content"
+Data Safety,"Prepare the Data Safety declaration","List the data types the app actually collects or shares, how they are used, and whether they are encrypted in transit and deletable.","{ personal_info, location, device_id, app_activity, photos_videos, files_docs, encryption, deletion_request }","actual data collection flows, analytics, auth, ads, location usage","Only declare data that exists in the product","No generic blanket claims","Match the declaration to real behavior"
+Privacy Policy,"Draft policy sections","Generate a privacy policy outline covering collection, use, sharing, retention, security, and user requests.","{ overview, data_collected, purpose, sharing, retention, security, user_rights, contact }","support email, domain, data handling model","Must be published at a stable URL","Include deletion request path when supported","Keep the language clear and direct"
+Screenshots,"Guide store screenshot order","Create a screenshot plan that shows the core value first, then the main workflows, trust signals, and final CTA.","{ first_shot, feature_shots, trust_shots, cta_shot }","top feature, target persona, core workflow","Use up-to-date device mockups only","First image must show the core feature","Avoid outdated phones and clutter"
+Feature Graphic,"Specify promo asset guidance","Define the feature graphic message, visual focus, and safe area for the Play Store feature graphic.","{ message, focal_point, safe_area, brand_elements }","one core promise, brand colors, icon, logo","Respect 1280x720 composition","No tiny text; keep the message bold","Optimize for fast comprehension"
+Localization,"Adapt listing for locales","Localize the store listing and keyword set for each target language without changing the product promise.","{ locale, localized_name, localized_short_description, localized_keywords }","target locales, language variants","Keep meaning aligned across locales","Do not translate keywords blindly","Use native phrasing per market"
+Compliance Checklist,"Run a final release check","Create a final checklist for policy, privacy, screenshots, contact info, and store consistency.","{ policy, privacy, contact, screenshots, data_safety, rating, metadata }","all generated store assets","Must pass before publishing","No missing links or broken contact paths","Treat this as the final gate before submission"
+Export,"Render machine-readable output","Return the final Google Play workflow result in both Markdown and JSON so it can be pasted into Play Console tooling or a docs pipeline.","{ markdown, json, notes }","all generated fields","Keep JSON stable and explicit","Preserve field names across runs","Useful for handoff and automation"

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

+---
+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.

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

+---
+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.

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

+---
+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.

assets/scripts/core.py

@@ -113,2 +113,7 @@ #!/usr/bin/env python3
     },
+    "play-store": {
+        "file": "play-store.csv",
+        "search_cols": ["Stage", "Goal", "Prompt Template", "Output Schema", "Required Inputs", "Length/Limit", "Quality Gate", "Notes"],
+        "output_cols": ["Stage", "Goal", "Prompt Template", "Output Schema", "Required Inputs", "Length/Limit", "Quality Gate", "Notes"]
+    },
     "performance": {
@@ -271,2 +276,7 @@ "file": "flutter-performance.csv",
         "prompt": ["prompt", "ai", "css", "tailwind", "implementation"],
+        "play-store": [
+            "play store", "google play", "play console", "aso", "app store optimization",
+            "data safety", "content rating", "privacy policy", "app listing", "store listing",
+            "app name", "short description", "full description", "screenshot", "feature graphic"
+        ],
     }
@@ -273,0 +283,0 @@

assets/scripts/search.py

@@ -6,6 +6,6 @@ #!/usr/bin/env python3
 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
@@ -72,2 +72,3 @@
   python search.py "state management" --stack riverpod
+    python search.py "google play store listing" --domain play-store
   python search.py "login" --json
@@ -74,0 +75,0 @@ """

assets/templates/base/quick-reference.md

@@ -37,2 +37,6 @@
 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
 ```
@@ -77,2 +81,9 @@
 
+### 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:**
@@ -79,0 +90,0 @@ ```bash

assets/templates/base/skill-content.md

@@ -46,3 +46,3 @@ # {{TITLE}}
 
-**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`
 
@@ -78,5 +78,34 @@ **Available stacks:** `riverpod`, `bloc`, `provider`
 | 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
@@ -83,0 +112,0 @@

dist/utils/template.js

@@ -96,2 +96,3 @@ import { readFile, mkdir, writeFile, cp, access, readdir } from 'node:fs/promises';
     let content = await loadTemplate(`base/${templateFile}`);
+    const scriptDir = dirname(config.scriptPath);
     // Load quick reference if needed
@@ -102,3 +103,3 @@ let quickReferenceContent = '';
         // Replace script path in quick reference
-        quickReferenceContent = quickReferenceContent.replace(/\{\{SCRIPT_PATH\}\}/g, config.scriptPath);
+        quickReferenceContent = quickReferenceContent.replace(/\{\{SCRIPT_PATH\}\}/g, scriptDir);
     }
@@ -112,3 +113,3 @@ // Build the final content
         .replace(/\{\{DESCRIPTION\}\}/g, config.description)
-        .replace(/\{\{SCRIPT_PATH\}\}/g, config.scriptPath)
+        .replace(/\{\{SCRIPT_PATH\}\}/g, scriptDir)
         .replace(/\{\{SKILL_OR_WORKFLOW\}\}/g, config.skillOrWorkflow)
@@ -115,0 +116,0 @@ .replace(/\{\{QUICK_REFERENCE\}\}/g, quickRefWithNewline);

package.json

 {
     "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",
@@ -5,0 +5,0 @@ "type": "module",

README.md

@@ -67,2 +67,11 @@ # 🚀 Flutter Pro Max CLI
 
+### npm Publish
+
+The CLI can be published automatically from GitHub Actions via [.github/workflows/npm-publish.yml](../.github/workflows/npm-publish.yml).
+
+Requirements:
+- Add `NPM_TOKEN` to repository secrets
+- Bump `cli/package.json` version before pushing to `main`
+- The workflow skips publish if that exact version already exists on npm
+
 ---
@@ -69,0 +78,0 @@

New alerts

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Found 1 instance in 1 package

Fixed alerts

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

467382

2.39%

Number of package files

81

5.19%

Lines of code

2698

0.45%

Number of lines in readme file

234

4%

No dependency changes