Installation

1. Clone the repository
2. Install the dependencies

1npm install

3. Set up the environment variables

1CONVEX_DEPLOYMENT=
2NEXT_PUBLIC_CONVEX_URL=
3NEXT_PUBLIC_CONVEX_SITE_URL=
4NEXT_PUBLIC_SITE_URL=http://localhost:3000
5
6UPLOADTHING_TOKEN=
7
8// for deploying
9CONVEX_DEPLOY_KEY=

4. Run Convex

1npx convex dev

Set Better Auth's deployment variables once for each Convex deployment:

1npx convex env set BETTER_AUTH_SECRET <a-random-32-byte-secret>
2npx convex env set SITE_URL http://localhost:3000
3npx convex env set GOOGLE_CLIENT_ID <google-client-id>
4npx convex env set GOOGLE_CLIENT_SECRET <google-client-secret>
5npx convex env set APPLE_CLIENT_ID com.nexfiy.web
6npx convex env set APPLE_CLIENT_SECRET <signed-apple-client-secret>

Google OAuth must allow these development callbacks:

1http://localhost:3000/api/auth/callback/google
2http://localhost:3001/api/auth/callback/google

The production callbacks are:

1https://nexfiy.com/api/auth/callback/google
2https://nexfiy.com/api/auth/callback/apple

Apple Sign in requires HTTPS and therefore works through the production domain, not localhost. The signed Apple client secret expires after at most six months; rotate it before expiry and update APPLE_CLIENT_SECRET in Convex.

Production billing uses the live Nexfiy Dodo brand and product pdt_0NkWHmeRZI6qHKsuyAW4f. Keep local development on the test product. Set the live API key and webhook secret only in the production Convex deployment, set DODO_PAYMENTS_ENVIRONMENT=live_mode, and configure both server and public product IDs to the live product. The production webhook endpoint is:

1https://nexfiy.com/api/auth/dodopayments/webhooks

5. Run the development server

1npm run dev