create-waygraph 0.0.1 → 0.0.3

package/README.md

@@ -1,7 +1,12 @@
 # create-waygraph
 
-Scaffolds a new [waygraph](https://github.com/deviate-dv8/waygraph) project - one fixed
-shape, no prompts, no template picker.
+Scaffolds a new [waygraph](https://github.com/deviate-dv8/waygraph) **offline** project -
+one fixed shape, no prompts, no template picker.
+
+This is the scaffold command linked from
+[waygraph GitHub Pages](https://deviate-dv8.github.io/waygraph/) (`npx create-waygraph`).
+Same template as `npx waygraph init` (waygraph >= 0.7.5). For a live saucedemo walkthrough
+without creating a folder in your cwd, use `npx waygraph try demo` instead.
 
 ```bash
 npx create-waygraph my-project
@@ -32,3 +37,16 @@ my-project/
 Ships as its own package rather than a `waygraph init` subcommand, so consuming `waygraph`
 at runtime never pulls in scaffolding code - `npx create-waygraph` resolves and runs without
 adding anything to your own `node_modules`.
+
+## Consumer layout (App Router projects)
+
+The minimal scaffold above is intentionally tiny (one block, no route tree). When the target
+app has real Next.js routes, **block folders mirror `app/` page routes**:
+
+- URL `/` -> nav at namespace root (`zsign-web/` or `pia-web/`), not `landing/` or `root/`
+- Route groups `(auth)` / `(app)` vanish from folder names
+- Folders with no `page.tsx` are grouping only - no NAV.md, no nav block
+- Sidebar / layout chrome -> `shared/chrome/`, not a parallel `shell/nav/*` family
+
+Full contract: `WAYGRAPH-CONSUMER-CONVENTION.md` in your mesh
+(`.sm/seats/_shared/` on zsign/pia). Engine API: package `waygraph` README + WAYGRAPH-HANDOUT.

package/bin/create-waygraph.js

@@ -27,12 +27,19 @@ fs.cpSync(templatesDir, targetDir, { recursive: true });
 fs.renameSync(path.join(targetDir, "gitignore"), path.join(targetDir, ".gitignore"));
 
 const packageJsonPath = path.join(targetDir, "package.json");
-const packageJson = fs.readFileSync(packageJsonPath, "utf8").replace("__PROJECT_NAME__", projectName);
+const packageJson = fs.readFileSync(packageJsonPath, "utf8").replaceAll("__PROJECT_NAME__", path.basename(targetDir));
 fs.writeFileSync(packageJsonPath, packageJson);
 
-console.log(`Scaffolded ${projectName}/`);
+console.log(`Scaffolded ${path.basename(targetDir)}/`);
 console.log("");
 console.log(`  cd ${projectName}`);
 console.log("  npm install");
 console.log("  npx playwright install chromium");
 console.log("  npm test");
+console.log("  npx waygraph list");
+console.log("  npx waygraph check");
+console.log("  npx waygraph auto              # headed panel");
+console.log("  npx waygraph demo src/flows/example.flow.ts");
+console.log("");
+console.log("(Same offline scaffold as: npx waygraph init <name> - waygraph >= 0.10.6.)");
+console.log("(Live saucedemo: npx waygraph try auto | try demo - temp dir, not a scaffold.)");

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "create-waygraph",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Scaffold a new waygraph project - package.json, tsconfig, playwright.config, and one working example flow.",
+  "license": "MIT",
   "type": "module",
   "bin": {
     "create-waygraph": "bin/create-waygraph.js"

package/templates/gitignore

@@ -2,3 +2,4 @@ node_modules/
 dist/
 test-results/
 playwright-report/
+.waygraph-videos/

package/templates/package.json

@@ -6,11 +6,19 @@
   "scripts": {
     "typecheck": "tsc --noEmit",
     "test": "playwright test",
-    "flows": "waygraph list .",
-    "nav": "waygraph nav ."
+    "list": "waygraph list",
+    "check": "waygraph check",
+    "auto": "waygraph auto",
+    "auto:cli": "waygraph auto --cli",
+    "demo": "waygraph demo src/flows/example.flow.ts",
+    "run": "waygraph run src/flows/example.flow.ts",
+    "graph": "waygraph graph"
+  },
+  "waygraph": {
+    "baseUrl": "https://example.com"
   },
   "dependencies": {
-    "waygraph": "^0.1.0"
+    "waygraph": "^0.10.6"
   },
   "devDependencies": {
     "@playwright/test": "^1.55.0",

package/templates/playwright.config.ts

@@ -6,9 +6,6 @@ export default defineConfig({
   reporter: "list",
   use: {
     launchOptions: {
-      // If CHROME_PATH/CHROMIUM_PATH is set (e.g. a Flatpak/system Chromium),
-      // use it instead of downloading Playwright's own bundled binary.
-      // Falls through to Playwright's default when unset - safe either way.
       executablePath: process.env.CHROME_PATH || process.env.CHROMIUM_PATH,
     },
   },