@@ -50,22 +50,21 @@ for the markup and browser app model.
 
 ## Get your first page running
 
-Create a complete project, install its dependencies, and start the preview:
+Open PureStack Studio, the local site wizard:
 
 ```sh
-npx purestack@latest init my-site --install --yes
-cd my-site
-yarn dev
+npx purestack@latest init
 ```
 
-The `starter` template creates a small site. You can select it directly with
-`--template starter`, initialize Git with `--git`, or
-run `init` alone to configure and create a site in the local PureStack wizard.
-Studio shows progress, starts the live site, and stays open until you finish.
-Use `--yes` to create a site directly without opening Studio.
-Installation is opt-in with `--install`.
-Each project includes `README.md` and
-`AGENTS.md` to guide customization, plus build and publish scripts.
+Studio prints a link to open in your browser. Name your site, choose a template
+and its options, decide whether to install dependencies and set up Git, then
+create it. Studio shows each step, starts the live site, and stays open while
+you explore. Source edits appear on the live site automatically.
+
+Each project includes `README.md` and `AGENTS.md` to guide customization, plus
+dev, build, and publish scripts. Run `npx purestack@latest init --help` for
+options that preset Studio's choices, or that create a site without Studio in
+scripts and CI.
 
 To assemble a site manually instead, follow the steps below.
 
 
@@ -5,9 +5,9 @@ export interface StudioSetupStep {
   description: string
 }
 
-const setupStepTemplate = html`<Panel tone="accent" variant="surface" class="p-0 mb-5" bodyClass="p-4">
+const setupStepTemplate = html`<Panel tone="accent" variant="solid" class="p-0 mb-5" bodyClass="p-4">
   <Flex align="center" class="gap-3 mb-3">
-    <IconFrame name="tabler:browser" tone="accent" variant="surface"/>
+    <IconFrame name="tabler:browser" tone="accent" variant="solid"/>
     <strong>{{ heading }}</strong>
   </Flex>
   <p class="mt-0 mb-3 fs-sm">{{ description }}</p>
@@ -23,7 +23,7 @@ export function defineStudioSetupStepComponent() {
     context: () => ({
       heading: 'Configure your site in your browser',
       description:
-        'init starts a local PureStack setup website. Open the URL printed in your terminal to get started.',
+        'PureStack CLI starts a local PureStack setup website. Open the URL printed in your terminal to get started.',
     }),
   })
 }
@@ -10,51 +10,35 @@ a page needs it.
 
 ## Build your first site
 
-Create a complete project from a template:
+Open PureStack Studio, the local site wizard:
 
 ```sh
-npx purestack@latest init my-site --install --yes
-cd my-site
-yarn dev
+npx purestack@latest init
 ```
 
-The `starter` template creates a small site with a home page, about page, and
-browser TypeScript example. Run `npx purestack@latest init` to serve the wizard's
-PureStack content and print its local URL. Configure site details, choose a
-template and its settings, and create your project with animated progress.
-Use **Browse live site** to open the running project. Studio stays open, and
-source edits reload the live site. **Finish Studio** stops both local servers.
-Use `--yes` to create projects directly without opening Studio.
+Studio prints a link to open in your browser. Configure your site's details,
+choose a template and its settings, decide whether to install dependencies and
+set up Git, then create the project and follow its progress. Use
+**Browse live site** to open the running project. Studio stays open, and source
+edits reload the live site. **Finish Studio** stops both local servers.
 
-Studio defaults to `127.0.0.1` and an automatically assigned port. Use
-`init --host 127.0.0.1 --port 4700` to choose its listener. Server logging starts
-at warning level; creation progress and next steps remain visible.
-The wizard is built completely at startup and served with file watching and
-live reload disabled.
+The `starter` template creates a site with a home page, about page, and
+customization guide. Template files become your project's source, and
+`AGENTS.md` explains customization and validation. Generated starter projects
+provide `yarn dev`, `yarn build`, and `yarn publish`; the latter prepares
+`dist/publish` for deployment without uploading anything.
 
-`--install` installs dependencies with the template's package manager (Yarn for
-starter), and `--git` initializes a repository.
-Both actions are opt-in. `--yes` uses defaults for omitted answers without prompts:
+Studio listens on `127.0.0.1` with an automatically assigned port. Command-line
+options can preset its choices, for example a folder, template, and options:
 
 ```sh
-npx purestack@latest init my-site --template starter --git --yes
-npx purestack@latest init my-site --template starter --yes
+npx purestack@latest init my-site --template starter --set palette=mint
 ```
 
-You can use an explicit template release, such as `--template starter@1.1.19`,
-a full npm package name, or a local package folder or `.tgz` path. Run
-`npx purestack@latest init --help` for all options, including `--title`.
-The destination must be absent or empty. Template files become your project's
-source, and `AGENTS.md` explains customization and validation.
-
-Generated starter projects provide `yarn dev`, `yarn build`, and `yarn publish`.
-The latter prepares `dist/publish` for deployment without uploading anything.
-
-Use `--set palette=mint --set search=false` to configure template-defined options
-without opening menus. Categories, fields, choices, defaults, and configuration
-bindings come from the template's `template.ui.json`. Unspecified values use its
-declared defaults. Creation output uses colored Unicode frames and honors
-`NO_COLOR`. The browser wizard uses PureStack's existing development server.
+Templates can be official aliases, explicit releases such as `starter@1.1.20`,
+npm package names, or local folders and `.tgz` archives. Run
+`npx purestack@latest init --help` for every option, including `--yes`, which
+creates a site without Studio for scripts and CI.
 
 ### Create a site manually
 
 
@@ -11,8 +11,7 @@ import { runWizard } from './wizard/run'
 
 const help = `PureStack
 
-  purestack init                         Open Site Studio
-  purestack init <directory> --yes       Create directly with defaults
+  purestack init                         Create a site in Site Studio
   purestack serve --content <directory>  Preview with live reload
   purestack build --content <directory>  Build static files
   purestack publish --content <dir>      Prepare a local release artifact
 
@@ -23,7 +23,7 @@ export const initHelp = `Usage: purestack init [directory] [options]
 
 Start the local PureStack wizard and open the URL printed in your terminal.
 Configure your project, create it, and browse the live site in Studio.
-Studio stays open until you finish. Use --yes for direct creation.
+Studio stays open until you finish. Options below preset its choices.
 
   -t, --template <source>  Official alias, npm package, local folder, or .tgz
       --title <title>      Site title and logo brand
@@ -32,14 +32,13 @@ Studio stays open until you finish. Use --yes for direct creation.
       --port <number>      Studio port (default: automatic; 0 selects a free port)
       --install            Install dependencies with the template's package manager
       --git                Initialize or reuse a Git repository
-  -y, --yes                Create directly without opening Site Studio
+  -y, --yes                Skip Studio and create with these choices (scripts, CI)
   -h, --help               Show help
 
 Examples:
   purestack init
+  purestack init my-site --template starter --set palette=mint
   purestack init --host 127.0.0.1 --port 4700
-  purestack init my-site --template starter --yes
-  purestack init my-site --template starter --set palette=mint --install --yes
 
 Installation and Git initialization are opt-in. Relative paths use your current
 folder. In this checkout, unversioned official aliases use local templates.`
 
@@ -1,8 +1,8 @@
 # PureStack starter template
 
-Create a site with `npx purestack@latest init my-site --template starter --yes`.
-This package distributes complete project source. It is copied by the CLI and
-does not become a dependency of the generated project.
+Create a site with `npx purestack@latest init` and choose **Starter** in
+PureStack Studio. This package distributes complete project source. It is copied
+into your project and does not become a dependency of it.
 
 The starter includes a responsive home page, About page, customization guide,
 shared navigation/footer, and an interactive launch checklist. Its custom skin