@wix/himalaya-cli 0.1614.0 → 0.1616.0

package/templates/salon-spa/README.md

@@ -0,0 +1,53 @@
+# __HIMI_APP_NAME__ — from the `salon-spa` template
+
+A beauty salon / aesthetics clinic / day spa app over a real Wix site: a home with the signature-treatment rail, categories, an offer and the team; Categories with search; the shared Branded Lite booking flow in salon words — treatments by category, a treatment with a favorites heart, times by staff with checkout for paid treatments, My Bookings; Favorites; Our space (Pro Gallery); Message the salon (the Wix Inbox chat); About & visit. Boots as a VISITOR (the treatment menu paints with no login); booking, My Bookings and the chat open Branded Lite's sign-in form as a sheet.
+
+Everything here is now yours to edit — screens in `dev/`, logic in `tier5-src/`,
+identity and navigation in `config.ts`, look and feel in `tokens.json`.
+
+## Point at your Wix site
+
+Your **Wix Headless `clientId` binds the data** — the visitor token minted from it already
+names your site, so reads need nothing else. Set these before `himi build` / preview so calls
+hit YOUR site (the placeholders are not a real backend):
+
+    export WIX_CLIENT_ID="<headless-oauth-client-id>"
+    export WIX_SITE_URL="https://your-site.wixsite.com/…"
+    export WIX_SITE_ID="<metasite-id>"
+
+`WIX_SITE_ID` is the site that client belongs to. The member login takes it from the environment
+while `WIX_CLIENT_ID` is the client the config uses. A native build needs it for member sign-up on
+a CAPTCHA-protected site, push registration and in-app purchases.
+
+Full details, including how to ship a binary a customer can install against their own
+site: `himi docs branded-lite-site-binding`.
+
+## The loop
+
+    himi build                     # compile tier5-src/* -> dist/bundles
+    himi validate                  # screens, bindings and worker boot
+    himi render <screenId> --tree  # render a screen right here, no device needed
+    himi test                      # exercise every action your screens declare
+    himi login --browser --target wix   # sign in with your Wix account (once)
+                                        # no browser? export WIX_API_KEY, then himi login --wix --target wix
+    himi push --draft              # publish a DRAFT release + get preview links
+
+Build, validate, render and test run entirely on your machine. Only `login` and
+`push` reach Wix. No per-app install is needed: the CLI ships the `@wix/himalaya`
+runtime it compiles against.
+
+## Pattern index — where to look for each recipe
+
+| Pattern | Screens |
+|---|---|
+| Data-derived categories (grid of round tiles) | salon_home categories, salon_treatments |
+| Category deep link (an anchor into a shared list) | category tile → himi_services (category nav param) |
+| Horizontal rails (bound LazyList) | salon_home signature treatments, team |
+| Reusing a shared screen in your own words (stock-string copy rewrite) | himi_services, himi_service, himi_time, himi_bookings |
+| Favorites on device (a heart on a shared detail) | himi_service heart → salon_favorites |
+| Four-state screens (loading/empty/error/loaded) | every list screen |
+| Gateway Pro Gallery covers + photo grid | himi_galleries → himi_gallery |
+| Member chat with the business (Wix Inbox) | himi_business_chat |
+
+Guides: `himi docs recipe-dynamic-list`, `himi docs tier-5-add-a-screen`,
+`himi docs designing-himi-screens`. Seed references: `himi agent-init`.

package/templates/salon-spa/config.ts

@@ -0,0 +1,272 @@
+// Your app's configuration — identity, auth, navigation, capabilities and tokens.
+// Inspect the live values any time with `himi context`; see `himi docs app-config`.
+import { defineApp } from "@himalaya/core";
+import { WixConsumerAuthProvider } from "@himalaya/wix-auth";
+import { ConsoleTelemetrySink } from "@himalaya/telemetry-console";
+
+export default defineApp({
+  id: "__HIMI_APP_DOTID__",
+  name: "__HIMI_APP_NAME__",
+  bundleId: "__HIMI_APP_DOTID__",
+  applicationId: "__HIMI_APP_DOTID__",
+  // Placeholders — an over-the-air app never consumes these. Leave as-is.
+  schemaPackage: "@example/__HIMI_APP_SLUG__-schema",
+  schemaPackageRange: { min: 9900, max: 9909 },
+  // Placeholders — only a local server would read these. Leave as-is.
+  ports: { devServer: 8190, web: 5390 },
+  auth: WixConsumerAuthProvider({
+    // POINT THESE AT YOUR SITE — set WIX_CLIENT_ID (a public headless OAuth client id)
+    // and WIX_SITE_URL (your live site URL). The placeholders below are NOT a real
+    // backend; the app boots but reads nothing until you set them. The site needs
+    // Wix Bookings; Pro Gallery and the Wix Inbox chat are optional.
+    clientId: process.env.WIX_CLIENT_ID ?? "YOUR_WIX_CLIENT_ID",
+    siteUrl: process.env.WIX_SITE_URL ?? "https://your-site.example.com",
+    // The OAuth redirect must be ALLOWLISTED on the headless client in `clientId`.
+    redirectUri: process.env.WIX_REDIRECT_URI ?? "himalaya-__HIMI_APP_SLUG__://oauth/callback",
+    bootAsVisitor: true,
+    preserveVisitorOnSignOut: true,
+  }),
+  telemetry: ConsoleTelemetrySink(),
+  serverUrls: {
+    screen: "http://localhost:8190/v1",
+    actions: "http://localhost:8190/v1/actions",
+    sync: "http://localhost:8190/v1/sync",
+  },
+  capabilities: ["wix_api","local_database","open_url","share","secure_storage","wix_platform","app_info","wix_chat","calendar","iap","wix_cashier"],
+  designTokensPath: "./tokens.json",
+  navigation: {
+    "navKind": "responsive",
+    "scheme": "himalaya-__HIMI_APP_SLUG__",
+    "deepLinkPatterns": [],
+    "linkableScreens": [
+      {
+        "screenId": "salon_home",
+        "isPublic": true,
+        "paramKeys": [],
+        "parentScreenId": "",
+        "tabId": "home"
+      },
+      {
+        "screenId": "salon_treatments",
+        "isPublic": true,
+        "paramKeys": [],
+        "parentScreenId": "salon_home",
+        "tabId": "home"
+      },
+      {
+        "screenId": "himi_services",
+        "isPublic": true,
+        "paramKeys": [
+          "category",
+          "categoryActivation"
+        ],
+        "parentScreenId": "salon_home",
+        "tabId": "home"
+      },
+      {
+        "screenId": "himi_service",
+        "isPublic": true,
+        "paramKeys": [
+          "id",
+          "sessionId",
+          "start"
+        ],
+        "parentScreenId": "himi_services",
+        "tabId": "home"
+      },
+      {
+        "screenId": "himi_time",
+        "isPublic": true,
+        "paramKeys": [
+          "id",
+          "course",
+          "start",
+          "sessionId"
+        ],
+        "parentScreenId": "himi_service",
+        "tabId": "home"
+      },
+      {
+        "screenId": "himi_agenda",
+        "isPublic": true,
+        "paramKeys": [],
+        "parentScreenId": "himi_services",
+        "tabId": "home"
+      },
+      {
+        "screenId": "himi_galleries",
+        "isPublic": true,
+        "paramKeys": [],
+        "parentScreenId": "salon_home",
+        "tabId": "home"
+      },
+      {
+        "screenId": "himi_gallery",
+        "isPublic": true,
+        "paramKeys": [
+          "id",
+          "name",
+          "subtitle",
+          "source"
+        ],
+        "parentScreenId": "himi_galleries",
+        "tabId": "home"
+      },
+      {
+        "screenId": "salon_about",
+        "isPublic": true,
+        "paramKeys": [],
+        "parentScreenId": "salon_home",
+        "tabId": "home"
+      },
+      {
+        "screenId": "himi_bookings",
+        "isPublic": false,
+        "paramKeys": [],
+        "parentScreenId": "",
+        "tabId": "bookings"
+      },
+      {
+        "screenId": "salon_favorites",
+        "isPublic": true,
+        "paramKeys": [],
+        "parentScreenId": "",
+        "tabId": "favorites"
+      },
+      {
+        "screenId": "himi_account",
+        "isPublic": true,
+        "paramKeys": [],
+        "parentScreenId": "",
+        "tabId": "profile"
+      },
+      {
+        "screenId": "himi_sign_in",
+        "isPublic": true,
+        "paramKeys": [
+          "mode",
+          "intent",
+          "modal",
+          "returnTab",
+          "contextName",
+          "returnScreenId",
+          "returnId",
+          "returnChannelId",
+          "authContinuation"
+        ],
+        "parentScreenId": "himi_account",
+        "tabId": "profile"
+      },
+      {
+        "screenId": "himi_business_chat",
+        "isPublic": false,
+        "paramKeys": [],
+        "parentScreenId": "salon_home",
+        "tabId": "home"
+      }
+    ],
+    "tabBar": {
+      "presentation": "native",
+      "items": [
+        {
+          "id": "home",
+          "screenId": "salon_home",
+          "label": "Home",
+          "icon": "home",
+          "selectedIcon": "home_fill"
+        },
+        {
+          "id": "bookings",
+          "screenId": "himi_bookings",
+          "label": "Bookings",
+          "icon": "calendar"
+        },
+        {
+          "id": "favorites",
+          "screenId": "salon_favorites",
+          "label": "Favorites",
+          "icon": "heart",
+          "selectedIcon": "heart_fill"
+        },
+        {
+          "id": "profile",
+          "screenId": "himi_account",
+          "label": "Profile",
+          "icon": "person",
+          "selectedIcon": "person_fill"
+        }
+      ]
+    }
+  },
+  // This app talks to a language model (dual LLM / remote model).
+  agent: {
+    "onDevice": {
+      "ios": "foundation_models",
+      "android": "mediapipe"
+    },
+    "remote": {
+      "providerId": "anthropic",
+      "config": {
+        "model": "claude-haiku-4-5"
+      }
+    },
+    "privateModeToggle": false
+  },
+  entities: {},
+  // Your on-device database. It must declare every entity a worker reads or writes,
+  // or those calls fail closed — keep it in step with `local_database` above.
+  dataSchema: {
+    "version": 1,
+    "entities": [
+      {
+        "name": "services",
+        "encrypted": false,
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "name",
+            "type": "string"
+          }
+        ]
+      },
+      {
+        "name": "booking_prefs",
+        "encrypted": false,
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "locationId",
+            "type": "string"
+          },
+          {
+            "name": "locationLabel",
+            "type": "string"
+          }
+        ]
+      },
+      {
+        "name": "member_bookings",
+        "encrypted": true,
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "serviceId",
+            "type": "string"
+          }
+        ]
+      }
+    ]
+  },
+});