@freeappstore/cli 0.4.38 → 0.4.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +11 -10
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -19,10 +19,11 @@ cd my-app
19
19
  pnpm install && pnpm dev
20
20
  fas check # compliance checks
21
21
  fas publish # provisions repo + hosting + DNS
22
- git push upstream main # auto-deploys via CI
22
+ git remote add upstream https://github.com/freeappstore-online/my-app.git
23
+ git push upstream main # follow the commands printed by fas publish
23
24
  ```
24
25
 
25
- Live in 30 seconds at `https://my-app.freeappstore.online`.
26
+ After the first successful code push and deploy, live at `https://my-app.freeappstore.online`.
26
27
 
27
28
  ## Commands
28
29
 
@@ -33,14 +34,14 @@ Live in 30 seconds at `https://my-app.freeappstore.online`.
33
34
  | `fas logout` | Clear the cached session. |
34
35
  | `fas whoami` | Print the currently signed-in GitHub login. |
35
36
  | `fas doctor` | Health check — Node version, git, pnpm, config, signed-in state, API reachability. |
36
- | `fas init <app-id>` | Scaffold a new free app or game from a platform template. Replaces `APPNAME` placeholders, runs `git init`, makes the first commit. |
37
+ | `fas init <app-id>` | Scaffold an app from a platform template. Game templates remain available; games are published with the separate fgs CLI. Replaces `APPNAME` placeholders, runs `git init`, makes the first commit. |
37
38
  | `fas check` | Run compliance checks (no-tracking, brand fonts, manifest, bundle size). Exits non-zero on hard failures. |
38
39
  | `fas publish` | Provisions repo + hosting route + storefront entry, injects `deploy.yml` if missing, then prints `git remote add` and `git push` instructions. Auto-runs `fas check` first. |
39
40
  | `fas list` (alias `fas ls`) | List apps and games you have published. `--json` for scripting, `-v` for recent commits. |
40
- | `fas logs <app-id>` | Tail live deployment logs for an app (GitHub Actions workflow runs). |
41
+ | `fas logs <app-id>` | Show recent deployment runs and links for an app (GitHub Actions). |
41
42
  | `fas secret set\|list\|rm` | Manage server-side encrypted API keys for an app. |
42
43
  | `fas proxy allow\|list\|deny` | Manage the URL allowlist for the per-app secret-injecting proxy. |
43
- | `fas screencheck` | Build the app and run a headless browser at every reference viewport to verify the layout fits without scrolling. |
44
+ | `fas screencheck` | Build the app and run a browser at the manifest-declared minimum width in portrait and landscape to verify the layout fits without scrolling. |
44
45
  | `fas quality [app-id]` | Show the VCQA code quality report (score + grade) for an app. |
45
46
  | `fas admin transfer-owner <app>` | Admin-only. Move an app to a new owner when `--from` matches the current one, and write an audit record. |
46
47
 
@@ -81,7 +82,7 @@ fas doctor
81
82
 
82
83
  ### `fas init <app-id>`
83
84
 
84
- Scaffold a new free app or game from a platform template. Clones the template repo, substitutes all `APPNAME` placeholders with the given id, and creates the first git commit.
85
+ Scaffold an app from a platform template. Game templates remain available; games are published with the separate fgs CLI. Clones the template repo, substitutes all `APPNAME` placeholders with the given id, and creates the first git commit.
85
86
 
86
87
  ```bash
87
88
  fas init my-app # default: standalone template
@@ -108,13 +109,13 @@ fas check --dir ../my-app
108
109
 
109
110
  ### `fas publish`
110
111
 
111
- Provision and publish an app to FreeAppStore (or FreeGameStore). Runs compliance checks, authenticates, creates a GitHub repo + R2 hosting route + storefront registry entry via the admin Worker, and injects a deploy workflow.
112
+ Provision and publish an app to FreeAppStore. Runs compliance checks, authenticates, creates a GitHub repo + R2 hosting route + storefront registry entry via the admin Worker, and injects a deploy workflow.
112
113
 
113
114
  By default, `publish` is interactive — it asks for category, type, oneliner, and demo URL. Skip prompts by passing flag values; combine with `--yes` to fail fast in CI rather than hang on a missing field.
114
115
 
115
116
  ```bash
116
117
  fas publish # interactive
117
- fas publish --store games # publish to FreeGameStore instead
118
+ fgs publish # FreeGameStore projects use their own CLI
118
119
  fas publish \
119
120
  --name my-app \
120
121
  --category Utilities \
@@ -125,13 +126,13 @@ fas publish \
125
126
 
126
127
  | Flag | Purpose |
127
128
  |---|---|
129
+ | `--store apps` | Legacy selector; the FAS backend rejects games with 410. Use the separate `fgs` CLI for FreeGameStore. |
128
130
  | `--name <id>` | App id (lowercase, used as subdomain). Defaults to `package.json#name`. |
129
131
  | `--category <name>` | Storefront category. Case-insensitive (e.g. `utilities`, `brain training`). |
130
132
  | `--type standalone\|connected` | Standalone (localStorage only) or Connected (uses platform backend). |
131
133
  | `--oneliner <text>` | One-line description shown on the storefront. |
132
134
  | `--demo <url>` | Optional demo URL. Pass `""` to clear. |
133
135
  | `--yes` | Non-interactive: missing required fields abort instead of prompting. |
134
- | `--issue` | Skip auto-provision; open the GitHub Issue submission form instead. |
135
136
  | `--skip-checks` | Skip `fas check` before publish (not recommended). |
136
137
 
137
138
  ### `fas list` (alias `fas ls`)
@@ -292,7 +293,7 @@ Every app and game on the platform shares the same visual language — colors, f
292
293
  5. **Ownership**: records the app in the platform DB so `fas list` returns it.
293
294
  6. **Output**: prints the live URL, repo URL, storefront listing URL, and the `git remote add` + `git push` commands to populate the new repo.
294
295
 
295
- If auto-provision is unavailable (503 from the API), `publish` falls back to opening a prefilled GitHub Issue form for maintainer review. Use `--issue` to force this path.
296
+ If provisioning is unavailable, the command reports the error and exits. Nothing is queued and no submission form opens. Retry after checking the platform status; `--issue` is not a supported flag.
296
297
 
297
298
  ## For AI Agents
298
299
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@freeappstore/cli",
3
- "version": "0.4.38",
3
+ "version": "0.4.39",
4
4
  "description": "fas — CLI for publishing free apps to freeappstore.online",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -21,7 +21,7 @@
21
21
  "cli",
22
22
  "scaffold",
23
23
  "publish",
24
- "cloudflare-pages"
24
+ "cloudflare-r2"
25
25
  ],
26
26
  "files": [
27
27
  "dist",
@@ -38,7 +38,7 @@
38
38
  "prompts": "^2.4.2",
39
39
  "react": "^19.3.0",
40
40
  "@freeappstore/compliance": "0.7.16",
41
- "@freeappstore/quality": "0.1.4"
41
+ "@freeappstore/quality": "0.1.5"
42
42
  },
43
43
  "devDependencies": {
44
44
  "@types/node": "^22.20.2",