docs(site): refine setup flow and sync guidance

Author: eddmann

docs-site/docs/.vitepress/config.mts

@@ -4,6 +4,7 @@ export default defineConfig({
   lang: 'en-US',
   title: 'PWAKit',
   description: 'Wrap your Progressive Web App in a native iOS shell with a typed JavaScript bridge.',
+  base: '/pwa-kit/',
   cleanUrls: true,
   lastUpdated: true,
   themeConfig: {

docs-site/docs/cli/overview.md

@@ -11,15 +11,19 @@ Recommended (no global install):
 
 ```bash
 npx @pwa-kit/cli init my-pwa-ios
-cd my-pwa-ios && npx @pwa-kit/cli sync
 ```
 
 Optional global install:
 
 ```bash
 npm install -g @pwa-kit/cli
-pwa-kit init
-pwa-kit sync
+pwa-kit init my-pwa-ios
+```
+
+Run `sync` after manual edits to `pwa-config.json`:
+
+```bash
+cd my-pwa-ios && npx @pwa-kit/cli sync
 ```
 
 ## No-clone workflow

docs-site/docs/guide/development-workflow.md

@@ -13,10 +13,11 @@ This page describes the standard workflow for shipping updates to your wrapped P
 ## Configuration change flow
 
 ```bash
-npx @pwa-kit/cli init . --force   # optional: re-run setup in current project
 npx @pwa-kit/cli sync
 ```
 
+If you re-run setup with `npx @pwa-kit/cli init . --force`, sync is already included.
+
 Then in Xcode:
 
 1. Build (`Cmd+B`).

docs-site/docs/help/faq.md

@@ -34,13 +34,18 @@ Yes. Native features are additive; your web app can still run in a standard brow
 
 Use `SecureStorageModule` (Keychain-backed) rather than embedding keys in source.
 
-## How should I run setup and sync commands?
+## How should I run setup commands?
 
 Use the CLI directly:
 
 ```bash
-mkdir my-pwa-ios
-cd my-pwa-ios
-npx @pwa-kit/cli init
-npx @pwa-kit/cli sync
+npx @pwa-kit/cli init my-pwa-ios
+```
+
+`init` already runs sync automatically.
+
+Run `sync` later only after manual edits to `pwa-config.json`:
+
+```bash
+cd my-pwa-ios && npx @pwa-kit/cli sync
 ```