superslate 0.1.0

package/LICENSE

@@ -0,0 +1,5 @@
+All rights reserved.
+
+This bootstrap package does not contain or grant access to the superslate Product Source. Use of
+the bootstrapper and any source obtained through it requires an authorized entitlement and remains
+subject to the terms supplied with the applicable order.

package/README.md

@@ -0,0 +1,62 @@
+# superslate
+
+Create a buyer-owned, production-oriented SaaS application from a licensed superslate release.
+
+```sh
+pnpm dlx superslate@latest my-saas
+```
+
+The same package works with Bun:
+
+```sh
+bunx superslate@latest my-saas
+```
+
+It can also be launched through npm with `npx superslate@latest my-saas`. The launcher does not
+change the generated toolchain: superslate always installs the canonical `pnpm-lock.yaml` with pnpm.
+This keeps local development, CI, upgrades, and support on one reproducible package-manager path.
+
+The CLI guides you through the application name, brand, dependency installation, Git initialization,
+and whether to start local development immediately. It derives the internal workspace namespace from
+the brand, generates a unique Better Auth secret locally, selects an available local Postgres port,
+and refuses to overwrite a non-empty directory. The namespace groups private monorepo packages and
+does not need to exist on npm.
+
+## Source access
+
+The npm package is a public bootstrapper; it does not contain the paid foundation source. Before
+running it:
+
+1. accept the private GitHub repository invitation included with your superslate entitlement;
+2. install [GitHub CLI](https://cli.github.com/); and
+3. authenticate once with `gh auth login`.
+
+The CLI never asks you to paste a GitHub token. Its version is bound to the matching immutable
+source tag: `superslate@1.2.3` downloads `v1.2.3`. It downloads the release archive, SHA-256 file,
+and manifest through your existing GitHub CLI session and verifies both records before extracting
+source.
+
+## Options
+
+```text
+--scope <namespace> Advanced override for the workspace namespace derived from the brand
+--brand <name>     Override the display name derived from the app name
+--no-install       Generate without installing dependencies
+--no-git           Generate without initializing Git
+--start            Start Postgres and the development servers after creation
+--no-start         Create the application without starting it
+--yes              Accept all recommended defaults
+--from <path>      Use a local source checkout for maintainer or pre-release testing
+```
+
+When automatic startup is selected, Ctrl+C stops the application development servers. The detached
+Postgres container remains available for the next run; stop it later with `docker compose down` from
+the generated directory.
+
+For reproducible automation, select an exact CLI version instead of `latest`:
+
+```sh
+pnpm dlx superslate@1.2.3 my-saas --yes --no-start
+```
+
+Product information: [superslate.dev](https://superslate.dev)