wiki/.cursor/plans/workos_setup_9603c983.plan.md

name, overview, todos

name	overview	todos
WorkOS Setup	Complete WorkOS AuthKit integration for the dashboard by creating the Callback page, adding auth protection to Dashboard, and adding the callback route.	id content status create-callback Create src/pages/Callback.tsx with auth redirect handling completed id content status add-callback-route Add /callback route handling to src/App.tsx completed id content status update-dashboard Add WorkOS auth protection to Dashboard.tsx completed id content status test-flow Test authentication flow locally completed id content status todo-1767049823884-2nns40kqq pending

WorkOS AuthKit Setup Plan

Current Status

Step	Description	Status
Part 1-2	Create WorkOS account and configure	Done
Part 3	Install dependencies	Done
Part 4	Environment variables	Done
Part 5	Convex auth config	Done
Part 6	Update main.tsx	Done
Part 7	Create Callback route	Missing
Part 8	Protected Dashboard	Needs auth wrapper
Part 9	Add routes to App.tsx	Missing /callback
Part 10	Test	Pending

---

Tasks

1. Create Callback.tsx (Part 7)

Create src/pages/Callback.tsx that handles OAuth callback and redirects to dashboard.

2. Add /callback route to App.tsx (Part 9)

Add callback route handling similar to how dashboard is handled.

3. Update Dashboard.tsx (Part 8)

Wrap existing dashboard with auth guards using Authenticated, Unauthenticated, and AuthLoading from convex/react.

4. Test (Part 10)

Test the full authentication flow locally.

---

Files

File	Action
src/pages/Callback.tsx	Create
src/App.tsx	Add /callback route
src/pages/Dashboard.tsx	Add auth wrapper