@feeef.dev/cli 0.2.0

package/LICENSE

@@ -0,0 +1,6 @@
+UNLICENSED
+
+Copyright (c) Feeef. All rights reserved.
+
+This package (`@feeef.dev/cli`) is proprietary and not licensed for redistribution
+or modification outside authorized Feeef use. Contact Feeef for licensing.

package/README.md

@@ -0,0 +1,94 @@
+# @feeef.dev/cli
+
+Standalone TypeScript CLI for Feeef theme authors.
+
+```bash
+npm install -g @feeef.dev/cli
+feeef --help
+```
+
+Config: `~/.config/feeef/config.json` (directory `0700`, file `0600`)
+
+## Auth
+
+Default sign-in is **browser OAuth** (PKCE, public client — no client secret):
+
+- Redirect URI: `http://localhost.feeef.org:7777/oauth/callback` (**http**, not https)
+- Callback binds **127.0.0.1** only (`localhost.feeef.org` must resolve to loopback)
+- Client id is built-in
+
+```bash
+feeef signin                    # opens browser → consent → token saved
+feeef signin --password-auth    # email/password fallback (interactive prompt)
+feeef whoami
+feeef signout
+feeef config show
+feeef config set apiUrl http://127.0.0.1:3333/api/v1
+```
+
+## Theme workflow
+
+Themes are **Node.js packages** (`package.json` + scripts). Scripts wrap the global `feeef` CLI.
+
+```bash
+feeef template init my-theme
+cd my-theme
+feeef use                             # pick one of your stores
+
+feeef template add page products
+feeef template add component products grid --title "Product grid"
+
+npm run build                         # or: feeef template build
+npm run check
+npm run dev                           # remote draft preview on your store
+npm run publish -- --apply            # go live (explicit)
+```
+
+### Preview (`feeef template dev`)
+
+Pushes a **draft** theme to your bound store and opens the hosted storefront with a signed `?preview=` token.
+
+- Live customers keep seeing `metadata.templateData` (unchanged)
+- You navigate the full shop in draft mode (cookie keeps the session)
+- Exit: banner **Exit preview**, or visit `/?preview=0`
+- Stopping the CLI clears the server draft
+
+```bash
+feeef signin
+feeef use my-store
+feeef template dev
+```
+
+Going live is only via `feeef template publish --apply` (or the merchant editor).
+
+### Local Next (employees only)
+
+```bash
+feeef template dev --local
+# or: feeef config set storefrontPath /path/to/storefront && feeef template dev --local
+```
+
+Not required for public theme authors.
+
+## Publish uploads
+
+| Target | Source |
+|--------|--------|
+| `store_templates` | `dist/data.json` (i18n stripped) + schema |
+| `template_components` | `shared/` + `library/` |
+| `store_template_locales` | `dist/locales/*.json` |
+
+## License
+
+UNLICENSED — proprietary Feeef software. See [LICENSE](./LICENSE).
+
+## Develop (monorepo)
+
+```bash
+cd cli
+npm install
+npm run typecheck
+npm test
+npm run build
+npm run link:global
+```