@sansavision/create-pulse 0.4.2 → 0.4.4

package/README.md

@@ -27,7 +27,7 @@ npx @sansavision/create-pulse my-pulse-app
 When you run `create-pulse`, you'll be prompted to select a template. 
 
 ### 1. Next.js + Auth (Full Demo) ⭐
-An **investor-ready** demo application showcasing the full capabilities of Pulse.
+A **full-featured** demo application showcasing the full capabilities of Pulse.
 - **Better Auth** with email/password, local SQLite + Drizzle ORM
 - **Webhook auth** — Pulse relay verifies tokens via your Next.js API
 - 5 comprehensive demos: Real-time Chat, Watch Together, Durable Queues (with offline simulation), Game State Sync, E2E Encrypted Chat

package/dist/index.js

@@ -51,7 +51,7 @@ async function main() {
         return p.select({
           message: "Pick a template:",
           options: [
-            { value: "nextjs-auth-demo", label: "Next.js + Auth (Full Demo)", hint: "Better Auth, all features, investor-ready" },
+            { value: "nextjs-auth-demo", label: "Next.js + Auth (Full Demo)", hint: "Better Auth, video calls, all features" },
             { value: "react-watch-together", label: "Watch Together (React + TS)", hint: "Synchronized video playback" },
             { value: "react-all-features", label: "All Features (React + TS)", hint: "Chat, Video, Audio, RPC" },
             { value: "react-queue-demo", label: "Durable Queues (React + TS)", hint: "Persistent queues with WAL/Postgres/Redis" },

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@sansavision/create-pulse",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Scaffold a new Pulse application",
   "main": "dist/index.js",
   "bin": {
     "create-pulse": "dist/index.js"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format cjs --dts",
+    "build": "tsup src/index.ts --format cjs",
     "dev": "tsup src/index.ts --format cjs --watch"
   },
   "keywords": [

package/templates/nextjs-auth-demo/README.md

@@ -1,6 +1,6 @@
 # Pulse + Next.js Auth Demo
 
-An **investor-ready** demo application showcasing the full capabilities of [Pulse](https://github.com/Sansa-Organisation/pulse) — the real-time protocol for modern applications.
+A **full-featured** demo application showcasing the full capabilities of [Pulse](https://github.com/Sansa-Organisation/pulse) — the real-time protocol for modern applications.
 
 ## Features
 
@@ -13,26 +13,58 @@ An **investor-ready** demo application showcasing the full capabilities of [Puls
 
 ## Quick Start
 
+### 1. Install dependencies
+
 ```bash
-# 1. Install dependencies
 npm install
+```
 
-# 2. Create .env file
+### 2. Configure environment
+
+```bash
 cp .env.example .env
+```
+
+Edit `.env` and set your secret (generate one with `openssl rand -base64 32`):
+
+```env
+BETTER_AUTH_SECRET=your-generated-secret-here
+BETTER_AUTH_URL=http://localhost:3000
+NEXT_PUBLIC_PULSE_URL=ws://localhost:4001
+```
 
-# 3. Generate a secret and update .env
-openssl rand -base64 32
+> **Note:** `BETTER_AUTH_URL` must match the port your app runs on. If you use `--port 3444`, set it to `http://localhost:3444`.
 
-# 4. Create database tables
-npx @auth/cli migrate
+### 3. Create database tables
 
-# 5. Start the Pulse relay (in another terminal)
-npx @sansavision/pulse-cli serve --auth-mode webhook --auth-webhook http://localhost:3000/api/pulse/verify
+The auth schema is pre-generated in `src/lib/schema.ts`. Push it to SQLite:
 
-# 6. Start the app
+```bash
+npm run db:push
+```
+
+> This creates the `user`, `session`, `account`, and `verification` tables in `./sqlite.db`.
+
+### 4. Start the Pulse relay
+
+In a separate terminal, start the relay with webhook auth:
+
+```bash
+npx @sansavision/pulse-cli serve \
+  --auth-mode webhook \
+  --auth-webhook http://localhost:3000/api/pulse/verify
+```
+
+> If your app runs on a different port, update the `--auth-webhook` URL accordingly.
+
+### 5. Start the app
+
+```bash
 npm run dev
 ```
 
+Open [http://localhost:3000](http://localhost:3000) in your browser.
+
 ## Multi-User Testing
 
 1. Open `http://localhost:3000` in a browser
@@ -70,5 +102,24 @@ Next.js App (port 3000)              Pulse Relay (port 4001)
 | Variable | Description | Default |
 |----------|-------------|---------|
 | `BETTER_AUTH_SECRET` | Auth encryption secret (32+ chars) | — |
-| `BETTER_AUTH_URL` | Base URL of the app | `http://localhost:3000` |
+| `BETTER_AUTH_URL` | Base URL of the app (must match your port) | `http://localhost:3000` |
 | `NEXT_PUBLIC_PULSE_URL` | Pulse relay WebSocket URL | `ws://localhost:4001` |
+
+## Troubleshooting
+
+### "Invalid origin" error on signup
+
+Your `BETTER_AUTH_URL` doesn't match the port the app is running on. For example, if you start the app with `--port 3444`, set `BETTER_AUTH_URL=http://localhost:3444` in `.env`.
+
+### "Connecting to Pulse relay..." stays loading
+
+Make sure the Pulse relay is running in a separate terminal with `--auth-mode webhook`. Without auth flags, the relay won't accept authenticated connections.
+
+### Database errors
+
+If you see table-related errors, re-run the schema push:
+
+```bash
+rm -f sqlite.db
+npm run db:push
+```

package/templates/nextjs-auth-demo/package.json

@@ -7,6 +7,8 @@
     "build": "next build",
     "start": "next start",
     "db:push": "npx drizzle-kit push",
+    "db:generate": "npx drizzle-kit generate",
+    "db:migrate": "npx drizzle-kit migrate",
     "db:studio": "npx drizzle-kit studio"
   },
   "dependencies": {