production ready

README.md

@@ -33,16 +33,56 @@ pnpm dev
 
 The local app runs at `http://localhost:5173`. Convex local deployment values live in `.env.local`.
 
+## Production App
+
+This app uses `@sveltejs/adapter-node`, so production builds create a Node server in `build/`.
+
+Set these environment variables in your production app host before building and running:
+
+```sh
+PUBLIC_CONVEX_URL=https://your-production-deployment.convex.cloud
+PUBLIC_CONVEX_SITE_URL=https://your-production-deployment.convex.site
+HOST=0.0.0.0
+PORT=3000
+```
+
+Build and validate the production app:
+
+```sh
+pnpm prod:check
+```
+
+Build only:
+
+```sh
+pnpm build
+```
+
+Run the production server:
+
+```sh
+pnpm start
+```
+
+For a single local smoke test that builds and starts the production server:
+
+```sh
+pnpm prod
+```
+
 ## Auth
 
 This project uses Convex Auth with email/password for local development. The initializer created `convex/auth.config.ts`, `convex/auth.ts`, and `convex/http.ts`; the frontend uses `@mmailaender/convex-auth-svelte` for SvelteKit auth state and auth routes.
 
-Production auth configuration is intentionally not completed yet. Configure production deployment URL, site URL, keys, and redirect behavior before deploying.
+For production Convex Auth, make sure your production Convex deployment has its auth environment configured, including `SITE_URL`, `JWT_PRIVATE_KEY`, and `JWKS`. If sign-in returns a generic Convex server error, production auth keys/site URL are the first things to verify.
 
 ## Scripts
 
 - `pnpm dev` starts SvelteKit.
 - `pnpm build` builds the app.
+- `pnpm start` runs the built Node server from `build/`.
+- `pnpm prod` builds and starts the production server locally.
+- `pnpm prod:check` runs checks, linting, and a production build.
 - `pnpm preview` previews the production build.
 - `pnpm check` runs Svelte and TypeScript checks.
 - `pnpm lint` runs Prettier checks and ESLint.