feat(onboarding): add onboarding wizard flow

- Add `onboardingCompletedAt` field to User model + migration
- Add AUDIO/R2_AUDIO enum values to schema
- Gate dashboard behind onboarding check; redirect to /onboarding if not completed
- Add /onboarding page + layout with 5-step wizard (welcome, workspace, project, video info, notifications)
- Add POST /api/onboarding/complete endpoint to mark onboarding done

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

app/(dashboard)/dashboard/page.tsx

@@ -14,6 +14,14 @@ export default async function DashboardPage({
         redirect('/login');
     }
 
+    const userOnboarding = await db.user.findUnique({
+        where: { id: session.user.id },
+        select: { onboardingCompletedAt: true },
+    });
+    if (!userOnboarding?.onboardingCompletedAt) {
+        redirect('/onboarding');
+    }
+
     const resolvedSearchParams = await searchParams;
     const { ws, sort, page: pageParam } = resolvedSearchParams || {};
 

app/api/onboarding/complete/route.ts

@@ -0,0 +1,17 @@
+import { auth } from '@/lib/auth';
+import { db } from '@/lib/db';
+import { apiErrors, successResponse } from '@/lib/api-response';
+
+export async function POST() {
+    const session = await auth();
+    if (!session?.user?.id) {
+        return apiErrors.unauthorized();
+    }
+
+    await db.user.update({
+        where: { id: session.user.id },
+        data: { onboardingCompletedAt: new Date() },
+    });
+
+    return successResponse({ completed: true });
+}

app/onboarding/layout.tsx

@@ -0,0 +1,7 @@
+export default function OnboardingLayout({ children }: { children: React.ReactNode }) {
+    return (
+        <div className="min-h-screen bg-background flex items-center justify-center p-4">
+            {children}
+        </div>
+    );
+}

app/onboarding/page.tsx

@@ -0,0 +1,24 @@
+import { auth } from '@/lib/auth';
+import { db } from '@/lib/db';
+import { redirect } from 'next/navigation';
+import { OnboardingWizard } from './onboarding-wizard';
+
+export default async function OnboardingPage() {
+    const session = await auth();
+    if (!session?.user?.id) {
+        redirect('/login');
+    }
+
+    const user = await db.user.findUnique({
+        where: { id: session.user.id },
+        select: { onboardingCompletedAt: true, name: true, email: true },
+    });
+
+    if (user?.onboardingCompletedAt) {
+        redirect('/dashboard');
+    }
+
+    const userName = user?.name || user?.email?.split('@')[0] || 'there';
+
+    return <OnboardingWizard userName={userName} />;
+}

prisma/migrations/20260227120000_add_onboarding/migration.sql

@@ -0,0 +1 @@
+ALTER TABLE users ADD COLUMN IF NOT EXISTS "onboardingCompletedAt" TIMESTAMP;

prisma/schema.prisma

@@ -21,6 +21,7 @@ model User {
   password      String?   // Hashed password for email/password auth
   createdAt     DateTime  @default(now())
   updatedAt     DateTime  @updatedAt
+  onboardingCompletedAt DateTime?
 
   // Relations
   accounts           Account[]
@@ -70,12 +71,14 @@ enum DownloadEgressSource {
 enum VideoAssetKind {
   IMAGE
   VIDEO
+  AUDIO
 }
 
 enum VideoAssetProvider {
   R2_IMAGE
   YOUTUBE
   BUNNY
+  R2_AUDIO
 }
 
 model DownloadEgressEvent {