Configure Vercel Convex deployment

Author: kgarg2468

README.md

@@ -103,8 +103,27 @@ bun run dev
 Required frontend env vars:
 
 - `NEXT_PUBLIC_MAPBOX_TOKEN`
+- `NEXT_PUBLIC_API_URL` (use `https://bluedocs-api.onrender.com` for the hosted backend)
 - `NEXT_PUBLIC_CONVEX_URL` (from Convex dashboard / `convex dev`)
 
+## Redeploying the Frontend
+
+The old `bluedocs-ui.vercel.app` deployment cannot be repaired without access to its Vercel project. To redeploy, create a new Vercel project from this repo with `frontend` as the project root.
+
+The frontend includes `frontend/vercel.json`, which sets:
+
+```bash
+npx convex deploy --cmd-url-env-var-name NEXT_PUBLIC_CONVEX_URL --cmd 'bun run build'
+```
+
+Configure these Vercel environment variables:
+
+- `NEXT_PUBLIC_MAPBOX_TOKEN` — new Mapbox public token.
+- `NEXT_PUBLIC_API_URL` — `https://bluedocs-api.onrender.com`.
+- `CONVEX_DEPLOY_KEY` — Convex production deploy key for the new Convex deployment.
+
+Convex auth is intentionally simple: users sign up or sign in with email and password, and no email verification or external provider is required.
+
 ## Team
 
 Built by **Krish** (backend + AI) and **Partner** (frontend + UX).

frontend/.env.example

@@ -0,0 +1,6 @@
+NEXT_PUBLIC_MAPBOX_TOKEN=
+NEXT_PUBLIC_API_URL=https://bluedocs-api.onrender.com
+NEXT_PUBLIC_CONVEX_URL=
+
+# Vercel build-time only. Do not expose this to the browser.
+CONVEX_DEPLOY_KEY=

frontend/.gitignore

@@ -32,6 +32,7 @@ yarn-error.log*
 
 # env files (can opt-in for committing if needed)
 .env*
+!.env.example
 
 # vercel
 .vercel

frontend/README.md

@@ -1,36 +1,54 @@
-This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+# BlueDocs Frontend
 
-## Getting Started
+Next.js app for the BlueDocs map dashboard.
 
-First, run the development server:
+## Local Setup
 
 ```bash
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-# or
-bun dev
+bun install
+cp .env.example .env.local
 ```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+Set these values in `.env.local`:
 
-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+- `NEXT_PUBLIC_MAPBOX_TOKEN`: Mapbox public token with access to Mapbox styles.
+- `NEXT_PUBLIC_API_URL`: BlueDocs API URL. Use `https://bluedocs-api.onrender.com` for the hosted backend or `http://localhost:8000` for local backend development.
+- `NEXT_PUBLIC_CONVEX_URL`: Convex deployment URL from `bun run convex:dev` or the Convex dashboard.
 
-This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+Then run:
 
-## Learn More
+```bash
+bun run dev
+```
+
+## Simple Convex Auth
+
+Authentication intentionally stays simple:
+
+- Users create an account with email and password.
+- Sign-up immediately creates a session.
+- There is no email verification, no magic link, and no external auth provider.
+- Passwords must be at least 8 characters.
+- Saved projects are stored per signed-in Convex user.
 
-To learn more about Next.js, take a look at the following resources:
+The auth functions live in `convex/accounts.ts`, and the session/password helpers live in `convex/lib/auth.ts`.
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+## Vercel Redeploy
 
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+Create a new Vercel project from this repo and set the project root to `frontend`.
 
-## Deploy on Vercel
+Set Vercel environment variables:
+
+- `NEXT_PUBLIC_MAPBOX_TOKEN`: New Mapbox public token.
+- `NEXT_PUBLIC_API_URL`: `https://bluedocs-api.onrender.com`.
+- `CONVEX_DEPLOY_KEY`: Convex production deploy key for the new Convex deployment.
+
+The Vercel build command is configured in `vercel.json`:
+
+```bash
+npx convex deploy --cmd-url-env-var-name NEXT_PUBLIC_CONVEX_URL --cmd 'bun run build'
+```
 
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+That command deploys Convex functions first, injects `NEXT_PUBLIC_CONVEX_URL` for the frontend build, then runs the Next.js production build.
 
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+If email notifications are needed, set `RESEND_API_KEY` in the Convex deployment environment. Without it, notification sending is skipped.

frontend/bun.lock

@@ -10,6 +10,7 @@
 
 import type * as accounts from "../accounts.js";
 import type * as lib_auth from "../lib/auth.js";
+import type * as notifications from "../notifications.js";
 import type * as projects from "../projects.js";
 
 import type {
@@ -21,6 +22,7 @@ import type {
 declare const fullApi: ApiFromModules<{
   accounts: typeof accounts;
   "lib/auth": typeof lib_auth;
+  notifications: typeof notifications;
   projects: typeof projects;
 }>;
 

frontend/convex/_generated/api.d.ts

@@ -11,6 +11,7 @@
     "jsx": "react-jsx",
     "skipLibCheck": true,
     "allowSyntheticDefaultImports": true,
+    "types": ["node"],
 
     /* These compiler options are required by Convex */
     "target": "ESNext",

frontend/convex/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://openapi.vercel.sh/vercel.json",
+  "framework": "nextjs",
+  "installCommand": "bun install",
+  "buildCommand": "npx convex deploy --cmd-url-env-var-name NEXT_PUBLIC_CONVEX_URL --cmd 'bun run build'"
+}