create-varity-app 2.0.0-beta.5 → 2.0.0-beta.7

package/README.md

@@ -23,12 +23,12 @@ yarn create varity-app my-app
 ## What You Get
 
 - **Next.js 15** app with TypeScript and Tailwind CSS
-- **Authentication** — email, social login, and more (zero config)
-- **Database** — ready-to-use collections with typed queries
-- **Dashboard** — professional layout with sidebar navigation
-- **Landing page** — hero, features, pricing, testimonials
-- **Settings** — profile, preferences, security, billing sections
-- **6 pages** — dashboard, projects, tasks, team, settings, login
+- **Authentication** -- email, social login, and more (zero config)
+- **Database** -- ready-to-use collections with typed queries
+- **Dashboard** -- professional layout with sidebar navigation
+- **Landing page** -- hero, features, pricing, how it works, testimonials, CTA
+- **Settings** -- General, Security, Billing, and Account tabs
+- **8 pages** -- landing, login, dashboard, projects, tasks, team, settings, 404
 
 ## Project Structure
 
@@ -36,15 +36,16 @@ yarn create varity-app my-app
 my-app/
 ├── src/
 │   └── app/
-│       ├── (auth)/login/     # Login page
-│       ├── (dashboard)/      # Protected dashboard pages
-│       │   ├── dashboard/    # Overview with KPIs
+│       ├── login/            # Login page
+│       ├── dashboard/        # Protected dashboard pages
+│       │   ├── page.tsx      # Overview with KPIs
 │       │   ├── projects/     # Project management
 │       │   ├── tasks/        # Task tracking
 │       │   ├── team/         # Team members
-│       │   └── settings/     # App settings (6 sections)
+│       │   └── settings/     # App settings (4 tabs)
+│       ├── not-found.tsx     # 404 page
 │       └── page.tsx          # Landing page
-├── tailwind.config.ts
+├── tailwind.config.js
 ├── next.config.js
 └── package.json
 ```
@@ -60,26 +61,26 @@ varitykit app deploy
 
 Your app will be live in under 60 seconds.
 
-Or deploy from your AI editor with the [Varity MCP server](../../cli/varity-mcp/) (`@varity-labs/mcp`) — just ask "deploy this project".
+Or deploy from your AI editor with the [Varity MCP server](https://www.npmjs.com/package/@varity-labs/mcp) -- just ask "deploy this project".
 
 ## Related Packages
 
-- **[@varity-labs/sdk](../../core/varity-sdk/)** — Core SDK (database, credentials)
-- **[@varity-labs/ui-kit](../../ui/varity-ui-kit/)** — React UI components
-- **[@varity-labs/mcp](../../cli/varity-mcp/)** — MCP server for AI editors (Cursor, Claude Code, VS Code)
+- **[@varity-labs/sdk](https://www.npmjs.com/package/@varity-labs/sdk)** -- Core SDK (database, credentials)
+- **[@varity-labs/ui-kit](https://www.npmjs.com/package/@varity-labs/ui-kit)** -- React UI components
+- **[@varity-labs/mcp](https://www.npmjs.com/package/@varity-labs/mcp)** -- MCP server for AI editors (Cursor, Claude Code, VS Code)
 
 ## Learn More
 
 - [Documentation](https://docs.varity.so)
 - [GitHub](https://github.com/varity-labs/varity-sdk)
-- [Discord](https://discord.gg/varity)
+- [Discord](https://discord.gg/7vWsdwa2Bg)
 
 ---
 
-**Part of the [Varity SDK](https://github.com/varity-labs/varity-sdk)** — Build, deploy, and monetize apps 70% cheaper than AWS.
+**Part of the [Varity SDK](https://github.com/varity-labs/varity-sdk)** -- Build, deploy, and monetize apps 70% cheaper than AWS.
 
-[Documentation](https://docs.varity.so) · [GitHub](https://github.com/varity-labs/varity-sdk) · [Discord](https://discord.gg/varity)
+[Documentation](https://docs.varity.so) | [GitHub](https://github.com/varity-labs/varity-sdk) | [Discord](https://discord.gg/7vWsdwa2Bg)
 
 ## License
 
-MIT — [Varity Labs](https://varity.so)
+MIT -- [Varity Labs](https://www.varity.so)

package/dist/create.js

@@ -7,11 +7,10 @@ import ora from "ora";
 import { getInstallCommand } from "./utils.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-const VARITY_PACKAGE_VERSION = "^2.0.0-beta.2";
 const WORKSPACE_DEPS = {
-    "@varity-labs/sdk": "^2.0.0-beta.2",
-    "@varity-labs/types": "^2.0.0-beta.2",
-    "@varity-labs/ui-kit": "^2.0.0-beta.5",
+    "@varity-labs/sdk": "2.0.0-beta.4",
+    "@varity-labs/types": "2.0.0-beta.4",
+    "@varity-labs/ui-kit": "2.0.0-beta.7",
 };
 const EXCLUDED_FILES = new Set([
     ".env.local",
@@ -33,7 +32,7 @@ function rewritePackageJson(content, projectName) {
         for (const [name, version] of Object.entries(deps)) {
             if (typeof version === "string" &&
                 version.startsWith("workspace:")) {
-                deps[name] = WORKSPACE_DEPS[name] || VARITY_PACKAGE_VERSION;
+                deps[name] = WORKSPACE_DEPS[name] || "2.0.0-beta.4";
             }
         }
     }
@@ -136,6 +135,6 @@ export async function createApp(projectName, packageManager) {
     console.log(chalk.cyan("    varitykit app deploy"));
     console.log();
     console.log(`  Docs:  ${chalk.underline("https://docs.varity.so")}`);
-    console.log(`  Help:  ${chalk.underline("https://discord.gg/varity")}`);
+    console.log(`  Help:  ${chalk.underline("https://discord.gg/7vWsdwa2Bg")}`);
     console.log();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-varity-app",
-  "version": "2.0.0-beta.5",
+  "version": "2.0.0-beta.7",
   "description": "Create production-ready apps with auth, database, and payments built in",
   "license": "MIT",
   "repository": {
@@ -38,11 +38,6 @@
     "LICENSE"
   ],
   "type": "module",
-  "scripts": {
-    "prebuild": "node scripts/copy-template.mjs",
-    "build": "tsc",
-    "clean": "rm -rf dist template"
-  },
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
@@ -57,5 +52,10 @@
     "@types/prompts": "^2.4.9",
     "@types/validate-npm-package-name": "^4.0.2",
     "typescript": "^5.5.0"
+  },
+  "scripts": {
+    "prebuild": "node scripts/copy-template.mjs",
+    "build": "tsc",
+    "clean": "rm -rf dist template"
   }
-}
+}

package/template/.env.example

@@ -6,9 +6,9 @@
 # For production: `varitykit app deploy` injects all credentials automatically.
 # You never need to manually set these values.
 
-# Auth configuration (managed by Varity)
-# Leave blank for dev mode, auto-configured on deploy
-NEXT_PUBLIC_VARITY_AUTH_ID=
+# Auth (optional — dev credentials used automatically when blank)
+NEXT_PUBLIC_PRIVY_APP_ID=
+NEXT_PUBLIC_THIRDWEB_CLIENT_ID=
 
 # Database (optional — dev database used automatically when blank)
 NEXT_PUBLIC_VARITY_APP_TOKEN=

package/template/.turbo/turbo-build.log

@@ -1,49 +1,6 @@
 
-> my-saas-app@0.1.0 build /home/macoding/varity-workspace/varity-sdk-impl/templates/saas-starter
+> my-saas-app@0.1.0 build /home/macoding/varity-workspace/varity-sdk-private/templates/saas-starter
 > next build
 
- ⚠ Warning: Next.js inferred your workspace root, but it may not be correct.
- We detected multiple lockfiles and selected the directory of /home/macoding/varity-workspace/package-lock.json as the root directory.
- To silence this warning, set `outputFileTracingRoot` in your Next.js config, or consider removing one of the lockfiles if it's not needed.
-   See https://nextjs.org/docs/app/api-reference/config/next-config-js/output#caveats for more information.
- Detected additional lockfiles: 
-   * /home/macoding/varity-workspace/varity-sdk-impl/pnpm-lock.yaml
-
    ▲ Next.js 15.5.11
 
-   Creating an optimized production build ...
- ⚠ Mismatching @next/swc version, detected: 15.5.7 while Next.js is on 15.5.11. Please ensure these match
- ✓ Compiled successfully in 36.9s
-   Linting and checking validity of types ...
-   Collecting page data ...
-   Generating static pages (0/11) ...
-[Varity Database] Using shared development database. Data is stored in an isolated dev schema.
-Deploy with `varitykit app deploy` to get your own private database.
-   Generating static pages (2/11) 
-   Generating static pages (5/11) 
-   Generating static pages (8/11) 
- ✓ Generating static pages (11/11)
-   Finalizing page optimization ...
-   Collecting build traces ...
-   Exporting (0/2) ...
- ✓ Exporting (2/2)
-
-Route (app)                                 Size  First Load JS
-┌ ○ /                                    5.69 kB         125 kB
-├ ○ /_not-found                            132 B         116 kB
-├ ○ /dashboard                           3.75 kB        1.37 MB
-├ ○ /dashboard/projects                  4.95 kB        1.37 MB
-├ ○ /dashboard/settings                  5.88 kB        1.37 MB
-├ ○ /dashboard/tasks                     3.17 kB        1.37 MB
-├ ○ /dashboard/team                      3.06 kB        1.37 MB
-├ ○ /icon.svg                                0 B            0 B
-└ ○ /login                               1.32 kB        1.37 MB
-+ First Load JS shared by all             116 kB
-  ├ chunks/79135-4ac590d187e38d6f.js     45.3 kB
-  ├ chunks/f0439f7a-76e885cef8778491.js  54.3 kB
-  ├ chunks/webpack-8c7850c3c7158c7b.js   16.1 kB
-  └ other shared chunks (total)            241 B
-
-
-○  (Static)  prerendered as static content
-

package/template/KNOWN_ISSUES.md

@@ -1,6 +1,6 @@
-# Known Issues -- SaaS Starter Template
+# Known Issues — SaaS Starter Template
 
-> **Last Updated:** March 4, 2026
+> **Last Updated:** March 8, 2026
 > **Template:** `saas-starter` (TaskFlow)
 > **Status:** All features functional, builds with 0 errors (8 routes + _not-found)
 
@@ -10,60 +10,50 @@
 
 | Feature | Status | Notes |
 |---------|--------|-------|
-| Landing Page | Working | 6 sections, scroll animations, social proof, testimonials, dashboard mockup |
-| Login | Working | Email/Google auth, zero-config with dev credentials, auto-redirect |
-| Dashboard | Working | KPI cards, getting started checklist, recent activity feed |
-| Projects CRUD | Working | Master-detail, nested tasks, CSV export, validation, optimistic updates |
-| Tasks CRUD | Working | Status cycling (click to advance), filtering, CSV export, cross-references projects |
-| Team CRUD | Working | Invite members, role management, email validation, role badges |
-| Settings | Working | 4 tabs (General, Security, Billing, Account), backend persistence, skeleton loading |
-| Command Palette | Working | Cmd+K / Ctrl+K, searches pages and actions |
-| Toast Notifications | Working | Success/error/info with progress bar, exit animation, max 3 stack |
-| Protected Routes | Working | Automatic redirect for unauthenticated users |
-| Color Themes | Working | 4 built-in presets (Blue, Purple, Green, Orange) via CSS variables |
-| Static Export | Working | `output: 'export'` for static hosting deployment |
-| Mobile Nav | Working | Hamburger menu with responsive sidebar |
-| CSV Export | Working | One-click export for tasks and projects |
-| SEO | Working | OpenGraph, Twitter cards, robots.txt, sitemap template |
+| Landing Page | Working | 6 sections, scroll animations, social proof |
+| Auth (Login) | Working | Email/Google via Privy, zero-config dev credentials |
+| Dashboard | Working | KPI cards, checklist, activity feed |
+| Projects/Tasks/Team CRUD | Working | Full create, read, update, delete with validation |
+| Settings | Working | 4 tabs with backend persistence via DB Proxy |
+| Command Palette | Working | Cmd+K / Ctrl+K |
+| Color Themes | Working | 4 presets (Blue, Purple, Green, Orange) |
+| Static Export | Working | `output: 'export'` for IPFS deployment |
+| Mobile Nav | Working | Responsive sidebar with hamburger menu |
 
 ## Known Issues
 
-### 1. Navigation Flash (UI-Kit Limitation)
-Brief "Initializing Dashboard" screen when navigating between dashboard pages. Caused by the auth guard in UI-Kit re-checking auth state on each route change. Resolves in <1 second. This is a UI-Kit issue, not template-side.
+### 1. Auth Uses Privy Directly (Abstraction Coming Post-Beta)
+The template uses `usePrivy()` and `NEXT_PUBLIC_PRIVY_APP_ID`. The planned `useAuth()` hook and `NEXT_PUBLIC_VARITY_AUTH_ID` env var are post-beta tasks. No action required -- current auth works correctly.
 
-### 2. DashboardLayout Mobile Support
-The `DashboardLayout` from `@varity-labs/ui-kit` does not include mobile navigation. The template provides its own responsive sidebar in `src/app/dashboard/layout.tsx` as a workaround. UI-Kit mobile improvements are planned.
+### 2. Payments Section is Placeholder
+Settings > Billing shows mock UI. Credit card payment integration (on/off ramp) is coming soon. Wire your own billing provider (Stripe, etc.) if needed now.
 
-### 3. Billing Section is Mock
-The Settings > Billing tab shows a mock UI (plan name, usage bars, payment method). Developers should wire their own billing provider (Stripe, etc.).
+### 3. No Server-Side Rendering
+All pages are statically exported. No SSR, API routes, or middleware. Do not use dynamic routes (`[id]` patterns) -- use client-side state for detail views instead.
 
-### 4. Sessions Are Mock
-The Settings > Security tab shows active sessions with a "Revoke" button. Session data is client-side mock -- real session management is handled by the auth provider.
+### 4. Navigation Flash
+Brief "Initializing Dashboard" screen when navigating between pages. Caused by `PrivyReadyGate` re-checking auth state. Resolves in under 1 second.
 
-### 5. Password & Profile Managed by Auth Provider
-"Change password" and profile photo are managed by the authentication provider. The Settings page shows informational dialogs explaining this.
+### 5. Team Email Invites Are Local Only
+No SMTP integration. Team members are added to the database but no invitation email is sent. Integrate your own email service if needed.
 
-### 6. No Server-Side Rendering
-All pages are statically exported (`output: 'export'`). No server-side rendering, API routes, or middleware. Data fetching happens client-side via the SDK.
-
-### 7. Team Email Invites
-No SMTP integration -- team members are added to the database only. No invitation email is sent. Developers should integrate their own email service.
+### 6. Sessions and Password Are Auth-Provider Managed
+Settings > Security shows mock session data. Password changes and profile photos are managed by the auth provider (Privy), not the template.
 
 ## Environment
 
 ### Development (Zero Config)
 ```bash
-npm install
-npm run dev
+npm install && npm run dev
 ```
-No `.env` file, API keys, or accounts needed. Shared development credentials are built in.
+No `.env` file, API keys, or accounts needed.
 
 ### Production
 ```bash
 varitykit app deploy
 ```
-The CLI provisions a private database, injects production credentials, and deploys automatically.
 
 ## Reporting Issues
 
-Please report issues at: https://github.com/varity-labs/varity-sdk/issues
+- GitHub: https://github.com/varity-labs/varity-sdk/issues
+- Discord: https://discord.gg/7vWsdwa2Bg

package/template/README.md

@@ -1,8 +1,8 @@
-# TaskFlow -- SaaS Starter Template
+# TaskFlow — SaaS Starter Template
 
-[![Built with Varity](https://img.shields.io/badge/built%20with-Varity-7C3AED)](https://varity.so)
+[![Built with Varity](https://img.shields.io/badge/built%20with-Varity-7C3AED)](https://www.varity.so)
 
-A full-featured project management app built with [Varity](https://varity.so). Everything works immediately -- no configuration, no API keys, no setup.
+A full-featured project management app built with [Varity](https://www.varity.so). Everything works immediately — no configuration, no API keys, no setup.
 
 ## Quick Start
 
@@ -23,12 +23,12 @@ No `.env` file needed. No accounts to create. No credentials to configure.
 
 Transform this into your own branded SaaS app:
 
-1. **App name** -- Edit `APP_NAME` in `src/lib/constants.ts`
-2. **Logo** -- Replace `public/logo.svg` with your logo
-3. **Colors** -- Open `src/app/globals.css` and uncomment a color preset (Purple, Green, or Orange) or set your own
-4. **Meta title** -- Update the `title` and `description` in `src/app/layout.tsx`
-5. **Navigation** -- Edit `NAVIGATION_ITEMS` in `src/lib/constants.ts` to rename or add sidebar links
-6. **Landing page** -- Edit the sections in `src/components/landing/` (Hero, Features, Pricing, etc.)
+1. **App name** — Edit `APP_NAME` in `src/lib/constants.ts`
+2. **Logo** — Replace `public/logo.svg` with your logo
+3. **Colors** — Open `src/app/globals.css` and uncomment a color preset (Purple, Green, or Orange) or set your own
+4. **Meta title** — Update the `title` and `description` in `src/app/layout.tsx`
+5. **Navigation** — Edit `NAVIGATION_ITEMS` in `src/lib/constants.ts` to rename or add sidebar links
+6. **Landing page** — Edit the sections in `src/components/landing/` (Hero, Features, Pricing, etc.)
 
 ## Built-in Color Themes
 
@@ -44,53 +44,71 @@ Switch your entire app's color scheme by editing `src/app/globals.css`:
 
 ## What's Included
 
-- **Zero-Config Auth** -- Email and social login works out of the box
-- **Zero-Config Database** -- Data persistence with isolated dev environment
-- **Dashboard** -- KPI cards, data tables, status badges, getting started guide
-- **Full CRUD** -- Create, read, update, delete for projects, tasks, and team members
-- **Command Palette** -- Cmd+K search across all data
-- **Protected Routes** -- Automatic redirect for unauthenticated users
-- **Landing Page** -- Professional marketing page with hero, features, pricing, testimonials
-- **Mobile Responsive** -- Hamburger menu, responsive layouts, touch-friendly
-- **TypeScript** -- Full type safety throughout
-- **Tailwind CSS** -- Utility-first styling with CSS variable theming
+- **Zero-Config Auth** — Email and social login works out of the box
+- **Zero-Config Database** — Data persistence with isolated dev environment
+- **Dashboard** — KPI cards, data tables, status badges, getting started guide
+- **Full CRUD** — Create, read, update, delete for projects, tasks, and team members
+- **Command Palette** — Cmd+K search across all data
+- **Protected Routes** — Automatic redirect for unauthenticated users
+- **Landing Page** — Professional marketing page with hero, features, pricing, testimonials
+- **Mobile Responsive** — Hamburger menu, responsive layouts, touch-friendly
+- **TypeScript** — Full type safety throughout
+- **Tailwind CSS** — Utility-first styling with CSS variable theming
 
-## Zero Configuration Required
+## ✅ Zero Configuration Required
 
 This template works immediately with **zero setup**:
 
 ### Instant Auth
-- Email login (email + Google)
-- Social login support
-- Dev credentials built-in
-- No env vars needed
+- ✅ Email login (built-in)
+- ✅ Google/Apple social login
+- ✅ Dev credentials built-in
+- ❌ No env vars needed
 
 ### Instant Database
-- Create, read, update, delete data
-- Dev token built-in
-- Production-ready
-- No credentials needed
+- ✅ Create, read, update, delete data
+- ✅ Dev token built-in
+- ✅ Production-ready proxy
+- ❌ No credentials needed
 
 ### Instant Deploy
 ```bash
-varitykit app deploy
+npm run deploy
 ```
-- Deploys to production
-- Auto-configures credentials
-- No accounts needed
+- ✅ Deploys to production
+- ✅ Auto-fetches credentials
+- ❌ No extra accounts needed
 
 ---
 
+## 🏗️ Architecture
+
+### Workspace Dependencies
+This template uses `workspace:^` protocol for Varity packages:
+```json
+{
+  "dependencies": {
+    "@varity-labs/sdk": "workspace:^",
+    "@varity-labs/ui-kit": "workspace:^",
+    "@varity-labs/types": "workspace:^"
+  }
+}
+```
+
+**Why?** Ensures you always use the latest local package versions during development.
+
+**Publishing:** When published to npm, `workspace:^` converts to `^2.0.0-alpha.1` automatically.
+
 ### Static Export Ready
-- `output: 'export'` in next.config.js
-- All pages pre-rendered to static HTML
-- No server-side dependencies
-- CDN deployable
+- ✅ `output: 'export'` in next.config.js
+- ✅ All pages pre-rendered to static HTML
+- ✅ No server-side dependencies
+- ✅ CDN deployable
 
 ### Type Safety
-- TypeScript strict mode enabled
-- All errors surface during build
-- No `ignoreBuildErrors` flag
+- ✅ TypeScript strict mode enabled
+- ✅ All errors surface during build
+- ✅ No `ignoreBuildErrors` flag
 
 ## Project Structure
 
@@ -187,17 +205,17 @@ export function useInvoices(): UseCollectionReturn<Invoice> {
 const { data, loading, create, update, remove } = useInvoices();
 ```
 
-The database collection is created automatically on first use -- no migrations needed.
+The database collection is created automatically on first use — no migrations needed.
 
 ## Environment Variables
 
 **For development:** Leave everything blank. Shared development credentials are used automatically.
 
-**For production:** Run `varitykit app deploy` -- it injects all credentials into your build automatically. You never need to manually set API keys.
+**For production:** Run `varitykit app deploy` — it injects all credentials into your build automatically. You never need to manually set API keys.
 
 | Variable | Required | Notes |
 |----------|----------|-------|
-| `NEXT_PUBLIC_PRIVY_APP_ID` | No | Auth provider (auto-configured) |
+| `NEXT_PUBLIC_VARITY_AUTH_ID` | No | Auth provider (auto-configured) |
 | `NEXT_PUBLIC_VARITY_APP_TOKEN` | No | Database token (auto-configured) |
 | `NEXT_PUBLIC_VARITY_APP_ID` | No | App ID (auto-configured) |
 
@@ -211,7 +229,7 @@ varitykit app deploy
 varitykit app deploy --submit-to-store
 ```
 
-The CLI builds your app, provisions a private database, injects production credentials, and deploys -- all in one command.
+The CLI builds your app, provisions a private database, injects production credentials, and deploys — all in one command.
 
 **Deploy from your AI editor:** Set up the [Varity MCP server](https://docs.varity.so/mcp) (`npx @varity-labs/mcp`) and ask your AI to "deploy this project".
 

package/template/next.config.js

@@ -5,7 +5,7 @@ const nextConfig = {
   trailingSlash: true,
   productionBrowserSourceMaps: false,
   webpack: (config, { isServer, dev }) => {
-    // Suppress async-storage warning from auth provider dependencies
+    // Suppress MetaMask SDK warning for @react-native-async-storage
     config.resolve.fallback = {
       ...config.resolve.fallback,
       '@react-native-async-storage/async-storage': false,

package/template/package.json

@@ -17,9 +17,9 @@
     "deploy": "varitykit app deploy"
   },
   "dependencies": {
-    "@varity-labs/sdk": "^2.0.0-beta.2",
-    "@varity-labs/types": "^2.0.0-beta.2",
-    "@varity-labs/ui-kit": "^2.0.0-beta.5",
+    "@varity-labs/sdk": "workspace:^",
+    "@varity-labs/types": "workspace:^",
+    "@varity-labs/ui-kit": "workspace:^",
     "lucide-react": "^0.400.0",
     "next": "^15.0.0",
     "react": "^18.3.0",

package/template/src/app/dashboard/layout.tsx

@@ -7,20 +7,18 @@ import { useProjects, useTasks, useTeam } from '@/lib/hooks';
 import { CommandPalette } from '@varity-labs/ui-kit';
 import { Menu, X } from 'lucide-react';
 
-// Conditionally import UI-Kit components
+// Conditionally import Privy/UI-Kit components
 let DashboardLayout: any = null;
-let ProtectedRoute: any = null;
-let AuthStackComponent: any = null;
-let ZeroDevProviderComponent: any = null;
-let useAuthHook: any = null;
+let PrivyProtectedRoute: any = null;
+let PrivyStackComponent: any = null;
+let usePrivyHook: any = null;
 
 try {
   const uiKit = require('@varity-labs/ui-kit');
   DashboardLayout = uiKit.DashboardLayout;
-  ProtectedRoute = uiKit.ProtectedRoute;
-  AuthStackComponent = uiKit.AuthStack;
-  ZeroDevProviderComponent = uiKit.ZeroDevProvider;
-  useAuthHook = uiKit.useAuth;
+  PrivyProtectedRoute = uiKit.PrivyProtectedRoute;
+  PrivyStackComponent = uiKit.PrivyStack;
+  usePrivyHook = uiKit.usePrivy;
 } catch {}
 
 function RedirectToLogin() {
@@ -113,8 +111,8 @@ function MobileNav({
 
 function DashboardShell({ children }: { children: React.ReactNode }) {
   // eslint-disable-next-line react-hooks/rules-of-hooks -- conditional on require() success, stable across renders
-  const auth = useAuthHook ? useAuthHook() : { user: null, logout: async () => {} };
-  const { user, logout } = auth;
+  const privy = usePrivyHook ? usePrivyHook() : { user: null, logout: async () => {} };
+  const { user, logout } = privy;
   const pathname = usePathname();
   const router = useRouter();
   const isMobile = useIsMobile();
@@ -154,7 +152,7 @@ function DashboardShell({ children }: { children: React.ReactNode }) {
   const userName = user?.email?.address?.split('@')[0] || 'User';
   const userEmail = user?.email?.address || '';
 
-  const handleSignOut = async () => {
+  const handleLogout = async () => {
     await logout();
     router.push('/');
   };
@@ -196,7 +194,7 @@ function DashboardShell({ children }: { children: React.ReactNode }) {
               </nav>
               <div className="mt-8 px-3 border-t border-gray-200 pt-4">
                 <button
-                  onClick={handleSignOut}
+                  onClick={handleLogout}
                   className="flex w-full items-center gap-3 rounded-lg px-3 py-2.5 text-sm font-medium text-red-600 hover:bg-red-50 transition-colors"
                 >
                   Sign Out
@@ -212,7 +210,7 @@ function DashboardShell({ children }: { children: React.ReactNode }) {
               onClose={() => setMobileMenuOpen(false)}
               navItems={navWithActive}
               userEmail={userEmail}
-              onLogout={handleSignOut}
+              onLogout={handleLogout}
               onNavigate={(path) => router.push(path)}
             />
           )}
@@ -243,7 +241,7 @@ function DashboardShell({ children }: { children: React.ReactNode }) {
           onClose={() => setMobileMenuOpen(false)}
           navItems={navWithActive}
           userEmail={userEmail}
-          onLogout={handleSignOut}
+          onLogout={handleLogout}
           onNavigate={(path) => router.push(path)}
         />
       )}
@@ -259,7 +257,7 @@ function DashboardShell({ children }: { children: React.ReactNode }) {
             name: userName,
             address: userEmail,
           }}
-          onLogout={handleSignOut}
+          onLogout={handleLogout}
           onNavigateToProfile={() => router.push('/dashboard/settings')}
           onNavigateToSettings={() => router.push('/dashboard/settings')}
           onSearchClick={() => setCommandPaletteOpen(true)}
@@ -279,23 +277,22 @@ export default function DashboardRootLayout({
 }: {
   children: React.ReactNode;
 }) {
-  // Auth provider (managed by Varity)
-  if (!ProtectedRoute || !AuthStackComponent || !ZeroDevProviderComponent) {
+  // Always wrap in PrivyStack + PrivyProtectedRoute - uses dev credentials automatically when env vars are empty
+  if (!PrivyProtectedRoute || !PrivyStackComponent) {
     // Fallback if ui-kit package isn't installed
     return <DashboardShell>{children}</DashboardShell>;
   }
 
   return (
-    <AuthStackComponent
-      appId={process.env.NEXT_PUBLIC_VARITY_AUTH_ID}
+    <PrivyStackComponent
+      appId={process.env.NEXT_PUBLIC_PRIVY_APP_ID}
+      thirdwebClientId={process.env.NEXT_PUBLIC_THIRDWEB_CLIENT_ID}
       loginMethods={['email', 'google']}
       appearance={{ theme: 'light', accentColor: '#2563EB', logo: '/logo.svg' }}
     >
-      <ZeroDevProviderComponent>
-        <ProtectedRoute fallback={<RedirectToLogin />}>
-          <DashboardShell>{children}</DashboardShell>
-        </ProtectedRoute>
-      </ZeroDevProviderComponent>
-    </AuthStackComponent>
+      <PrivyProtectedRoute fallback={<RedirectToLogin />}>
+        <DashboardShell>{children}</DashboardShell>
+      </PrivyProtectedRoute>
+    </PrivyStackComponent>
   );
 }