@linguanahq/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Linguana contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# @linguanahq/cli
+
+Create and connect multilingual apps with Linguana. Requires Node **22.12+**; also runs on Bun. The executable is `linguana`.
+
+```sh
+npx @linguanahq/cli create app my-blog --framework solidjs --template blog --demo
+cd my-blog
+npm run dev
+```
+
+Choose from `blog` (Elsewhere), `saas` (Relay), and `storefront` (Common Goods) on React, Vue, Svelte, SolidJS, or TanStack Start. All 15 apps are standalone and include local assets, English/French/Spanish/Arabic demo catalogs, deployment configuration, and an MIT license. Demo mode makes no Linguana API requests.
+
+**Initial release availability:** local demo scaffolding is available now. The hosted API and browser authorization deployment are pending, so `login`, `--connect`, `link`, and `env pull` require a compatible self-hosted server supplied with `--api-url` until that deployment is complete. Hosted template demo links are not included yet; run the generated apps locally using the commands above.
+
+Use `--connect` instead of `--demo` for browser login and guided organization/project setup. With no mode flag, interactive creation asks you; noninteractive creation requires an explicit choice. `--yes` never opts you into account connection.
+
+```sh
+npx @linguanahq/cli login
+npx @linguanahq/cli login --no-browser
+npx @linguanahq/cli whoami
+npx @linguanahq/cli orgs list
+npx @linguanahq/cli projects list --organization ORGANIZATION_ID
+npx @linguanahq/cli link --project PROJECT_ID
+npx @linguanahq/cli env pull --environment staging
+npx @linguanahq/cli doctor
+npx @linguanahq/cli logout
+```
+
+The CLI account session stays outside projects, partitioned by API origin. Build tokens go into ignored `.env.local` or explicit staging/production environment files. The CLI preserves unrelated variables and comments, rejects tracked credential files, and asks before replacing conflicting values. Use `--overwrite-env` to authorize replacement in automation.
+
+Owner/Admin access is required to create credentials. Provisioning reuses existing APIs and defaults. It never starts paid translation or publishes production catalogs. Existing project locales stay unchanged unless `--locales` is supplied. `env pull` reuses valid local secrets; the server cannot recover previously issued token secrets.
+
+`link` detects your framework and configures linkage/environment only. Integrate the SDK in existing app code using the printed guide. It does not rewrite components or Vite configuration.
+
+Options include `--package-manager npm|pnpm|yarn|bun`, `--skip-install`, `--organization`, `--project`, `--new-organization`, `--new-project`, `--locales`, `--environment`, `--api-url`, `--yes`, and `--json`. Run each command with `--help` for its supported options.
+
+The default API is `https://linguana-api.mohammedibrahim.dev`. Overrides require HTTPS, except HTTP loopback development. Authenticated requests do not follow redirects. `LINGUANA_CONFIG_DIR` overrides account-session storage; `LINGUANA_AUTH_TOKEN` can supply an account session for controlled automation. Never include either session credentials or build tokens in browser variables, committed files, or shared logs.
+
+Exit codes: success `0`, operational failure `1`, invalid input `2`, cancellation `130`. If dependency installation fails, the generated app is retained. Interrupted connected setup can be resumed with `link`; its nonsecret recovery journal is `.linguana/setup.json`.
+
+Every generated app includes `DEPLOY.md` for Cloudflare and generic static hosting (or a Node server for TanStack Start). Hosting authentication and deployment are outside this CLI.
+
+[Full documentation](https://linguana-docs.mohammedibrahim.dev/docs/cli). New CLI and template code: MIT.