dvijaykrishnan's picture
feat: Add sample data support for vault and trending services (Story 9.1) and introduce cloud extraction implementation guide.
6c576f2
|
Raw
History Blame Contribute Delete
2.95 kB
metadata
title: Vault Video Processor
emoji: πŸ“Ή
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
app_port: 7860

Vault

Vault is an AI-powered platform that transforms YouTube video archives into shoppable experiences. Creators can monetize their existing content by automatically detecting products featured in videos and matching them to marketplace listings.

Project Overview

Tech Stack:

  • Framework: Next.js 15 (App Router) with TypeScript
  • Styling: Tailwind CSS v4 with dark theme
  • Database: Supabase Postgres with Drizzle ORM
  • Authentication: Better Auth with YouTube OAuth
  • Background Jobs: Inngest for AI discovery pipeline
  • Deployment: Vercel (Frontend) + Railway (Workers)

Troubleshooting

For detailed information about cloud deployment issues and solutions, see the Troubleshooting Guide. For a comprehensive architectural overview of our cloud extraction strategy, see the Cloud Extraction Guide.

Getting Started

Prerequisites

  • Node.js 20+ installed
  • npm or yarn package manager

Installation

  1. Clone the repository

  2. Install dependencies:

    npm install
    
  3. Copy environment variables:

    cp .env.example .env.local
    
  4. Run the development server:

    npm run dev
    
  5. Open http://localhost:3000 to see the application.

Available Scripts

  • npm run dev - Start development server with Turbopack
  • npm run build - Build production application
  • npm run start - Start production server
  • npm run lint - Run ESLint code quality checks

Project Structure

vault/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/              # Next.js 15 App Router pages
β”‚   β”œβ”€β”€ components/       # Shared UI components
β”‚   β”œβ”€β”€ features/         # Feature-based modules
β”‚   β”‚   β”œβ”€β”€ auth/         # Authentication
β”‚   β”‚   β”œβ”€β”€ discovery/    # AI scanning
β”‚   β”‚   β”œβ”€β”€ marketplace/  # Marketplace sync
β”‚   β”‚   β”œβ”€β”€ vault/        # Viewer experience
β”‚   β”‚   └── dashboard/    # Creator dashboard
β”‚   β”œβ”€β”€ lib/              # Utilities and configs
β”‚   └── types/            # TypeScript types
β”œβ”€β”€ public/               # Static assets
└── [config files]

Architecture

This project follows a feature-based architecture with:

  • Mobile-first design (375px, 768px, 1200px breakpoints)
  • Dark theme (#0A0B14 backgrounds, #4169FF primary actions)
  • Server-side rendering for SEO optimization
  • Inngest workflows for long-running AI tasks

Learn More

License

Private - All Rights Reserved