@nomad-e/bluma-cli 0.11.1 → 0.13.0

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.
@@ -32,8 +32,9 @@ Always read `factorai.sh.json` in the project root before editing a deployed app
32
32
  ## Flow A — New app
33
33
 
34
34
  ```text
35
- 1. factorai.sh.create_next_app({ name: "my-app", template: "full" })
36
- 2. edit_tool / file_write under ./my-app/ (especially app/**)
35
+ 1. factorai.sh.create_next_app({ name: "my-app" })
36
+ Read tool result `agentGuide` (or ./my-app/DESIGN.md): tokens, @/components/ui/* inventory, UI do/don'ts
37
+ 2. edit_tool / file_write under ./my-app/ using shadcn components + semantic Tailwind (bg-background, etc.)
37
38
  3. Avoid npm run build before deploy (.next inflates ZIP); optional npx tsc --noEmit
38
39
  4. factorai.sh.deploy_app({ projectDir: "./my-app", name: "my-app" })
39
40
  5. Poll get_app_status until ready (see Polling)
@@ -75,7 +76,7 @@ Always read `factorai.sh.json` in the project root before editing a deployed app
75
76
 
76
77
  | Tool | Purpose |
77
78
  |------|---------|
78
- | `factorai.sh.create_next_app` | Scaffold Next 14 + App Router + Tailwind (+ shadcn in `full`) |
79
+ | `factorai.sh.create_next_app` | Scaffold Next 14 + full shadcn/ui; returns `agentGuide` + `DESIGN.md`; default = polished dark landing |
79
80
  | `factorai.sh.deploy_app` | First deploy: ZIP source → deploy API on `SEVERINO_URL` |
80
81
  | `factorai.sh.apply_app_changes` | Patch files on server + `next build` + restart |
81
82
  | `factorai.sh.get_app_status` | Status + contract |
@@ -85,7 +86,7 @@ Always read `factorai.sh.json` in the project root before editing a deployed app
85
86
 
86
87
  | Symptom | Action |
87
88
  |---------|--------|
88
- | `Couldn't find app directory` | Scaffold missing `app/`use `template: "full"` or fix `create_next_app` |
89
+ | `Couldn't find app directory` | Re-run `create_next_app`scaffold must include `app/` |
89
90
  | `Cannot find name 'Slot'` | Broken shadcn template — use fixed scaffold or simplify `components/ui/button.tsx` |
90
91
  | ZIP too large | Ensure `node_modules` not in ZIP; `deploy_app` excludes it |
91
92
  | `ready` but 503/JSON error | Keep polling; rebuild still running |