create-surf-app 0.1.1 → 0.1.3

package/dist/index.js

@@ -92,7 +92,7 @@ var templates = {
     private: true,
     scripts: {
       start: "node server.js",
-      dev: "node --watch server.js"
+      dev: "node --env-file=.env --watch server.js"
     },
     dependencies: {
       "@surf-ai/sdk": "latest",
@@ -111,6 +111,8 @@ createServer().start()
 //     name: text('name').notNull(),
 //     created_at: timestamp('created_at').defaultNow(),
 //   })
+`,
+  "backend/.env": `PORT=${backendPort}
 `,
   // ── Frontend ─────────────────────────────────────────────────────────────
   "frontend/package.json": JSON.stringify(frontendPkg, null, 2),
@@ -299,9 +301,18 @@ exports.users = pgTable('users', {
 Tables are auto-created on startup and when \`schema.js\` changes (file watcher).
 The agent can also call \`POST /api/__sync-schema\` explicitly after editing.
 
+## Dev Servers
+
+- Frontend: \`cd frontend && npm run dev\` (port from \`.env\`, do NOT pass \`--port\`)
+- Backend: \`cd backend && npm run dev\` (port from \`.env\`)
+- After \`npm install\` new packages, do NOT restart servers \u2014 Vite auto-discovers deps, backend uses \`node --watch\`
+- If a server crashes, restart with \`npm run dev\` in that directory
+- NEVER use \`npx vite\` \u2014 always use \`npm run dev\`
+
 ## Do NOT modify
 
 - \`vite.config.ts\` \u2014 proxy and build config
+- \`frontend/.env\` \u2014 port configuration (auto-generated)
 - \`backend/server.js\` \u2014 uses @surf-ai/sdk/server
 - \`entry-client.tsx\` \u2014 app bootstrap with SSR hydration
 - \`entry-server.tsx\` \u2014 SSR render for deploy
@@ -322,7 +333,7 @@ The agent can also call \`POST /api/__sync-schema\` explicitly after editing.
 var root = path.resolve(projectName);
 var name = path.basename(root);
 console.log(`
-  Creating Surf app in ${root}
+  Creating Surf app in ./${projectName === "." ? "" : name}
 `);
 fs.mkdirSync(root, { recursive: true });
 for (const [relPath, content] of Object.entries(templates)) {
@@ -348,11 +359,12 @@ function copyDir(src, dest) {
     }
   }
 }
+var cdStep = projectName === "." ? "" : `  cd ${name}
+`;
 console.log(`
 Done! Next steps:
 
-  cd ${name}
-  cd backend && npm install && cd ..
+${cdStep}  cd backend && npm install && cd ..
   cd frontend && npm install && cd ..
 
   # Start backend

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-surf-app",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Scaffold a Surf app — Vite + React + Express + @surf-ai/sdk",
   "type": "module",
   "bin": {