Merge pull request #1 from prazgaitis/fixes

Add private challenges with invitation-only access

Author: prazgaitis

.env.example

@@ -1,7 +1,3 @@
-# Database
-DATABASE_URL="postgresql://username:password@host:port/database"
-TEST_DATABASE_URL="postgresql://username:password@host:port/test_database" # Optional: override database used in tests
-
 # Better Auth
 BETTER_AUTH_SECRET="generate-a-long-secret"
 BETTER_AUTH_URL="http://localhost:3000"
@@ -11,14 +7,9 @@ NEXT_PUBLIC_BETTER_AUTH_URL="http://localhost:3000/api/auth"
 GOOGLE_CLIENT_ID="your-google-client-id"
 GOOGLE_CLIENT_SECRET="your-google-client-secret"
 
-# Convex (hosted)
-NEXT_PUBLIC_CONVEX_URL="https://your-project.convex.cloud"
-NEXT_PUBLIC_CONVEX_SITE_URL="https://your-project.convex.site"
-CONVEX_DEPLOY_KEY="prod:your-project|your-deploy-key" # For CI/CD deployments
-
-# Convex (local Docker - optional, for dev:local)
-# CONVEX_SELF_HOSTED_URL="http://127.0.0.1:3210"
-# CONVEX_SELF_HOSTED_ADMIN_KEY="local-dev|01e5f753250a1fe22c9ff160b4a610060943bc2cf0e75c6c4d559484660548843bded7168d8eee5b454c255adda9e1d942"
+# Convex (local Docker)
+CONVEX_SELF_HOSTED_URL="http://127.0.0.1:3210"
+CONVEX_SELF_HOSTED_ADMIN_KEY="local-dev|01e5f753250a1fe22c9ff160b4a610060943bc2cf0e75c6c4d559484660548843bded7168d8eee5b454c255adda9e1d942"
 
 # App URLs
 NEXT_PUBLIC_APP_URL="http://localhost:3000"

.gitignore

@@ -5,6 +5,7 @@ node_modules/
 # Environment variables
 .env
 .env.local
+.env.production
 .env.development.local
 .env.test.local
 .env.production.local
@@ -53,6 +54,9 @@ packages/backend/.env.local
 packages/backend/.env
 packages/backend/.env.local.self-hosted
 
+# Admin tools (local-only scripts, not open-sourced)
+admin-tools/
+
 # Misc
 coverage/
 .nyc_output/

.husky/pre-commit

@@ -0,0 +1 @@
+pnpm precommit

AGENTS.md

@@ -7,7 +7,7 @@ Instructions for AI code agents (OpenAI Codex, Claude Code, etc.) working on thi
 This is a fitness challenge platform with:
 - **Frontend**: Next.js 15 app in `apps/web/`
 - **Backend**: Convex serverless functions in `packages/backend/`
-- **Auth**: Currently Clerk, migrating to Better Auth
+- **Auth**: Better Auth via `@convex-dev/better-auth`
 
 ## Development Process
 
@@ -188,24 +188,6 @@ await t.run(async (ctx) => {
 
 convex-test is a mock - always manually test against real Convex before shipping.
 
-## Better Auth Migration
-
-### Current State
-- Toggle: `NEXT_PUBLIC_AUTH_PROVIDER` (clerk | better-auth)
-- Clerk is default, Better Auth is opt-in
-
-### Key Files
-- `apps/web/lib/auth-config.ts` - Provider detection
-- `apps/web/lib/better-auth/client.ts` - Better Auth client
-- `apps/web/components/providers/auth-provider.tsx` - Auth context
-- `apps/web/components/providers/convex-provider.tsx` - Convex + auth
-
-### Migration Tasks
-1. Implement Better Auth server endpoints in `apps/web/app/api/auth/`
-2. Add user sync from Better Auth to Convex
-3. Update Convex functions to work with Better Auth tokens
-4. Test both auth flows
-
 ## Environment Setup
 
 ```bash

CLAUDE.md

@@ -8,25 +8,25 @@ Start by adding a new markdown file in the top level /tasks directory. The file
 
 ## Development Commands
 
-**Start development server (uses hosted Convex):**
+**Start development server (defaults to self-hosted Convex):**
 ```bash
 pnpm dev
 ```
 
-**Start development server (fully local with Docker):**
+**Self-hosted Convex setup (Docker):**
 ```bash
 # First time setup (one-time GitHub auth for Docker images):
 gh auth token | docker login ghcr.io -u YOUR_USERNAME --password-stdin
 pnpm convex:start              # Start local Convex Docker containers
-pnpm convex:admin-key          # Generate admin key, copy to packages/backend/.env.local.self-hosted
+pnpm convex:admin-key          # Generate admin key, copy to root .env.local as CONVEX_SELF_HOSTED_ADMIN_KEY
 
-# Then run:
-pnpm dev:local                 # Runs Next.js + Convex against local Docker
+# Then run (or just pnpm dev):
+pnpm dev                       # Runs Next.js + Convex against local Docker
 
 # Other local Convex commands:
 pnpm convex:stop               # Stop local Convex containers
 pnpm convex:logs               # View Convex container logs
-pnpm -F backend seed:local     # Seed local Convex database
+pnpm -F backend seed           # Seed local Convex database
 ```
 
 **Local Convex endpoints:**
@@ -68,18 +68,8 @@ npx convex data <table> --prod
 
 **Testing:**
 ```bash
-# Setup local test database (first time)
-pnpm test:setup
-cd packages/database && DATABASE_URL=postgresql://test:test@localhost:5433/test_db pnpm db:push
-
-# Run tests (local)
-pnpm test:local --run
-
-# Run tests (force Neon branches)
-pnpm test:integration --run
-
-# Cleanup
-pnpm test:teardown
+# Run tests
+pnpm test -- --run
 ```
 
 **Install shadcn components (run from `apps/web`):**